Ajanına interneti vermek: Agent Reach'in doğrulanmış kurulumu

Repo açık kaynak ve MIT lisanslı. Doğrudan oraya gitmek istersen aşağıdaki düğme İngilizce dokümanı açıyor.

Aşağıda fazladan olan şey şu: kurulumun sessizce yanlış gittiği üç yer, Windows'ta çalışan komutlar, ve on beş platformun hangilerinin buradan işine yarayacağı. Üçü de dokümanda ya yok ya da yanlış yazılmış.

Agent Reach içerik okumuyor. Yaptığı iş her platform için hangi aracın çalıştığını bilmek, onu kurmak, çalışıp çalışmadığını kontrol etmek ve bozulunca sıradakine geçmek. Okuma işini ajanın kendisi, doğrudan o araçları çağırarak yapıyor — araya giren bir katman yok.

Fark önemli, çünkü aracın değeri burada: bir erişim yolu öldüğünde senin haberin olmuyor. Reponun kendi örneği, Bilibili'nin yt-dlp'yi engellemesi üzerine listenin sıradaki aracına geçilmesi ve kullanıcı tarafında hiçbir şey yapılmaması.

Önerilen yol komut yazmak değil: aşağıdaki satırı olduğu gibi ajanına yapıştırıyorsun, kurulum dokümanını o okuyup adımları kendisi yürütüyor.

Install Agent Reach: https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md

Elle kurmayı tercih ediyorsan iki komut yetiyor. pipx tercih edilen yol, çünkü sistem Python'una kurmaya çalışırsan çoğu makinede PEP 668 duvarına toslarsın — externally-managed-environment hatası aracın değil, işletim sisteminin koruması.

pipx install https://github.com/Panniantong/agent-reach/archive/main.zip
agent-reach install --env=auto

Paket adı agent-reach, PyPI da var — ve tam olarak bu yüzden tehlikeli. O adın altındaki paket başka birine ait, sürümü 0.1.0 ve bu repoyla hiçbir ilgisi yok; kendi sayfasında adres olarak bambaşka bir GitHub hesabı gösteriyor. Bu reponun kendisi 1.5.0 sürümünde ve PyPI'da hiç yayınlanmamış. Yani komut hata vermiyor, bir şey kuruyor, sadece istediğin şeyi kurmuyor.

Aynı desen bu projenin içinde bir kez daha geçiyor: Reddit için önerilen rdt-cli'ın PyPI sürümü de geride, o yüzden doküman onu sabitlenmiş bir commit'ten kurdurtuyor. Bu ekosistemde paket adına güvenmek genel olarak çalışmıyor.

Windows'ta python3 yazdığında Microsoft Store açılıyorsa ya da komut sessizce hiçbir şey yapmıyorsa, Python kurulu değil demek değil bu: Windows'un kendi takma adı devreye giriyor. Doğrusu Python Launcher kullanmak. Bu not dokümanda var ama Çince yazılmış bir kutunun içinde, İngilizce okuyan kimse görmüyor.

py -3 -m venv $env:USERPROFILE\.agent-reach-venv
$env:USERPROFILE\.agent-reach-venv\Scripts\Activate.ps1
python -m pip install https://github.com/Panniantong/agent-reach/archive/main.zip
agent-reach install --env=auto

Listedeki platformların beşi Çin'e özel: XiaoHongShu, Bilibili, V2EX, Xueqiu ve Xiaoyuzhou. Araç bunlar için gerçekten iyi çalışıyor, ama buradan bakınca sayıyı şişirmekten başka işe yaramıyorlar. Geriye kalanlar da eşit değil — bir kısmı kurulur kurulmaz, bir kısmı ancak tarayıcı oturumunu verirsen çalışıyor.

Anonim erişim yolu kapalı olduğu için Reddit'in giriş şartı esnetilemiyor, dokümanda da böyle yazıyor. Meta tarafındaki üçü ise sunucuda değil, yalnızca kendi bilgisayarında çalışıyor — arkada senin açık Chrome oturumunu kullanıyorlar.

Üç yerde doküman kendi kendisiyle çelişiyor. Hiçbiri aracı bozmuyor ama üçü de zaman yakıyor.

Birincisi, web araması için kullanılan mcporter'ın linki platform tablosunda nicepkg hesabını gösteriyor ve o adres 404 veriyor. Aynı dokümanın alt tarafındaki tabloda aynı araç doğru adresle, nicobailon hesabıyla yazılmış. Yani doğrusu dokümanın içinde zaten var, sadece iki farklı yerde iki farklı şey yazıyor.

İkincisi, web aramasının ücretsiz anahtar isteyip istemediği belirsiz. Platform tablosu API anahtarı gerekmediğini söylüyor, hemen altındaki örnek çıktı ise anahtar almak için siteye kaydolmanı söylüyor. Kesin cevabı kendi makinende agent-reach doctor çalıştırınca alırsın; dokümana değil ona bak.

Üçüncüsü dil. İngilizce README temiz, ama ajanın asıl okuyacağı kurulum dosyasının yarısı Çince: kopyalanacak metin, Windows notları, kanal seçim listesi. Ajan için sorun değil, Çince okuyabiliyor. Sorun sen adımları elle takip etmek istediğinde çıkıyor. Skill dosyası da varsayılan olarak Çince kuruluyor; İngilizcesini istiyorsan kurulumdan önce AGENT_REACH_LANG değişkenini en yapman gerekiyor.

Aracın kendisi ücretsiz ve açık kaynak, kurulumda para isteyen bir yer yok. Ama cookie ve tarayıcı oturumu isteyen kanallarda bedel para değil, hesap riski.