著者注：Agentに一言話しかけるところから始めて、Agent-Reachを手取り足取り導入します。Claude CodeやCodexなどのAgentが小红书のノート、Xの投稿、Bilibiliの字幕を読めるようにし、チャネル表、コマンド対応表、トラブルシューティング、コスト見積もりも付けます。
Agentに競合調査をさせると、すぐに壁にぶつかります。「小红书でこのイヤホンの評判を見てきて」と頼んでも、標準のウェブ検索は数本の転載記事しか返してくれず、小红书のノートそのものはまったく検索できません。「あるXアカウントが今週何を投稿したか要約して」と頼んでも、ログインの壁の向こうにあるタイムラインを開けません。
動画コンテンツならさらに深刻です。40分のBilibili技術共有では、本当に価値のある情報はすべてナレーションの中にあります。一般的な検索ではBilibiliの字幕を取得できず、Agentはタイトルと概要だけを見て推測するしかありません。雪球やV2EXといった中国語プラットフォームも、一般検索でのカバレッジは非常に悪く、返ってくるウェブページには大量のナビゲーションや広告が混ざっています。
まさにこの問題を解決するのが、オープンソースプロジェクト Agent-Reach です。GitHubではすでに10万Starを超えており、その位置づけは「AI Agentが自分では手の届かないインターネットにアクセスできるようにする」ことです。これはコマンドラインと格闘する必要がある、また別のツールではありません。本チュートリアルの主軸は、Agentに一言伝えるだけでインストールを完了すること。その後のチャネル追加、アカウント切り替え、アップグレードも、すべてわかりやすい言葉で済ませます。
核心価値：この記事を読み終えると、自分のAgentがX、Reddit、Bilibili、小红书などのプラットフォームの内容を読めるようになり、各ステップの確認方法、エラー時のトラブルシューティング、1回の調査にかかる費用の目安もわかります。
Agent-Reach チュートリアルの核心ポイント
実際に手を動かす前に、まずは表で Agent-Reach の重要なポイントを整理しておきましょう。以下の情報は、2026年10月26日にプロジェクトリポジトリを確認した時点のものです。
| ポイント | 説明 | あなたにとっての価値 |
|---|---|---|
| プロジェクトの注目度 | Star 数は10万を超え、Trendshift GitHub Trending で当日1位を獲得したことも | コミュニティが活発で、疑問にも対応してもらいやすい |
| ライセンスと動作環境 | MIT オープンソース、Python 3.10+ で開発 | 無料で利用でき、コードを自分で確認することも可能 |
| プラットフォーム費用 | 本体は無料で、プラットフォームの API 料金は一切不要 | 実質的なコストは Agent のモデル token だけ |
| 動作の仕組み | 読み取り専用：検索と読み取りのみ。投稿・コメント・いいね・DM は行わない | プラットフォーム上で勝手に「発言」されることはない |
| 出力フォーマット | 1.6 以降はコマンドごとに1つの JSON オブジェクトを出力 | Agent は ok / result / error.hint を読むだけで成否を判断できる |
Agent-Reach が解決する4つの「届かない」領域
Claude Code、Codex、Hermes Agent、OpenClaw といった CLI Agent には、検索や Web ページの読み取り機能が標準で備わっています。しかし、4種類のコンテンツには本質的に手が届きません。1つ目はログインが必要な機能です。たとえば小紅書（RED）でノートを検索したり、X でアカウントの動きを確認したり、求人詳細を読んだりするケースが該当します。2つ目は動画の中身で、B站（ビリビリ）や YouTube の字幕、YouTube 動画や小宇宙ポッドキャストの音声文字起こしなどが含まれます。
3つ目は中国語プラットフォームです。B站、小紅書、V2EX、雪球は汎用検索でのカバー率が低いのが現状です。4つ目はクリーンな構造化データで、雪球の相場情報、V2EX の投稿と返信、GitHub のリポジトリや issue などが該当します。Agent-Reach が返してくれるのは整理された内容であり、HTML ページをそのまま渡すわけではないため、Agent が消費する token を直接減らせます。
Agent-Reach の設計思想：第一候補＋代替候補
Agent-Reach は、各プラットフォームの各操作を「順番に試すツールのリスト」として設計しています。たとえば B站の動画を読むときは、まず bili-cli を使い、失敗したら自動的に B站の公開 API に切り替えます。Web ページを読むときは、まず Jina Reader、次に Exa を使います。プラットフォームの改修やツールの失効は日常茶飯事ですが、メンテナンス側はこのリストを調整するだけで済み、あなたと Agent の使い方はまったく変わりません。
Agent-Reach が対応しているチャネル
現在のバージョンでは、チャネルを3つのレベルに分けています。デフォルトチャネルはインストールすればそのまま使えます。オプションチャネルは、Agent に「XX を追加して」と一言伝えるだけで有効になり、必要なソフトウェアも自動でインストールされます。実験チャネルは使えますが、プラットフォーム側のスクレイピング対策がより厳しく、いつ使えなくなってもおかしくありません。以下のお表は保存しておくのがおすすめです。「何ができるか」と「何が必要か」という、最もよくある2つの疑問に答えてくれます。
| チャネル | レベル | できること | 必要なもの |
|---|---|---|---|
| bilibili | デフォルト | 検索、動画情報、人気動画、字幕 | 字幕には QR コードログインが必要 |
| v2ex | デフォルト | 人気スレッド、ノード、投稿と返信、ユーザー | ログイン不要 |
| github | デフォルト | リポジトリ検索、リポジトリと README の閲覧、issue と PR の閲覧（コメント含む） | ログイン不要 |
| youtube | デフォルト | 動画情報、検索、字幕、音声の文字起こし | 文字起こしには Groq または OpenAI のキーが必要 |
| web | デフォルト | Web 検索、Web ページの閲覧（フォールバックチャネル） | ログイン不要 |
| xiaohongshu | オプション | ノート検索、本文の閲覧、コメントの閲覧 | ログインが必要 |
| xueqiu | オプション | リアルタイム相場、銘柄検索、人気スレッド、人気銘柄 | 相場はログイン不要、人気スレッドと人気銘柄はログインが必要 |
| boss | オプション | 求人と JD の検索 | ログインが必要 |
| xiaoyuzhou | オプション | ポッドキャストの文字起こし | Groq のキーが必要 |
| オプション | 求人検索、求人詳細の閲覧 | 公開求人はログイン不要、サイト内検索はログインが必要 | |
| オプション | 投稿検索、本文の閲覧、コメントの閲覧、サブレディットの閲覧 | ログインが必要 | |
| twitter（X） | 実験 | ツイート検索、ユーザープロフィール、ユーザーのツイート、ツイートスレッドの閲覧 | ログインが必要 |
| 実験 | 検索、ページのプロフィール情報 | ログインが必要 | |
| 実験 | ユーザー検索、プロフィール情報、ユーザーの投稿 | ログインが必要 |
ひとつ注意しておきたい点があります。デフォルトチャネルは不要なら削除できますが、一度削除すると、以降のアップデートで自動的に復元されることはありません。タイトルに挙げた X は現在実験チャネルに分類されており、たまに調べる用途には向いていますが、毎日依存する安定したデータソースとしては適していません。
Agent-Reach クイックスタート：Agent に一言伝えるだけ
インストールの全工程で、ターミナルを開く必要はありません。以下の各ステップには「合格基準」を設けています。確認できたら次のステップへ進んでください。問題が起きたときは、後述のトラブル対応表と照らし合わせてください。
ステップ 1：Agent の設定で「コマンド実行を許可」をオンにする
Agent-Reach は、Agent がターミナルコマンドを実行できることを前提としています。お使いの Agent のグラフィカルな設定画面で「コマンド実行を許可」に相当するスイッチを見つけてオンにしてください。名称は Agent ごとに少しずつ異なります。パソコンに uv が入っていなくても心配いりません。Agent がまず uv を自動でインストールします。コマンドは1つだけ、管理者パスワードも不要です。
- 合格基準：Agent に「今いるディレクトリを教えて」と伝えると、実際にコマンドを実行してパスを返してくるはずです。「コマンドを実行できません」と返答したら未達成です。
ステップ2：インストール用の一文を Agent に送る
これは公式が推奨する、最も手間のかからない方法です。以下の一文をそのままコピーして Agent に送るだけです：
Agent Reach をインストールしてください：https://raw.githubusercontent.com/Panniantong/Agent-Reach/main/docs/install.md
Agent はインストール手順を読み終えると、2つのことを自動で実行します。まず uv tool install https://github.com/Panniantong/Agent-Reach/releases/latest/download/agent-reach.zip を実行し、次に agent-reach setup を実行します。すべてのファイルは ~/.agent-reach/ という1つのフォルダにまとめて保存されるので、今後のアップグレード・管理・削除がとても簡単です。
- 合格基準：Agent がインストール完了を報告し、
agent-reach channelsを実行した際に返される JSON のokが true で、resultにチャネル一覧が表示されていること。
ステップ3：Agent にチャネルの状態を確認させる
Agent に「Agent Reach の状態を見て」と伝えてください。各チャネルが現在使えるかどうか、そして前回は正常だったのに今は壊れているチャネルはどれかを教えてくれます。このステップはいわば健康診断のようなもので、今後おかしな問題に遭遇したときも、まずこれを実行することをおすすめします。
- 合格基準：bilibili、v2ex、github、youtube、web の5つのデフォルトチャネルが使用可能と表示されていること。B站（ビリビリ）の字幕や YouTube の文字起こしなど、追加条件が必要な機能で「ログインが必要」「Key が必要」と表示されるのは正常な現象です。
ステップ4：任意のチャネルを追加してログインを完了する
小紅書（Xiaohongshu）を例に、「小紅書を追加して」とAgentに伝えれば、必要なソフトウェアを自動でインストールしてくれます。ログインが必要なプラットフォームは、Agent-Reachに標準搭載された専用ブラウザが処理します。バックグラウンドで動作してポップアップは表示されず、しかもこの専用ブラウザはこのPC上でのみ利用できます。Agentが代わりにログインすることは決してなく、パスワードを聞かれることもありません。
一部のプラットフォームでは、お使いのPCにすでにあるログイン状態を再利用します。コピーされるのはそのサイトのログイン情報だけで、元のブラウザは変更されず、パスワード保管庫を読み取ることもありません。ここでは必ず次のセクションのリスクに関する注意事項までお読みください。もし再利用されるのがメインアカウントだった場合は、「別のアカウントに切り替えて」とAgentに伝えてサブアカウントを使うようにしましょう。
- 受け入れ基準：もう一度「Agent Reachの状態を見せて」と伝えると、xiaohongshuが利用可能と表示されます。続けてAgentにキーワードで検索させ、返ってきた結果にノートのタイトルと本文の抜粋が含まれていることを確認します。
ステップ5：最初のクロスプラットフォーム調査タスクを実行する
目標を自然言語で伝えるだけでOKです。たとえば「Agent Reachで、あるメカニカルキーボードの評判を調べて。小紅書のノート、Bilibiliのレビュー動画の字幕、Redditの議論をそれぞれ見て、最後にプラットフォームごとにまとめて」といった具合です。Agentはこれを自分で分解し、複数の agent-reach <渠道> <动作> [参数] コマンドとして実行します。
- 受け入れ基準：Agentのまとめがプラットフォームごとに分けて整理され、各意見が具体的なノート・動画・投稿に対応づけられていること。また、どこかのチャネルが失敗した場合には、黙ってスキップするのではなく、
error.hintに含まれるヒントを伝えてくれること。
🚀 すぐに始めるためのヒント：Agent-Reachが担当するのはコンテンツを取得するところまでで、理解や要約はAgentの背後にある大規模言語モデルが行います。お使いのAgentがカスタムモデルインターフェースに対応していれば、APIYI apiyi.com 経由で1つのAPIキーからClaude、GPT、Geminiなどのモデルに接続できます。新規ユーザーには無料のテスト枠があるので、まずは低コストで最初の調査タスクを動かしてみるのにぴったりです。
エージェントにAPIYIのモデルAPIを設定する方法
お使いのエージェントがOpenAI互換APIに対応している場合、設定の考え方は次のとおりです。具体的なフィールド名は、使用しているエージェントの設定画面に従ってください。
- エンドポイントURL（base_url）：
https://api.apiyi.com/v1 - APIキー：APIYIコンソールで作成したキー
-
モデル名：日常的な調査には
claude-sonnet-5-5を推奨。一括処理などの軽量タスクならclaude-haiku-5-5も選択できます。 -
確認ポイント：エージェントで「こんにちは、どのモデルか教えて」と送信し、正常に応答が返り、APIYIコンソールに対応する呼び出し履歴が表示されることを確認してください。
Agent-Reach よく使うコマンド対応表
日常的には、左列の言葉をそのままエージェントに伝えるだけでOKです。コマンド列は、エージェントが裏で何をしているかを理解したいときや、自分のターミナルで問題を調べたいときに参照してください。
| エージェントに言うこと | エージェントが裏で実行するコマンド | 用途 |
|---|---|---|
| 「どんなチャンネルがあって、それぞれ何ができる？」 | agent-reach channels |
チャンネルと機能を確認 |
| 「B站（Bilibili）で大規模言語モデルを検索して」 | agent-reach bilibili search "大模型" |
統一フォーマット：チャンネル + アクション + パラメータ |
| 「このリンクを読んで」 | agent-reach read <链接> |
リンクに応じてチャンネルを自動選択 |
| 「Agent Reachをアップグレードして」 | agent-reach update |
プログラム、各チャンネルのツール、skillをまとめて更新 |
| 「インストールしたのにコマンドが見つからない」 | uv tool update-shell の後、新しいシェルを開く |
コマンドパスの問題を修正 |
| （自分でターミナルで実行） | agent-reach configure groq-key |
音声文字起こしに必要なキーを入力 |
| 「Agent Reachをアンインストールして」 | 削除する内容を先に一覧表示し、確認してから削除 | 安全にアンインストール |
さらに、「小紅書を外して」「小紅書のログインが切れた」「ログアウトして」「別のAIでも使えるようにして」といった言い方も、そのままエージェントに伝えればOKです。コマンドを覚える必要はありません。
Agent-Reach のリスク警告（使用前に必ずお読みください）
⚠️ Agent-Reach を使用する前に、このセクションをよくお読みください
- これはコミュニティによるオープンソースツールであり、いかなるプラットフォームの公式認可 API でもありません。 私たちはこのプロジェクトを推奨しているだけで、その安定性、安全性、コンプライアンスについて一切保証するものではありません。
- アカウントがレート制限や凍結を受ける可能性があります。 X、小红书（Xiaohongshu）、Reddit などのプラットフォームは、自動アクセスを異常行為と判定する場合があります。公式 README でも同様にサブアカウントの使用を明確に推奨しています。重要度の高いアカウントで Agent を実行しないでください。
- 本機のログイン状態を再利用すると、メインアカウントが使われてしまう可能性があります。 一部のチャネルはコンピュータ上に既に存在するログイン状態を再利用しますが、普段ログインしているのは通常メインアカウントです。チャネルを有効にした後は、まず現在どのアカウントを使用しているかを確認し、必要に応じて Agent に「アカウントを切り替えて」と伝えてサブアカウントに変更してください。
- 結果は自己責任です。 アカウント凍結、レート制限、データ収集・利用に関するコンプライアンス問題など、すべての結果は読者自身が判断し負担するものであり、APIYI プラットフォームおよび本記事の著者とは関係ありません。
- インストール元を必ず確認してください。 PyPI 上の agent-reach というパッケージは本プロジェクトではありません。必ず GitHub のアドレスからインストールしてください。本プロジェクトには公式トークン、コイン、投資商品、ウォレット接続は一切存在せず、この名前を借りたいかなる暗号資産プロジェクトも本リポジトリとは無関係です。
Agent-Reach トラブルシューティング表
以下は、使い始めの段階でよくある5つのケースです。どれもそのまま実行できる内容になっています。トラブルシューティングの前に、まず Agent に「Agent Reach のステータスを確認して」と実行させ、error.hint の原文を教えてもらうのがおすすめです。
| 現象 | 原因 | 解決方法 |
|---|---|---|
インストール後に agent-reach コマンドが見つからないと表示される |
uv のツールディレクトリがまだコマンドパスに追加されていない | Agent に uv tool update-shell を実行させ、新しいシェルを開く（または Agent を再起動する）と再試行できます |
| Agent が「コマンドを実行できません」と返答する | コマンド実行権限がオンになっていない | ステップ1に戻り、Agent の設定で「コマンド実行を許可」をオンにします |
| 1.5 からアップグレード後にさまざまなエラーが出る | 1.5 以前のバージョンは pipx/pip でインストールされていた | GitHub のインストールアドレスを付けて uv tool install --force を実行させ、続けて agent-reach setup を実行します。キーと設定は保持されます |
| 小紅書で突然コンテンツが検索できなくなり、ログインが必要と表示される | ログイン状態の期限切れ | Agent に「小紅書のログインが切れた」と伝え、案内に従って再ログインします（サブアカウント推奨） |
| X チャネルの調子が安定しない | twitter は実験的なチャネルで、プラットフォーム側のスクレイピング対策がより厳しい | まずステータスを確認して利用可能か判断し、使えない場合はプロジェクトの更新を待って agent-reach update を実行します。GitHub Issues で報告することもできます |
Agent-Reach のコストとモデル選択
Agent-Reach 自体は無料で、プラットフォームのAPI料金もありません。実際にコストがかかるのは、Agent-Reach を実行する Agent が大規模言語モデルを呼び出すときに消費するトークンです。以下は、2026-10-26 時点で APIYI apiyi.com のドキュメントセンターで確認した3モデルの価格です。単位は米ドル/100万トークンで、モデルと価格はプラットフォームのモデル一覧を基準とします。
| モデル | 入力 | 出力 | キャッシュ読み取り | 適した Agent-Reach タスク | 利用可能なプラットフォーム |
|---|---|---|---|---|---|
| claude-opus-5-5 | $4 | $20 | $0.2 | 長文の調査レポート、複数ソース間の情報クロスチェック | APIYI apiyi.com |
| claude-sonnet-5-5 | $2 | $10 | $0.1 | 日常的なクロスプラットフォーム調査の主力 | APIYI |
| claude-haiku-5-5 | $0.1 | $0.5 | $0.01 | バッチ要約、簡単な検索、ステータス確認 | APIYI |
ここでは大まかな試算を示します（実測ではありません）。4つのプラットフォームにまたがる調査1回で、Agent が長い投稿を5件読み、さらに検索結果20件を処理する場合、入力は約3万〜6万トークン、出力は約3千〜6千トークンになります。claude-sonnet-5-5 で計算すると1回あたり約0.1ドル前後、claude-haiku-5-5 なら約1セント未満、claude-opus-5-5 なら約0.2〜0.35ドルになります。
モデル選択のアドバイスはシンプルです。まず sonnet でフローを通し、結果の品質に応じて opus へのアップグレードを検討し、反復的なバッチ処理は haiku に任せましょう。Agent-Reach は整理された構造化コンテンツを返すため、Agent に元のWebページを読ませるよりもトークンを節約できます。長期的に使う場合は、キャッシュ読み取り価格によるコスト削減にも注目するとよいでしょう。
よくある質問（FAQ）
Q1：Agent-Reach は本当に完全無料ですか？
Agent-Reach 自体は無料で、MIT ライセンスのオープンソースです。各プラットフォームも API 利用料を徴収しません。支払う必要があるのは、Agent が大規模言語モデルを呼び出す際のトークン費用だけです。前述の試算によると、4 つのプラットフォームにまたがる調査を sonnet クラスのモデルで 1 回実行すると、およそ 0.1 ドル前後になります。まずは試してみたいという方は、APIYI apiyi.com で新規ユーザー向けの無料テスト枠を受け取り、最初のタスクを実行してみてください。
Q2：Agent が私のアカウントで投稿したり、いいねや DM を送ったりすることはありますか？
いいえ、ありません。Agent-Reach は読み取り専用のツールで、検索と読み取りのみを行い、投稿・コメント・いいね・DM 送信は一切行いません。ただし、読み取り専用だからといってリスクがゼロというわけではありません。プラットフォーム側が高頻度の読み取りを異常アクセスと判定する可能性があるため、サブアカウントの使用をおすすめします。詳しくはリスクに関する注意のセクションをご覧ください。
Q3：YouTube と小宇宙（Xiaoyuzhou）の音声文字起こしはどうやって有効にしますか？Key を Agent に送る必要はありますか？
YouTube の文字起こしには Groq または OpenAI の Key が必要で、小宇宙には Groq の Key が必要です。**Key をチャットに直接送らないでください**。公式の指示では、ご自身のターミナルで `agent-reach configure groq-key` を実行して入力することになっています。確認方法：Agent に YouTube 動画の文字起こしを実行させ、返ってきた JSON の `ok` が true で、かつテキスト内容が含まれていれば成功です。
Q4：Agent-Reach はどのモデルと組み合わせるのが一番効果的ですか？
日常的な調査には claude-sonnet-5-5 から始めるのがおすすめです。複数ソースの内容を理解することとコスト管理のバランスが取れています。より深い分析が必要なときは claude-opus-5-5 に切り替えてください。APIYI apiyi.com なら 1 つの Key でこれらのモデルを切り替えられ、変更するのはモデル名だけでインターフェースのアドレスは変えなくて済むため、同じ調査タスクで効果を直接比較するのに便利です。
Q5：すでに Claude Code にインストール済みですが、別の Agent でも使えるようにするには？
すでにインストール済みの Agent に「別の AI でも使えるようにして」と伝えるだけで、共有設定を処理してくれます。すべてのファイルは `~/.agent-reach/` フォルダに一元管理されているため、別の Agent も同様にコマンド実行権限を有効にしていれば呼び出せます。確認方法：新しい Agent で「Agent Reach の状態を見せて」と伝え、元の Agent と同じチャネル一覧が返ってくれば成功です。
Agent-Reach チュートリアルの核心ポイント
- ひとことで言うと：Agent-Reach は、ログインウォールの先にあるコンテンツ、動画の中身、そして中国語プラットフォーム上の情報を Agent が読み取れるようにします。
- インストール方法：公式の
install.mdリンクを Agent に送るだけ。あとは Agent が自分でuvとagent-reachをインストールします。 - 3 段階のチャネル：デフォルトの 5 個はすぐに使え、オプションの 6 個はひとことで有効化でき、実験的な 3 個はいつ使えなくなってもおかしくありません。
- 読み取り専用の設計：投稿・いいね・DM 送信は行わず、出力は
okフィールド付きの JSON に統一されています。 - アカウントの安全性：コミュニティ製ツールであり公式 API ではないため、レート制限やアカウント停止を招く可能性があります。必ずサブアカウントを使ってください。
- コストは管理しやすい：プラットフォーム API の費用は 0 で、主なコストはモデルのトークンです。APIYI apiyi.com を通じて従量課金で利用できます。
まとめ
Agent-Reach チュートリアルの核心ポイントは次のとおりです。
- 本当の課題を解決：一般的な検索では見つからない小紅書（Xiaohongshu）のノート、X アカウントの動き、B站（ビリビリ）の字幕を、Agent が直接読み取れるようになりました。
- 導入のハードルはほぼゼロ：Agent にひとこと伝えればインストールが完了し、その後のチャネル追加、アカウント変更、アップグレードもすべて普通の言葉で済みます。
- リスクは自分で理解しておく：これはコミュニティ製のオープンソースツールです。サブアカウントを使い、どのアカウントを再利用するかよく確認したうえで、結果は自己判断で引き受けてください。
まずはデフォルトのチャネルで B站 や GitHub の調査を一度通しで実行し、各ステップの確認がすべて通ることを確かめてから、必要に応じて小紅書や Reddit などログインが必要なチャネルを追加するのがおすすめです。
モデルが必要な場合は APIYI apiyi.com をご利用ください。
📚 参考資料
- Agent-Reach GitHub リポジトリ：プロジェクトのソースコード、README、チャネル説明
- リンク：
github.com/Panniantong/Agent-Reach -
説明：唯一信頼できるインストール元です。チャネル一覧とセキュリティに関する説明はこちらを基準にしてください
-
Agent-Reach 公式インストールガイド：Agent が読み取るためのインストールドキュメント
- リンク：
raw.githubusercontent.com/Panniantong/Agent-Reach/main/docs/install.md -
説明：本記事のステップ2で Agent に送信するのはこのアドレスです
-
Agent-Reach GitHub Issues：問題報告の窓口
- リンク：
github.com/Panniantong/Agent-Reach/issues - 説明：実験的なチャネルが機能しない場合やインストールエラーが発生した場合は、こちらで検索または報告できます
作者：APIYI 技術チーム
技術交流：APIYI のウェブサイトトップページからお気軽にお問い合わせください。その他の資料は docs.apiyi.com ドキュメントセンターでご覧いただけます
