Agent Reach nedir? Ajana internet yeteneği vermek, kurulum, çerezler ve veri

Agent Reach'i kurarsın; yapay zekâ ajanın web sayfası, YouTube, GitHub, RSS, X/Twitter, Reddit, Instagram, Facebook, LinkedIn gibi kaynakları okuyabilir hâle gelir. Agent Reach okumayı kendisi yapmaz: gereken araçları (gh, yt-dlp, OpenCLI) kurar, sağlığını denetler (doctor) ve ajanı doğru araca yönlendirir. Dikkat: varsayılan `agent-reach install --env=auto` yalnız denetler, sistemde hiçbir şey kurmaz; kurulum ve skill yazımı ancak `--system` bayrağıyla olur. Giriş isteyen platformlar için çerez ya da açık Chrome oturumu kullanılır ve hesap kısıtlanabilir; belge ikinci hesap öneriyor. Okunan içerik üçüncü taraflara gider (Jina Reader, Exa, Groq). MIT lisanslı.

Ne yapar: Ajanın web, YouTube, GitHub ve sosyal ağları okumasını kurar
Tür: CLI + skill (Python paketi)
Nerede: Claude Code, OpenClaw, OpenCode ve komut çalıştırabilen ajanlar
Gereksinim: Python 3.10+, pipx; kanala göre ek araçlar
Çerez: Giriş isteyen platformlar çerez ya da Chrome oturumu kullanır; hesap kısıtlanabilir
Türkçe: Resmî kaynak yazmıyor
Ücret: Ücretsiz (MIT); kısıtlı ağlarda olası proxy maliyeti

Agent Reach ne işe yarar?

Ajanın "şu videonun altyazısını getir", "şu GitHub deposunu ara", "şu sayfayı oku" gibi işlerde internete ulaşabilmesi için gereken araçları kurar, çalışıp çalışmadığını denetler (agent-reach doctor) ve ajana hangi aracı çağıracağını anlatan bir skill dosyası bırakır. Okumayı kendisi yapmaz; ajan yukarı akış araçlarını (gh, yt-dlp, OpenCLI, twitter-cli ve benzeri) doğrudan çağırır.

Web sayfası ve RSS okutmakNe alırsın: Markdown metniAyrı kurulum gerekir YouTube, GitHub ve web aramasıNe alırsın: Altyazı metni, arama sonuçlarıAyrı kurulum gerekir

Platform	Hesap ya da çerez	Arka uç
Web, RSS, V2EX	Yok	Jina Reader, feedparser, açık API
YouTube, GitHub	Herkese açık için yok	yt-dlp, gh CLI
Web araması	Anahtarsız uç	Exa (mcporter üzerinden)
Twitter/X	auth_token ve ct0 çerezleri	twitter-cli, yedek OpenCLI
Reddit, Facebook, Instagram	Oturum şart; giriş yapılmış Chrome ya da çerez	OpenCLI (rdt-cli yedek)
LinkedIn	Tarayıcıda elle giriş	mcporter ve mcp-server-linkedin, Jina Reader
Xiaohongshu, Bilibili, Xueqiu, podcast	Platforma göre çerez ya da Groq anahtarı	OpenCLI, bili-cli, çerezli API, Groq

README tablosu 15 platform sayıyor, SKILL.md 16 diyor (bir iş ilanı platformu eklenmiş). Kime yarar: ajanıyla internet araştırması yapmak isteyenlere. Bu, kurulumun bilgisayarında dış araçlar çalıştıracağı anlamına gelir; aşağıdaki "Neye erişir?" bölümünü oku.

Agent Reach nasıl kurulur?

Gereken: Python 3.10 ya da üstü ve pipx (önerilen) ya da pip. Komutlar README ve kurulum belgesinden aynen alındı. PyPI'deki "agent-reach" adlı paket bu proje değil; kurulum GitHub zip adresinden yapılır.

1. Kur› pipx install https://github.com/Panniantong/agent-reach/archive/main.zip

2. Denetle (salt okunur, değişiklik yok)› agent-reach install --env=auto

Kurulum belgesi bu komutun varsayılan olarak salt denetim olduğunu yazıyor ("Read-only check (default)"): gh, Node.js, mcporter, Exa ve yt-dlp ayarlarına bakar, sistemi değiştirmez.

Önce önizle› agent-reach install --env=auto --dry-run

Sonra izin ver› agent-reach install --env=auto --system

--system eksik parçaları kurar ve yapılandırır, skill dosyasını ajan klasörüne yazar. Kurulum belgesi yalnız kullanıcı açıkça onayladıktan sonra kullanılmasını söylüyor. Yalnız belirli kanallar için --channels=opencli,xiaohongshu gibi seçenek var.

--system gh CLI ve Node.js eksikse yalnız Linux (apt-get) ve macOS (Homebrew) için kendisi kurar; Windows'ta bunları elle kurman gerekir. Windows için açık konular var (#566, #631, #590, #586).

README'deki yol› npx skills add Panniantong/Agent-Reach@agent-reach

Skill kurulduktan sonra ajan agent-reach komutunun kurulu olup olmadığına bakar, yoksa kurar (README). README ayrıca ajana kurulum belgesinin adresini verip kurdurmayı öneriyor; bu yolda ajanın ne çalıştıracağını önceden gör.

Sanal ortam ve kurulum› py -3 -m venv $env:USERPROFILE\.agent-reach-venv

Sonra sanal ortamı etkinleştirip python -m pip install https://github.com/Panniantong/agent-reach/archive/main.zip ve agent-reach install --env=auto komutlarını çalıştır. Windows'ta python3 Microsoft Store'u açıyorsa py -3 kullan.

Kurulumu doğrulamak için agent-reach doctor kanal durumunu yazar. Giriş isteyen platformlarda doctor bilerek canlı yoklama yapmaz (çerez okumamak için), bu yüzden "active_backend: null" görebilirsin; asıl denemeyi ajanla yapıp sonucu gör.

Agent Reach nasıl kullanılır?

Skill kurulduktan sonra isteğini normal yazarsın; ajan skill'e bakıp uygun aracı seçer.

Sayfa oku"agent-reach ile şu adresteki makaleyi oku ve beş maddede özetle: https://example.com/makale"

YouTube altyazısı"Şu videonun altyazısını al ve ana başlıkları çıkar: https://www.youtube.com/watch?v=VIDEO_KIMLIGI"

GitHub ara"GitHub'da "mcp server" konusunda yıldızı yüksek Python depolarını ara ve ilk beşini listele. Hiçbir depoya yazma işlemi yapma."

Güncelleme var mı bak (yalnız GitHub'a sorar)› agent-reach check-update

Belge giriş isteyen platformlarda çerezli otomatik isteklerin hesabı kısıtlatabileceğini söylüyor ve ikinci hesap kullanmanı, istekler arasında 2-3 saniye beklemeni öneriyor.

Agent Reach hangi ajanlarda çalışır?

Claude CodeVar	Skill, ~/.claude/skills klasörü varsa oraya yazılır (kodda doğrulandı). README "komut çalıştırabilen her ajan" diyor.
OpenClawVar	~/.openclaw/skills; exec izni açık olmalı (README).
OpenCode ve genel ~/.agents/skillsVar	Kodda yazılı; hiçbiri yoksa ~/.agents/skills oluşturulur.
Windows (uçtan uca)Net değil	Belgede test edildiği yazmıyor; açık Windows konuları var.

Agent Reach neye erişir, çerezleri okur mu?

Çerezler (net)

Varsayılan kurulum tarayıcı kimlik bilgilerini okumaz (kodda "install never reads browser credentials"). Çerez yalnız sen isteyince alınır: Cookie-Editor ile elle dışa aktarım ya da agent-reach configure --from-browser chrome --platform <platform> ile yerel tarayıcıdan tek bir platformun çerezi. Üçüncü taraf rdt-cli'nin rdt login komutu belgede tarayıcı çerezini kendisi çıkarır diye geçiyor. OpenCLI yolu çerez dosyası değil, Chrome'a kurduğun eklenti üzerinden açık oturumunu kullanır.

Yazar

~/.agent-reach/config.yaml (çerezler, jetonlar, proxy; Windows dışında dosya izni 0600). --system ile skill klasörü, mcporter'da Exa girdisi, global npm paketleri (mcporter, OpenCLI), pipx araçları ve yt-dlp ayarına bir satır yazar.

Dışarı yazma

SKILL.md paylaşma, yorum ve beğeni gibi yazma işlerini bu skill'in işi saymıyor, ama references/dev.md gh issue create, gh pr create, gh repo create ve fork örnekleri öğretiyor. Belge kendi içinde çelişiyor; gh'ye giriş yapılmışsa ajan bunları çalıştırabilir.

Dışarı giden veri

Telemetri kodu bulunmadı; check-update yalnız api.github.com'a istek atar. Ama içerik üçüncü taraflara gider: okunan web adresi Jina Reader'a, web araması Exa'ya, podcast sesi Groq'a. README çerezlerin yerelde kaldığını, yüklenmediğini söylüyor.

Güvenilmeyen sayfa içeriği ajana talimat gibi görünebilir. uninstall komutu ayarları, çerezleri ve skill dosyalarını siler. Depoda yayımlanmış güvenlik danışma bildirimi yok; açık bir konu (#802) NVIDIA SkillSpector adlı otomatik bir tarayıcının "kritik" raporunu yapıştırıyor, ama yapımcı yanıtı yok ve doğrulanmış bir bulgu değil. Bu "güvenli" demek değildir; kurulum çok sayıda dış komut çalıştırdığı için önce --dry-run ile ne yapacağına bak.

Agent Reach ücretsiz mi?

Evet. MIT lisanslı; README "tamamen ücretsiz" diyor ve olası tek maliyet olarak kısıtlı ağlarda yaklaşık aylık bir dolarlık proxy'yi anıyor. Podcast sesi için belgede ücretsiz denen bir Groq anahtarı gerekiyor; güncel koşulu Groq'un kendi sayfasından kontrol et. README'deki sponsor bağlantıları ücretli üçüncü taraf ürünlerdir ve gerekli değildir. Ajanın kullandığı modelin maliyeti ayrı.

Yapabilirsin

MIT: kullanmak, değiştirmek serbest

Yasak

Platformların kendi kullanım koşulları geçerli: oturumlu otomatik erişim hesabını kısıtlatabilir

Kaynak: README ve kurulum belgesi. Bu bir hukuki görüş değildir.

Sık sorunlar ve çözümleri

Ne oluyor	Ne yapmalı
pip "externally-managed-environment" (PEP 668) hatası	pipx kullan ya da `python3 -m venv ~/.agent-reach-venv` ile sanal ortam kur.
Windows'ta `python3` Microsoft Store'u açıyor	`py -3` ya da gerçek python.exe yolunu kullan.
Kullanıcıların bildirdiği Windows'ta bazı kanallar, LinkedIn ve transcribe.sh çalışmıyor	Açık konular #631, #590, #586, #566; kesin çözüm belgede yok.
doctor giriş isteyen platformlarda "active_backend: null" diyor	Tasarım gereği: doctor çerez okumamak için canlı yoklama yapmaz (konu #566'da eleştiriliyor). İşi gerçekten yaptırıp sonucu doğrula.
Kullanıcıların bildirdiği Güncelleme yapıldı ama sürüm değişmedi	Açık konu #803: main etiketten yaklaşık 99 commit ileride ama sürüm dizesi hâlâ 1.5.0; pip aynı sürümü görünce güncellemiyor.
Hesabın kısıtlandı	Belgenin kendi uyarısı: çerezli otomasyon hesabı kısıtlatabilir. İkinci hesap kullan, istekler arasında bekle.

Agent Reach nasıl kaldırılır?

Önizle: agent-reach uninstall --dry-run neyin silineceğini gösterir.
Kaldır: agent-reach uninstall yapılandırmayı, çerezleri, skill klasörlerini ve mcporter'daki Exa ve Xiaohongshu girdilerini siler. --keep-config yapılandırmayı tutar.
Paketi kaldır: pipx uninstall agent-reach (pipx'in standart komutu; Agent Reach belgesi ayrıca yazmıyor).
Yukarı akış araçları: twitter-cli, rdt-cli gibi ayrı kurulan araçları kendin kaldır; uninstall bunu hatırlatır ama yapmaz.

Çerezlerin platform tarafında geçersiz kalması için o platformda oturumu kapatmak mantıklı; belge bunu yazmıyor, genel bir güvenlik önerisidir.

Sık sorulan sorular

Agent Reach nedir?

Ajanın internet kaynaklarını (web, YouTube, GitHub, RSS, X, Reddit, Instagram, Facebook, LinkedIn ve daha fazlası) okumasını sağlayan MIT lisanslı bir yetenek katmanı: kurulum, sağlık denetimi ve yönlendirme yapar; okumayı yukarı akış araçları yapar.

Kurulum tarayıcı çerezlerimi okur mu?

Varsayılan kurulum okumaz. Çerez yalnız sen isteyince alınır: elle dışa aktarım ya da configure --from-browser ile tek bir platform için. Üçüncü taraf rdt-cli'nin rdt login komutu ise tarayıcı çerezini kendisi çıkarır. OpenCLI yolu açık Chrome oturumunu kullanır.

Ajanım benim adıma paylaşım ya da yorum yapabilir mi?

Skill bunu kendi işi saymıyor, ama GitHub tarafında gh issue, pr ve repo oluşturma örnekleri öğretiyor; gh'ye giriş yapılmışsa ajan bunları çalıştırabilir. Claude Code'un izin istemini açık tut.

PyPI'deki agent-reach paketini kurabilir miyim?

Hayır. Depodaki bir commit PyPI'deki aynı adlı paketin ilgisiz bir proje olduğunu yazıyor; kurulum GitHub zip adresinden yapılır.

Güvenli mi?

Bu bir güvenlik onayı değil. Depoda yayımlanmış bir güvenlik danışma bildirimi yer almıyor. Açık bir konu (#802) otomatik bir tarayıcının kritik raporunu yapıştırıyor; yapımcı yanıtı yok ve doğrulanmış bir bulgu değil. Önce --dry-run ile ne kuracağına bak.

İlgili rehberler

Kaynaklar

Resmî kaynaklarda net olmayanlar: Agent Reach'in Windows'ta uçtan uca çalıştığı · üçüncü taraf araçların (OpenCLI, rdt-cli, twitter-cli, mcporter) ve Exa, Jina, Groq'un kendi gizlilik koşulları · Groq anahtarının ücretsizliği (yalnız Agent Reach belgesinde) · #802'deki tarayıcı bulgularının doğruluğu · Claude Code'un ~/.claude/skills yolunu tanıması (yalnız kodda). Her biri ilgili bölümde yazılı.