Yapay Zeka Ajanınıza API'siz Ücretsiz İnternet Erişimi Nasıl Sağlanır

TL;DR: Agent-Reach, Claude Code, Cursor, Windsurf veya kabuk komutları çalıştırabilen herhangi bir ajanı X, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu, Facebook, Instagram, LinkedIn, RSS, podcast'ler ve genel web aramasına bağlayan tek bir CLI'dır. Ücretli platform API'ları yerine ücretsiz erişim yollarını kullanır, her platformu birincil bir arka uç üzerinden yedeklerle yönlendirir ve isteğe bağlı aylık 1 dolarlık bir proxy dışında hiçbir maliyeti yoktur. 1 Eylül 2026 itibarıyla 77.134 yıldıza sahiptir. Buradaki dezavantaj, ücretsiz erişim yollarının resmi olmayan yollar olmasıdır, bu nedenle bağladığınız herhangi bir hesabın hükümlerini okuyun.

Bu, 2026'da kurmaya değer beş açık kaynaklı yapay zeka aracı derlememizdeki bir araca derinlemesine bir bakıştır.

Ajanınız bir hizmet yazabilir, bir modülü yeniden düzenleyebilir ve bir yığın izini açıklayabilir. Ona geçen hafta bir kütüphane sürümü hakkında insanların ne düşündüğünü sorun, takılır. Ona YouTube'daki 40 dakikalık bir konferans konuşmasını özetlemesini isteyin, transkripti alamaz.

Ajanınızın en çok ihtiyaç duyduğu bilgiler, ya erişim için ücret alan ya da erişimi engelleyen platformlardadır. Agent-Reach, bunun etrafından dolanan tek bir CLI'dır ve tasarım kararları, özellik listesinden daha ilginçtir.

düğme

Çözdüğü sorun

Depo, ekonomiyi açıkça belirtiyor ve bunlar, bunu inşa etmeye çalışan herkesin karşılaştığı şeylerle eşleşiyor:

Bunların her birinin bir çözümü var. Her çözüm farklı bir araç, farklı bağımlılıklar ve kendi yapılandırma hata ayıklamasına ihtiyaç duyar. Beş platformu bağladığınızda, hepsi birbirinden bağımsız olarak bozulan beş küçük entegrasyon projeniz olur.

Agent-Reach'in önermesi, bunun tek bir kurulum olması ve sonra görünmez olması gerektiğidir.

Neleri kapsar ve her biri ne kadar kurulum gerektirir

Platform listesi, başlıktan daha uzun ve kurulum çabası oldukça değişiyor. Ne kadar iş yapmanız gerektiğine göre sıralanmıştır:

Sıfır yapılandırma, kurulumdan hemen sonra çalışır:

• Web sayfaları. Jina Reader aracılığıyla temiz markdown'a herhangi bir URL.
• GitHub. gh CLI aracılığıyla okuma ve arama. Genel depolar hemen çalışır; gh auth login forkları, sorunları ve PR'ları açar.
• YouTube. 1800'den fazla video sitesini kapsayan yt-dlp aracılığıyla altyazılar ve arama.
• Bilibili. Bili-cli aracılığıyla arama ve video detayı, giriş gerekmez.
• RSS ve Atom. Feedparser aracılığıyla herhangi bir besleme.
• V2EX. Herkese açık bir JSON API üzerinden popüler konular, düğüm konuları, yanıtlı konular, kullanıcı profilleri.
• Web araması. Kurulum sırasında Exa aracılığıyla otomatik yapılandırılır. API anahtarı yok.

Bir tarayıcı çerezi veya mevcut bir Chrome oturumu gerektirir:

• Twitter/X. Bir çerez, aramayı, zaman akışını, tweet okumayı ve makaleleri açar.
• Reddit. Anonim uç noktalar engellendiği için sıfır yapılandırma yolu mevcut değildir. Masaüstü, mevcut bir tarayıcı oturumunu veya rdt-cli ile bir çerezi kullanır.
• XiaoHongShu. Okuma, arama, yorumlar.
• Facebook ve Instagram. Arama, profiller, akış, son gönderiler. Sadece masaüstü, oturum açmış Chrome oturumunuzu yeniden kullanır.
• Xueqiu. Hisse senedi fiyatları, arama, popüler gönderiler.

Ücretsiz bir API anahtarı gerektirir:

• Xiaoyuzhou podcast'leri. Groq Whisper aracılığıyla sesten tam transkripte.

Bu listenin dürüst okuması: sıfır yapılandırmalı yarısı gerçekten ücretsiz ve düşük riskli. Çerezli yarısı ise yavaşlayıp düşünmeniz gereken yerdir ve buna geri döneceğiz.

Kurulum

Kurulum yolu alışılmadık ve proje hakkında bir şeyler anlatıyor. Bir komut çalıştırmıyorsunuz. Belgeleme URL'sini ajanıza yapıştırıyorsunuz ve işi onun yapmasına izin veriyorsunuz:

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

Ajan talimatları alır, Python paketini kurar, ortamı kontrol eder ve neyin hazır olduğunu rapor eder. Güncelleme, update.md ile aynı deseni kullanır.

Varsayılan, salt okunurdur. agent-reach install, sistem paketleri kurmadan veya yapılandırma yazmadan makineyi denetler. Sistem düzeyindeki değişiklikler açık bir bayrak gerektirir:

# ajana bir URL vermek yerine manuel yol
pip install https://github.com/Panniantong/agent-reach/archive/main.zip
agent-reach install --env=auto

# sistem değişikliklerini onaylamaya karar verdikten sonra
agent-reach install --system

Yetenekleri destekleyen ajanlar için bir yetenek kurulumu da vardır:

npx skills add Panniantong/Agent-Reach@agent-reach

Ve ihtiyacınız olmadan önce bilmeye değer bir teşhis:

agent-reach doctor

Bu, neyin çalıştığını, neyin çalışmadığını ve her birinin nasıl düzeltileceğini yazdırır. Tüm işi kırılgan üçüncü taraf erişimi olan bir araç için, sağlık kontrolünü birinci sınıf bir komut olarak göndermek doğru içgüdüdür.

Platforma özgü bir tuzak: OpenClaw kullanıcılarının önce `exec` iznini etkinleştirmeleri gerekir, çünkü Agent-Reach, ajanın kabuk komutları çalıştırmasıyla çalışır. Varsayılan mesajlaşma profiliyle ajan hiçbir şeyi sessizce çalıştıramaz. `tools.profile` öğesini `coding` olarak ayarlayın, ağ geçidini yeniden başlatın ve yeni bir konuşma başlatın. Claude Code, Cursor ve Windsurf etkilenmez.

Kurulmasını değerli kılan tasarım kararı

Herkes bir kazıyıcı (scraper) sarabilir. Bu projenin dikkat çekmeye değer olmasının nedeni, geri dönüş zinciridir.

Her platform, birincil bir arka uç ve sıralı alternatifler listesi üzerinden yönlendirilir. Bir erişim yolu öldüğünde, proje varsayılanı değiştirir ve bir güncelleme gönderir, siz de hiçbir şey yapmazsınız. Kendi örnekleri: Haziran 2026'da Bilibili, yt-dlp'ye 412 hataları döndürmeye başladı, bu yüzden varsayılan bili-cli'ye geçti ve kullanıcılar hiçbir şey fark etmedi.

Bu sorun için doğru mimari budur ve kontrol edemediğiniz herhangi bir bağımlılık için kullanmanız gereken mimari de budur. Önlediği hata modu, bunun ev yapımı sürümlerini öldüren şeydir: kazıyıcınız dört ay çalışır, bir Salı günü bozulur ve ajanın getirme işleminin başarısız olduğunu değil de, bir konu hakkında tartışma olmadığını güvenle bildirmesiyle öğrenirsiniz.

Genelleştirilmesi gereken kısım budur. "Sonuç yok" ile "istek başarısız oldu" ayrımını yapamayan bir ajan, her iki durumda da kendinden emin yanlış beyanlarda bulunacaktır. Bu ayrım, yapay zeka ajanları için API hata mesajları tasarlamanın tüm konusudur ve bunun etrafındaki kurtarma desenleri yapay zeka ajanı hata kurtarma makalesinde yer almaktadır. Agent-Reach, bu on beş platform için bunu ele alır. Yığınınızdaki diğer her entegrasyon sizin sorununuzdur.

Ücretsiz erişim modelinin rahatsız edici hale geldiği yer

Bu bölüm, yıldız sayısının ötesini okumanız için bir nedendir.

Sıfır yapılandırmalı platformlar iyidir. Herkese açık JSON API'ler, resmi GitHub CLI, RSS ve trafiğinizi isteyen bir arama sağlayıcısı. Düşünecek hiçbir şey yok.

Çerez tabanlı platformlar farklı bir sorudur. Kendi oturum açmış oturumunuz aracılığıyla X, Reddit, Instagram veya XiaoHongShu'yu okumak yetkili bir API yolu değildir. Çalışır ve proje bunu sorumlu bir şekilde ele alır, çerezleri yerel tutar, asla yüklemez ve bu iddiayı denetleyebilmeniz için açık kaynaklı kalır. Yapamayacağı şey, bu hesaplarda kabul ettiğiniz hizmet şartlarını değiştirmektir.

Pratik rehberlik:

• Kendi hesaplarınızdaki kişisel araştırma, bunun uyduğu kullanım durumudur ve çoğu insanın bunu kurmasının nedenidir.
• Ticari olan her şey, önce ilgili koşulları okumayı ve muhtemelen ana hesabınız yerine ayrı bir hesap kullanmayı hak eder.
• Hacimli otomatik olan her şey, hesabınızın sınırlanacağı yerdir ve hiçbir geri dönüş zinciri bunu engellemez.
• Bunu bir üretim sistemine yönlendirmeyin ve sonuçları güvenilir bir veri akışı olarak ele almayın. Ücretsiz resmi olmayan erişim bir araştırma aracıdır, altyapı değildir.

Proje, tüm bunları açıkça belirtiyor, buna bir sunucu proxy'sinin ihtiyacınız olursa aylık yaklaşık 1 dolara mal olduğu ve yerel makinelerin buna ihtiyacı olmadığı da dahil. Bu dürüstlük, onu kısa listeye ait kılan şeydir. Ne çalıştırdığınızı bilerek girin.

Agent-Reach'in size sağlamadığı şeyler

Ajanınız artık interneti okuyabilir. Hala API'nızı okuyamıyor.

Bu, ilk bakışta göründüğünden daha keskin bir ayrımdır. Herkese açık web'i okumak bir araştırma problemidir: metin getirme, özetleme, alıntı yapma. Kendi hizmetlerinizi çağırmak bir sözleşme problemidir ve web erişimi ne kadar çok olursa olsun yardımcı olmaz. Ajanınız hala, yinelenen bir idempotency anahtarında faturalandırma uç noktanızın farklı bir hata zarfıyla 409 döndürdüğünü veya imleç sayfasının bir ofset yerine opak olduğunu bilmiyor, çünkü bu bilgiler internette yok. Bu sizin spesifikasyonunuzdadır veya hiçbir yerde yoktur.

Bu yüzden ajan her zaman yaptığını yapar: makul bir şekil çıkarır ve buna karşı kod yazar. Araştırma daha iyi hale geldi ama entegrasyon gelişmedi.

Apidog'un böyle bir araca göre konumu şöyledir:

• OpenAPI belirtimi, ajanın API'larınız için okuduğu şeydir, aynı Agent-Reach'in herkese açık web için okuduğu gibi. Gerçek şemalar, gerçek durum kodları, gerçek hata zarfları. Gerekçe, OpenAPI belirtiminizi ajan araçları olarak kullanma makalesinde yer almaktadır.
• Mocks (sahte veriler) belirtimden gelir, hata dalları da dahil olmak üzere, böylece ajan kendi varsayımı yerine sözleşmenize göre test eder.
• Sözleşme testleri CI'da başarısız olur, şekil değiştiğinde. Bu, Agent-Reach'in kazıma için modellediği ve neredeyse hiç kimsenin kendi API'ları için modellemediği bir hata modudur. API değişiklikleri yapay zeka ajanlarını bozduğunda ne olduğunu görün.

Herkese açık web yerine kendi deponuzla ilgili yapısal sorular için eşdeğer araç, arama yerine bir dizinden yanıt veren codebase-memory-mcp'dir. Ajanınız araştırma yapabilsin diye Agent-Reach'i kurun. Çağırması gereken sözleşmeleri tahmin etmeyi bıraksın diye Apidog'u indirin. Aynı boşluğun zıt yarısını kapsıyorlar.

Araştırma uzun bir görevdir ve uzun görevlerin kayda ihtiyacı vardır

İkinci haftada ortaya çıkan bir iş akışı problemi var.

Araştırma çalışmaları uzundur. İki saat boyunca X, Reddit, Hacker News ve GitHub'ı arayan bir ajan değerli bir şeyler üretir: kaynaklar, alıntılar, tarihler, bağlantılar, bir sentez. Sonra oturum biter ve hepsi bir dizüstü bilgisayardaki terminal kaydırmasında kalır. Bir meslektaş, bir iddiaya nereden gelindiğini sorar ve yanıt mevcut değildir. Daha da kötüsü, kimsenin varlığını bilmediği için bir dahaki ay aynı araştırma tekrar yapılır.

İstemler bir kayıt değildir. Tam da bu boşluğu Sharkly kapatıyor ve araştırma işi, değerini görmenin en kolay olduğu yerdir.

• Kayıt istem değil, görevdir. İlerleme, araç çağrıları ve sonuçlar göreve geri akış yapar ve ajanın çıktısı, yanıt verebileceğiniz yorumlar olarak saklanır. Kaynaklar, bir insan onları bir sonraki çeyrekte okuyabileceği bir yere iner.
• Bir Ajan, kaydedilmiş bir yapılandırmadır. Talimatlar, çalışma zamanı, yetenekler, depolar, ortam. Bir kez ayarladığınız bir araştırma kurulumu, dokunmasına izin verilen platformlar da dahil olmak üzere, yeniden yazılmak yerine yeniden kullanılır.
• Bir Ekip, bir lider ajan artı diğer ajanlar ve insanlar demektir, lider öncelikli olarak çalışır. Lider görevi okur, bir araştırmacı ve bir yazar alır ve sonuçlarını tek bir yerde birleştirir, üç ajanın aynı anda başlayıp aramaları çoğaltması yerine.
• Gecikme, gecikme demektir. Orada duran bir görev bir çalışma başlatmaz, böylece API çağrılarını ve oran sınırlamalarını yazdığınız anda yakmadan araştırma konularını sıraya koyabilirsiniz.
• Yürütme kendi başına yapılır. Bilgisayarınızı, bir sunucuyu veya bir kapsayıcıyı bağlarsınız ve Sharkly, üzerinde zaten kurulu olan Çalışma Zamanı'nı kullanır. Bu, özellikle burada önemlidir: çerez tabanlı erişim, bir tarayıcı oturumuna sahip bir makineye bağlıdır, bu nedenle bu oturumları gerçekten tutan Bilgisayar üzerinde araştırma yapmak istediğiniz kurulumdur.

Bu son nokta pratik olanıdır. Agent-Reach'in sadece masaüstü platformları, gerçek bir oturum açmış tarayıcıya ihtiyaç duyar. Araştırmanın hangi makinede çalışacağına karar vermek gerçek bir operasyonel seçimdir ve bunun "hangi dizüstü bilgisayar açıksa" yerine açıkça bağlı bir Bilgisayar olması, kurulum çabasına değer.

Ayakta kalan bir araştırma iş akışı

Kurulum yirmi dakika sürer. Değer elde etmek ise bir alışkanlıktır. Çalışan desen:

Sıfır yapılandırmalı platformlarla ve dar bir soruyla başlayın. Geniş istemler geniş özetler üretir. Yanlışlanabilir bir şey sorun:

Ekiplerin yeni API sürümüyle oran sınırlarını nasıl ele aldıklarını
öğrenmek için GitHub ve YouTube'u arayın. Bir özet değil, bağlantılı
beş spesifik yaklaşım istiyorum. Her kaynağın tarihini belirtin.

Ajanın, herhangi bir kurulum gerektirmeyen `gh search repos`, `gh search code` ve yt-dlp transkriptleri mevcuttur, bu nedenle bu, yeni bir kurulumda çalışır. Bağlantılar ve tarihler istemek, çıktının güven veren bir özet haline gelmesini engeller.

Her seferinde bir çerez platformu ekleyin. Geliştirici konuları için X genellikle en yüksek değerli ektir, çünkü yayın tepkileri ilk olarak orada ve başka hiçbir yerde yer almaz. Kimlik doğrulama belirtecini ayarlayın, `agent-reach doctor` komutunu çalıştırın, sağlıklı olduğunu onaylayın, sonra kullanın. Bir anda dört platform eklemek, hangisinin bozulduğunu anlayamamanız anlamına gelir.

Toplamayı yargılamadan ayırın. Ajanın kaynakları tek bir geçişte toplamasını ve ikinci bir geçişte değerlendirmesini sağlayın. Aynı anda arama yapan ve sonuç çıkaran tek bir geçiş, ilk otuz saniyede neye karar verdiyse onun için kanıt bulma eğilimindedir. Kaynak listesinin aralarında yazılı olduğu iki geçiş gözle görülür şekilde daha iyidir ve size kontrol edecek bir şeyler verir.

Bağlantıyı açana kadar her bulguyu doğrulanmamış kabul edin. Bu, en önemli disiplindir. Ajan bir kıyaslama sonucu iddia eden bir tweet'i okuyabilir; ancak kıyaslamanın gerçek olup olmadığını size söyleyemez. Bir belgeye, karara veya müşteriyle ilgili bir iddiaya dahil olacak her şey, bir insan tarafından kaynağın açılmasını gerektirir. Kendi hattımızdaki izlenen verilerle de aynı yaklaşımı benimsiyoruz ve bu, kontrol edilmemiş bir sayıyla hiçbir şeyin dışarı çıkmamasının nedenidir.

Araştırmanın ne için olduğunu yazın. İlişkilendirilmemiş bir görevle yapılan bir araştırma, birinin tekrarlayacağı bir araştırmadır. Bu, el değiştirme probleminin küçük bir versiyonudur ve genel şekli ajan el değiştirme ve bağlam aktarımı makalesinde ele alınmıştır.

Sıkça Sorulan Sorular

Agent-Reach gerçekten ücretsiz mi? Araçlar açık kaynaklıdır ve erişim yolları ücret talep etmez. Tek olası maliyet, engellenen bir IP adresine sahip bir makinede çalışıyorsanız aylık yaklaşık 1 dolarlık bir sunucu proxy'sidir. Yerel makinelerin buna ihtiyacı yoktur. Buradaki "ücretsiz", tedarikçi faturası olmaması anlamına gelir, hizmet şartları hususlarından muaf olması değil.

Hangi ajanlarla çalışır? Kabuk komutları çalıştırabilen herhangi bir ajanla. Belgelerde Claude Code, Cursor, Windsurf, OpenClaw ve Codex'in hepsi adı geçiyor. OpenClaw'un önce `exec` izninin etkinleştirilmesi gerekir. Müşteriler arasında seçim yapıyorsanız, Cursor ve Copilot'taki API çalışmalarının karşılaştırmamız ödünleşmeleri kapsar.

Çerezlerim güvende mi? Proje, çerezlerin yerel kaldığını ve asla yüklenmediğini belirtir ve bunu doğrulayabilmeniz için açık kaynaktır. Asıl risk sızdırma değil, hesabınızdır: oturumunuzdan otomatik okuma, bir hesabın platform tarafından oran sınırlamasına tabi tutulmasına veya işaretlenmesine neden olabilir. Kaybetmeyi göze alabileceğiniz bir hesap kullanın.

Platformlar değiştiğinde bozulacak mı? Evet ve bu planlanmıştır. Her platformun birincil bir arka ucu ve yedekleri vardır ve proje bir erişim yolu öldüğünde varsayılanları değiştirir. Bir şeyler yanlış göründüğünde `agent-reach doctor` komutunu çalıştırın; hangi platformun başarısız olduğunu ve nedenini size söyler.

Bu, bir web arama API'sinin yerini alıyor mu? Araştırma genişliği açısından, daha ileri gider, çünkü arama API'leri size tweet dizilerini, Reddit yorumlarını veya video transkriptlerini vermez. Güvenilirlik ve destek açısından, ücretli bir API, ücretli bir API'dir. Farklı garantiler.

Ajanım bunu kendi API'larımı çağırmak için de kullanabilir mi? Hayır ve denemiyor. Agent-Reach herkese açık platformları okur. Kendi hizmetleriniz için ajanın bir spesifikasyona, bir mock'a ve testlere ihtiyacı vardır, ki bu yapay zeka ajanları çağında hala bir API aracına ihtiyacınız var mı makalesindeki argümandır.

Özetle

Agent-Reach gerçek bir sınırı kaldırıyor. Bir kütüphane etrafındaki gerçek tartışmayı okuyabilen, konuşmayı izleyebilen ve sorun takipçisini kontrol edebilen bir ajan, eğitim kesintisine göre çalışan bir ajanndan daha iyi yanıtlar verir ve geri dönüş zinciri tasarımı, kaçınılmaz erişim yolu arızasından sonra bile çalışmaya devam etmesini sağlar.

Önce sıfır yapılandırmalı platformlar için kurun. Özellikle ticari olanlarda çerezleri bağlamadan önce düşünün. Ve neye dokunmadığını açıkça belirtin: kendi API sözleşmeleriniz hala varsayılmak yerine doğru olması için Apidog'a ihtiyaç duyar ve ajanın ürettiği araştırmanın da sizden başka biri görecekse hala Sharkly'ye veya benzeri bir şeye ihtiyacı vardır.

İnternette gözlerinizin olması değerli bir şeydir. Sadece bulguların terminalden daha uzun süre yaşamasını sağlayın.