Agent Reach はエージェントが自分では入れないインターネットを手渡す

検索ツールを持つコーディングエージェントは、ブログ記事を 1 本見つけられます。では Xiaohongshu で某スキンケア製品がどう言われているかを聞くと、失敗するか、答えを捏造します。Bilibili の動画の最初の 4 分で何が語られたかを聞いても、読むべきテキストを持っていません。
Agent Reach はその隙間を中心に作られたプロジェクトです。今週 GitHub の trending で 1 位になり、いま 9,500 スター近くにあります。英語の一行紹介は「give your agent eyes to see the entire internet」。中国語の説明のほうが正確で、エージェントが自力では届かないインターネットの部分に手を伸ばさせる、という意味です。
MIT ライセンスで、Python 3.10 以上が必要で、PyPI には公開されていません。この最後の点は README で太字になっています。`agent-reach` という名前を先に PyPI で登録した人がいるからです。
実際に何を包んでいるのか
このツールの実体はチャネルのルーターです。並んだプラットフォームの裏側にあるスクレイパーと API クライアントを導入して疎通を確認し、それを 1 つのコマンドの形にまとめます。
agent-reach channels
agent-reach bilibili search "大模型"
agent-reach read https://www.v2ex.com/t/123
`read` コマンドは URL を見て、どのチャネルを使うかを自分で判断します。実際に使うと、打鍵量が減るのは主にこの部分です。
一覧には 14 のチャネルがあります。既定で有効になり、アカウントも要らないものが 6 つです。Bilibili(検索、動画メタデータ、急上昇、字幕。字幕にはログインが必要)、V2EX(急上昇、ノード、投稿と返信、ユーザー)、GitHub(リポジトリ検索、リポジトリと README の読み取り、issue と PR とコメント)、YouTube(メタデータ、検索、字幕、Groq か OpenAI のキーがあれば音声の文字起こし)、そして最後の受け皿として汎用のウェブ検索とリーダーがあります。
面白いデータがあるのは任意チャネルの側です。Xiaohongshu はノート、本文、コメント。Xueqiu はリアルタイムの株価と人気投稿。BOSS Zhipin は求人と職務記述。Xiaoyuzhou はポッドキャストの文字起こし。LinkedIn は公開された求人投稿。Reddit は投稿、本文、コメント、subreddit。X、Facebook、Instagram には experimental と書かれています。スクレイピングの世界でこの語は、プラットフォームが何かを変えるまで動くという意味です。
インストールはエージェントへのひとこと
ここに、このプロジェクトが誰に向いているかが出ています。README は pip の一行から始まりません。エージェントに貼り付ける一文から始まります。
帮我安装 Agent Reach:https://raw.githubusercontent.com/Panniantong/Agent-Reach/main/docs/install.md
エージェントはその文書を読み、自分で作業します。`uv` がなければ入れ、次に本体と各チャネルのツールを入れ、最後にどのチャネルが生きていて、どの任意チャネルを追加できるかを報告します。あとから Xiaohongshu を足すのもひとことです。「add Xiaohongshu」。外すのもひとことで、外すときはそのチャネルのログインとツールも一緒に消えます。
すべては `~/.agent-reach/` の下に置かれます。1 つのディレクトリにまとめるのは意図的な設計です。エージェントは中途半端に入った依存を十数か所に散らかし、確実に消す方法は新しいマシンを用意することだけ、という状態になりがちです。フォルダが 1 つなら、アップグレードも点検も削除も 1 コマンドで済みます。2 つ目のエージェントに同じフォルダを向けるだけで、同じ能力を渡せるという意味もあります。
セッションの問題を、正直に書く
人が実際に使いたいプラットフォームの多くはログインの向こう側にあります。Agent Reach の扱いは、要約で済ませず本文を読む価値があります。
あるサイトを初めて使うとき、そのサイトについて Chrome にある既存のセッションを、専用のブラウザへコピーします。そのブラウザはバックグラウンドで動き、ウィンドウは開きません。パスワードマネージャーは読みません。元のブラウザには手を触れません。
不合理な問題に対する、合理的なエンジニアリングの答えです。自動化ブラウザをスクリプトで X や Xiaohongshu にログインさせるのは、凍結への最短ルートなので、セッションの再利用はみんながやっていることです。README はその帰結について率直です。コピーされるのは通常はメインアカウントなので、サブアカウントに差し替えることを勧めています。方法はセキュリティの節に書かれています。
そこから 2 つのことが導かれます。1 つ目、Xiaohongshu のセッションを渡されたエージェントは、チャネルがそれを公開していれば、あなたのノートも保存も DM も読めます。2 つ目、エージェントが何をしても、レート制限の主体はあなたのアカウントになります。200 回の検索を回すループは、あなたのアカウントが 200 回検索するということです。
どちらの問題も、このプロジェクト固有のものではありません。インストールがエージェントへのひとことに過ぎないとき、どちらも見落としやすくなります。README が警告を見逃せない場所に置いているのは、まさにそのためです。
中国のプラットフォームが本命である理由
英語圏の開発者にとって、目玉は Reddit でしょう。このプロジェクトの実際の利用者にとっては、一覧の中国側の半分です。
汎用のウェブ検索は、中国のソーシャルプラットフォームに対して固有の弱点があります。公開されていてリンクできるページだけを索引するので、人が気にするコンテンツの大半は外れます。Xiaohongshu のノートに何が書かれているかも分かりません。あの中身はログインウォールの後ろでクライアント側で描画されるからです。中国の消費者感情を調べろと汎用検索に頼むと、マーケティングのブログ 3 本を要約して、これをトレンドだと報告してきます。
もう半分は Bilibili の字幕です。40 分の中国語の技術講演は、誰かが文字起こししない限りエージェントには見えません。そしてプラットフォーム側はすでに字幕を持っています。それを取り出せば動画はテキストになり、テキストはエージェントが推論できる唯一の形式です。
この数か月、私はこのブログのために中国のプラットフォームで調査を続けてきましたが、標準的なツール群はまさにこの面で落ちます。Weibo は解析しても何も残らない HTML を返し、Zhihu は認証を要求し、Bilibili は自動化らしく見えるものに 412 を返します。動くクライアントをまとめ、チャネルごとに健全性を報告するプロジェクトは、この仕事をしている人には何を解いているかが即座に分かります。
キャッチコピーに書かれないトレードオフ
掲載文には「Zero API fees」とあります。狭い意味では正しく、呼び出しごとにお金は払いません。代わりに別の通貨で払っています。
スクレイピングは、プラットフォームの許容度を引き継ぐという意味です。サイトがマークアップを変えればチャネルは壊れます。README が X、Facebook、Instagram を experimental に分類しているのは、まさにこれらの対 bot 防御が動き続けるからです。スクレイピングしたチャネルの上に組んだ調査パイプラインの可用性は、API よりも個人プロジェクトに近く、そして一番困るタイミングで落ちます。
答えが、スクレイピングする界面のバイアスを帯びるという意味でもあります。Xiaohongshu の検索はランキングが好むものを返します。これは成果を出したものの標本です。意見の分布とは別物です。上位 20 件のノートを読んで要約するエージェントは、ランクに入るノートを書く人たちの合意を報告します。その集団は聞こえより狭いものです。
だからこのツールは原材料の置き場として扱うのが筋です。神託を期待すると外します。そう扱って初めて、あるチャネルがゴミを返し始めたことにも気づけます。
私なら何に使うか
3 つあります。確信のある順に並べます。
カンファレンスの講演や製品デモから字幕を抜くこと。文字起こしは ground truth で、しかもプラットフォームがすでに計算済みです。
すでにリンクを持っている特定のスレッドやノートを読むこと。答えの分かっている検索作業で、標本の問題はありません。
ある主張を 2 つの市場で突き合わせること。あるツールの反応を書くなら、同じ週の Reddit のスレッドと Xiaohongshu のノートを読めば、1 つの分布で終わらず 2 つ手に入ります。たいてい、その差が記事になります。
やらないのは、開かれた問いを投げて要約を信じることです。このチャネル群は取得は得意で、代表性は苦手です。そしてエージェントは、自分がどちらをやったかを教えてくれません。