Agent-Reach のインストールとトラブルシューティング：Claude Code と Codex にWeb・マルチプラットフォーム検索を追加

Agent-Reach は新しい検索エンジンではありません。Webページ、GitHub、YouTube、RSS、Bilibiliなどのチャネルに適した上流ツールを選び、agent-reach doctor で現在の利用可否を確認するためのインストール・ルーティング・ヘルスチェック層です。

公式ドキュメントを1件調べるだけなら通常のブラウザの方が簡単です。Claude Code、Codex、Cursor、OpenClawに「検索、読み取り、整理」を連続して実行させたい場合に、Agent-Reachが役立ちます。

インストール前に確認すること

インストーラーは pip を呼び出し、Node.js、GitHub CLI、MCP関連ツールを検出する場合があります。重要な認証情報を保存している本番サーバーやメイン環境で、いきなり全自動インストールを実行しないでください。安全な順序は次のとおりです。

1. 一般ユーザーまたは隔離環境で試す。
2. dry runでインストール・変更予定を確認する。
3. 本番サーバーや共有PCではsafeモードを使う。
4. Twitter、Xiaohongshu、Redditなどログインが必要なサービスには専用のサブアカウントを使う。

OpenClawでは、Agentにコマンド実行権限があることも確認します。

1
2

openclaw config set tools.profile "coding"
openclaw gateway restart

Claude Code、Codex、Cursorのように端末コマンドを実行できるクライアントでは、通常この手順は不要です。

推奨インストール手順

まずCLIをインストールまたは更新します。

1

python -m pip install --upgrade agent-reach

システムを変更せずに処理内容を確認します。

1

agent-reach install --env=auto --dry-run

出力に表示された依存関係、skillディレクトリ、MCP設定の保存先を確認してからsafeモードを使います。

1

agent-reach install --env=auto --safe

個人用のテストPCでは自動インストールも使えますが、先にdry runを実行することを勧めます。

1

agent-reach install --env=auto

公式には、Agentに直接読ませるインストール手順も用意されています。

1
2
3

Agent Reachをsafeモードでインストールしてください：
https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md
インストール時に --safe を使用してください。

インストール後の検証

「インストール成功」という表示だけで判断せず、次を実行します。

1

agent-reach doctor

結果は次のように判断できます。

最初は、公開Webページの読み取り、公開GitHubリポジトリの要約、公開動画の字幕抽出という3つの小さなタスクを試します。すべて成功してからログインが必要なプラットフォームを設定してください。

すべてのプラットフォームが設定不要ではない

Web、YouTube、RSS、一部のGitHub・Bilibili機能はログインなしで利用できます。一方、Twitter、Reddit、Xiaohongshu、Facebook、Instagramなどは、ブラウザのログイン状態やCookieを必要とする場合があります。アンチボット規則は変化するため、CLIが入っていてもすべてのチャネルが永続的に動くとは限りません。

Agent-Reachは各チャネルに優先・代替バックエンドを持ち、doctor で現在のルートと修復方法を示します。連携が停止した場合は、無関係な設定を変更する前に更新と再診断を行います。

1
2

python -m pip install --upgrade agent-reach
agent-reach doctor

よくある問題

agent-reach コマンドが見つからない

Pythonがパッケージをインストールした場所を確認します。

1
2

python -m pip show agent-reach
python -m site --user-base

パッケージが存在するのにコマンドがない場合、PythonのScriptsディレクトリが PATH に含まれていない可能性があります。複数のPythonを続けてインストールする前に、端末を開き直してパスを確認してください。

Agentは会話できるがインストールを実行できない

Agent-Reachの障害ではなく、クライアントにshell/exec権限がない可能性が高いです。クライアントのツール権限を確認してください。OpenClawでは tools.profile が coding になっているか確認し、Gatewayを再起動して新しいセッションを開きます。

ログインが必要なサービスが突然使えなくなった

Cookieの期限切れ、プラットフォームの仕様変更、リスク制御が原因として考えられます。agent-reach doctor で失敗したチャネルを特定し、そのログイン状態だけを更新します。メインアカウントのCookieをチャット履歴、公開ログ、リモートサーバーに貼り付けないでください。

アンインストールと復旧

削除対象を先に確認します。

1

agent-reach uninstall --dry-run

完全アンインストールでは、設定ディレクトリ、skillファイル、関連MCP設定が削除されます。

1
2

agent-reach uninstall
python -m pip uninstall agent-reach

TokenやCookieを残してskillだけを再インストールする場合は、次を使います。

1

agent-reach uninstall --keep-config

まとめ

Agent-Reachは複数プラットフォームの調査を繰り返すコマンドラインAgentユーザーに適しています。最初から全チャネルを有効にするのではなく、dry run、設定不要チャネルの導入、doctor による検証、必要なログインチャネルの追加という順で進めてください。クライアント権限、上流ツール、プラットフォームのログイン状態のどこで失敗したかを切り分けやすくなり、アカウントと認証情報のリスクも抑えられます。

参考資料

• Agent-Reach公式リポジトリ
• 公式インストールガイド
• 公式アップデートガイド