Agent Reach consegna al tuo agente l'internet in cui non riesce a entrare

Un agente di codice con uno strumento di ricerca trova un post di un blog. Chiedigli cosa dice la gente su Xiaohongshu di un prodotto per la cura della pelle e fallirà oppure inventerà una risposta. Chiedigli cosa si dice nei primi 4 minuti di un video Bilibili e non ha nulla da leggere.
Agent Reach è costruito intorno a quel vuoto. Il progetto questa settimana è arrivato in cima alla classifica trending di GitHub e sfiora le 9.500 stelle. La formula inglese è "give your agent eyes to see the entire internet". La versione cinese è più precisa: far arrivare l'agente alle parti di internet in cui non riesce a entrare da solo.
Licenza MIT, richiede Python 3.10 o superiore e non è su PyPI. Quest'ultimo punto è in grassetto nel README perché qualcun altro ha registrato il nome `agent-reach` su PyPI.
Cosa avvolge davvero
Lo strumento è un router di canali. Installa e verifica gli scraper e i client API dietro un elenco di piattaforme, poi li espone sotto un'unica forma di comando:
agent-reach channels
agent-reach bilibili search "大模型"
agent-reach read https://www.v2ex.com/t/123
Il comando `read` guarda l'URL e sceglie il canale da solo. In pratica è la parte che fa risparmiare più digitazione.
I canali elencati sono 14. 6 sono attivi per impostazione predefinita e non richiedono account: Bilibili (ricerca, metadati dei video, tendenze, sottotitoli con login per i sottotitoli), V2EX (tendenze, nodi, post e risposte, utenti), GitHub (ricerca di repository, lettura di repository e README, issue e PR con commenti), YouTube (metadati, ricerca, sottotitoli e trascrizione audio con una chiave Groq o OpenAI), più una ricerca web generica e un lettore come fallback.
I canali opzionali sono dove vivono i dati interessanti: Xiaohongshu per note, testo e commenti; Xueqiu per quotazioni in tempo reale e post popolari; BOSS Zhipin per annunci di lavoro e descrizioni; Xiaoyuzhou per la trascrizione dei podcast; LinkedIn per annunci pubblici; Reddit per post, testi, commenti e subreddit. X, Facebook e Instagram sono marcati come sperimentali, che nello scraping significa che funzionano finché la piattaforma non cambia qualcosa.
L'installazione è un messaggio per l'agente
Questo è il punto che dice a chi è rivolto il progetto. Il README non parte da una riga pip. Parte da una frase da incollare nel proprio agente:
帮我安装 Agent Reach:https://raw.githubusercontent.com/Panniantong/Agent-Reach/main/docs/install.md
L'agente legge quel documento e fa il lavoro: installa `uv` se manca, poi il programma e gli strumenti dei canali, infine riporta quali canali sono attivi e quali opzionali si possono aggiungere. Aggiungere Xiaohongshu più tardi è una frase: "add Xiaohongshu". Toglierlo è un'altra frase, e la rimozione cancella anche il login e gli strumenti di quel canale.
Tutto vive sotto `~/.agent-reach/`. Quella singola directory è una scelta di progetto deliberata. Gli agenti accumulano dipendenze installate a metà in una dozzina di posizioni, e l'unica disinstallazione affidabile resta una macchina nuova. Una sola cartella significa che aggiornare, ispezionare e rimuovere sono un comando ciascuno, e che un secondo agente ottiene le stesse capacità se lo si punta alla stessa cartella.
Il problema delle sessioni, detto chiaramente
Quasi tutte le piattaforme che la gente vuole davvero usare stanno dietro un login. Agent Reach le gestisce in un modo che merita una lettura attenta, non un riassunto.
La prima volta che usi un sito, copia la tua sessione Chrome esistente per quel sito in un browser dedicato, che gira in background senza aprire finestre. Non legge il tuo gestore di password. Il browser originale resta intatto.
È una risposta ingegneristica ragionevole a un problema irragionevole. Far accedere via script un browser automatizzato a X o a Xiaohongshu è la via rapida al ban, quindi il riuso delle sessioni è ciò che fanno tutti. Il README è schietto sulla conseguenza: quello che viene copiato di solito è il tuo account principale, e consiglia di sostituirlo con uno secondario. C'è una sezione di sicurezza che spiega come.
Ne seguono due cose. Primo, un agente con la tua sessione Xiaohongshu può leggere le tue note, i tuoi salvataggi e i tuoi messaggi privati se il canale li espone. Secondo, il tuo account diventa l'identità soggetta ai limiti di frequenza per tutto ciò che fa l'agente, il che significa che un ciclo da 200 ricerche sono 200 ricerche del tuo account.
Nessuno dei due problemi è esclusivo di questo progetto. Entrambi diventano più facili da ignorare quando l'installazione è una singola frase rivolta a un agente, ed è esattamente per questo che il README mette l'avviso dove non puoi mancarlo.
Perché le piattaforme cinesi sono il vero bersaglio
Per uno sviluppatore di lingua inglese la funzione di punta è Reddit. Per il pubblico reale del progetto è la metà cinese dell'elenco.
La ricerca web generica è scarsa sulle piattaforme social cinesi in un modo specifico. Indicizza le pagine pubbliche e collegabili, il che esclude la maggior parte dei contenuti che interessano, e non sa cosa dice una nota su Xiaohongshu perché quei contenuti vengono renderizzati lato client dietro un muro di login. Un agente a cui chiedi di studiare il sentiment dei consumatori cinesi con la ricerca generica produrrà un riassunto di 3 blog di marketing e lo chiamerà tendenza.
I sottotitoli di Bilibili sono l'altra metà. Un intervento tecnico di 40 minuti in cinese è invisibile a un agente se nessuno lo trascrive, e la piattaforma ha già la trascrizione. Arrivarci trasforma un video in testo, l'unica forma su cui un agente può ragionare.
Da mesi faccio ricerca sulle piattaforme cinesi per questo blog, e la toolchain standard fallisce proprio su queste superfici: Weibo restituisce HTML che non si parsifica in nulla, Zhihu chiede autenticazione, Bilibili risponde 412 a qualsiasi cosa sembri automatizzata. Un progetto che impacchetta client funzionanti per loro, con un report di salute per canale, risolve un problema che chi fa questo lavoro riconosce subito.
Il compromesso che nessuno mette nello slogan
"Zero API fees" è la frase nella scheda, ed è corretta in senso stretto: non paghi a chiamata. Paghi in un'altra valuta.
Fare scraping significa ereditare la tolleranza della piattaforma. I canali si rompono quando un sito cambia il markup, e il README classifica X, Facebook e Instagram come sperimentali proprio perché le loro difese anti-bot si muovono. Una pipeline di ricerca costruita su un canale scrapato ha un profilo di disponibilità più vicino a un progetto amatoriale che a un'API, e cade nel momento in cui la vorresti meno.
Significa anche che le risposte portano i pregiudizi della superficie scrapata. La ricerca Xiaohongshu restituisce ciò che il ranking favorisce, un campione di ciò che ha reso, non un campione di opinioni. Un agente che legge le prime 20 note e le riassume riporterà il consenso di chi scrive note che posizionano, un gruppo più stretto di quanto suoni.
Questo spinge a trattare lo strumento come fonte di materia prima. Un oracolo è un'altra cosa. È anche l'unico modo per accorgersi che un canale ha iniziato a restituire spazzatura.
Per cosa lo userei
Tre lavori, in ordine decrescente di fiducia.
Estrarre sottotitoli da talk a conferenze e demo di prodotto, perché la trascrizione è ground truth e la piattaforma l'ha già calcolata.
Leggere uno specifico thread o una nota di cui hai già il link, un compito di recupero con risposta nota e senza problema di campionamento.
Incrociare un'affermazione su due mercati. Se scrivi della ricezione di uno strumento, leggere il thread Reddit e le note Xiaohongshu della stessa settimana ti dà due distribuzioni, e le differenze di solito sono la storia.
Quello che non farei è puntarlo su una domanda aperta e fidarmi del riassunto. I canali sono bravi a recuperare e scarsi a rappresentare, e un agente non ti dirà quale delle due cose ha appena fatto.
Articoli correlati
Il consiglio si è costruito un comitato sull'export
In nove giorni il consiglio di Nvidia ha prodotto un'indagine, una presidenza e un comitato sull'export. Solo la trimestrale è finita in prima pagina.
Nvidia non ha mai costruito una seconda fila
Il problema di Nvidia non è lo scandalo, è la struttura: nessun presidente del consiglio fino alla settimana scorsa, nessun vice con mandato aziendale, nessuna successione.
Nvidia ha messo un prezzo al suo fondatore
In nove giorni Nvidia ha cambiato CEO e consiglio senza perdere un trimestre. Il mercato, intanto, ha dato un prezzo a quello che valeva un solo uomo.
Un foglio di calcolo comunitario di tocchi che spegne la pubblicità negli Android cinesi
Non tocca il sistema, non sblocca niente, non flasha niente. Ribalta solo gli interruttori che i produttori hanno già previsto. Il prezzo è una lista che qualcuno deve continuare a scrivere.