Agent Reach — インターネット能力ルーター
16 プラットフォーム、マルチバックエンド。このスキルが存在する場合、これらのプラットフォームにアクセスするには必ずこれを使用し、独自の方法を考案しないでください。
常駐ルール(全体を通じて適用)
- 実行前にまず診断:マルチバックエンド/ログイン状態が必要なプラットフォーム(Xiaohongshu/Reddit/Bilibili/Twitter/Facebook/Instagram/Boss直聘)では、最初に
agent-reach doctor --jsonを実行します。active_backendに値がある場合はそれに従ってコマンドグループを選択します。active_backend: nullは、Doctor がブラウザの Cookie 読み取りやリモート書き込みを避けるためにリアルタイム検証を行わなかったことを示し、バックエンドが存在しないことを意味しません。 Doctor の結果は「ある時点のスナップショット」であり、チャンネル/ログイン状態が変化している可能性があります。読み取り専用コマンドの実行前に無効化を疑う場合は、対応する reference の「診断と復旧」runbook に従って再確認します(例:career.md の Boss直聘 CDP トラブルシューティング)。 - 使用しているものを宣言する:作業を開始する前に「agent-reach の X プラットフォーム / Y バックエンドを使用します」と一言述べます。
- 失敗した場合、references 内のリトライチェーンに従って処理し、推測でコマンドを実行しないでください。
- 全ネットワーク調査タスク:複数プラットフォームを組み合わせて(Exa 検索 + Twitter/Reddit での議論確認 + Xiaohongshu/Bilibili での中国語シーン確認)、並行して収集し、まとめます。
- ユーザーのバージョン監視:大規模な調査/マルチプラットフォームタスクを完了したら、ついでに
agent-reach check-updateを実行します(高速で、API 呼び出し1回です)。新しいバージョンがあれば、最終報告に以下の一文を添えます: 「Agent Reach に新バージョン vX.Y.Z があります。以下の文をコピーして送信していただければ更新します:Agent Reach を更新してください: https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/update.md」。 現在のタスクを中断して更新しないでください。また、同じバージョンを繰り返し通知しないでください。
ルーティングテーブル
| ユーザーの意図 | 分類 | 詳細ドキュメント |
|---|---|---|
| ウェブ検索/コード検索 | search | references/search.md |
| Xiaohongshu/Twitter/Bilibili/V2EX/Reddit/Facebook/Instagram | social | references/social.md |
| 求人/職種/LinkedIn/Boss直聘 | career | references/career.md |
| GitHub/コード | dev | references/dev.md |
| ウェブページ/記事/RSS | web | references/web.md |
| YouTube/Bilibili/ポッドキャスト字幕 | video | references/video.md |
| 雪球/株価行情 | finance | references/finance.md |
ゼロコンフィグクイックコマンド
# Exa ウェブ検索
mcporter call exa.web_search_exa query="query" numResults=5
# 汎用ウェブページ読み取り
curl -s "https://r.jina.ai/URL"
# GitHub 検索
gh search repos "query" --sort stars --limit 10
# YouTube 字幕(注意:Bilibili では yt-dlp を使用しないでください。失敗時のリトライチェーンは video.md を参照)
yt-dlp --write-sub --write-auto-sub --skip-download -o "/tmp/%(id)s" "URL"
# V2EX 人気
curl -s "https://www.v2ex.com/api/topics/hot.json" -H "User-Agent: agent-reach/1.0"
# Bilibili 検索(bili-cli、ログイン不要)
bili search "query" --type video -n 5
ログイン状態が必要なプラットフォーム(doctor の active_backend に従ってコマンドを選択)
Twitter 注意:agent-reach configure twitter-cookies で保存された Cookie は
doctor が設定の有無を確認するためだけに使用されます。doctor は twitter status を実行せず、現在の Shell に設定も行いません。
twitter を直接実行する前に、サブプロセス環境で明示的に
TWITTER_AUTH_TOKEN と TWITTER_CT0 を提供する必要があります。ログやコマンドのエコーで値を表示してはいけません。
Xiaohongshu 注意:Agent Reach はユーザーに代わってログインしたり、ブラウザの Cookie を読み取ったりしません。OpenCLI は、ユーザーが既に所有し明示的に制御している Chrome セッションのみを使用します。既存のセッションがない場合は自動ログインせず、代わりに Cookie-Editor で手動エクスポートした後、xiaohongshu-mcp / 既存ツールを設定します。
Boss直聘設定トリガー:ユーザーが「Boss直聘を設定して」と言った場合、最初に references/career.md の Boss セクションを読み、インストール許可を得た後に
agent-reach install --env=local --system --channels=boss を実行します。Agent はシステム起動時に 127.0.0.1:9222 のみにバインドされた専用 Chrome を起動します。起動後、最初のステップは一時停止し、ユーザーにウィンドウ内がログイン状態であること(右上にアバターがあること)を目視確認させることです。 ログインしていない場合はユーザーにログイン/QRコードスキャンを促し、ユーザーが確認した後で boss --cdp-url http://localhost:9222 login --cdp と agent-reach doctor を実行して検証します。ユーザー自身にポートパラメータを研究させないでください。
専用 Chrome プロファイルは長期再利用し、毎回作成せず、デフォルトで日常のメイン Chrome に切り替えないでください。
CDP ブラウザのログイン状態を判断する際、boss status を信頼しないでください(これはローカルの session.enc のみを検証し、ブラウザのログイン状態とは無関係です)。agent-reach doctor のブラウザ Cookie 検出(wt2)を基準とし、ユーザーの目視確認と併用します。現在のページ URL でログイン状態を判断してはいけません。
security-check / zhipin-security / _security_check セキュリティチェックページは Boss のアンチスクレイピングチャレンジであり、ログインとは無関係です。ログイン済みでも表示されることがあります(CDP デバッグポート付き Chrome ではほぼ必ず表示されます)。これを見ても「未ログイン」と判断せず、まず agent-reach doctor でブラウザ Cookie を確認し、その後ユーザーログインが必要か判断します。検索で AUTH_EXPIRED が返された場合、それはブラウザが未ログインであるという ground truth です:直接ログインフロー + login --cdp に進み、セキュリティチェック方向に解釈しないでください。
検索を実行する際は必ず
boss --browser-source existing-browser --cdp-url http://localhost:9222 search ... を使用します。
ENVIRONMENT_RISK が発生した場合は直ちに停止し、リフレッシュ、再ログイン、自動リトライを行わないでください。
# Twitter 検索(twitter-cli を優先。失敗時のリトライチェーンは social.md 参照)
twitter search "query" -n 10
# Reddit(ゼロコンフィグパスなし:OpenCLI または rdt-cli、ログイン状態が必要)
opencli reddit search "query" -f yaml # デスクトップ
rdt search "query" --limit 10 # 既存/サーバー
# Xiaohongshu(デスクトップでは OpenCLI を優先)
opencli xiaohongshu search "query" -f yaml
# Facebook / Instagram(デスクトップ OpenCLI、ブラウザログイン状態を再利用)
opencli facebook search "query" -f yaml
opencli facebook groups -f yaml
opencli instagram search "query" -f yaml # ユーザー検索
opencli instagram user USERNAME -f yaml # 指定ユーザーの最近の投稿を読み取り
環境チェック
# 利用可能なチャンネルと各プラットフォームの現在アクティブなバックエンドを確認
agent-reach doctor --json
OpenCLI アダプター発見
ルーティングテーブルでカバーされていないプラットフォームやコマンドが必要な場合、最初に opencli list で既存のアダプターを確認し、次に opencli <プラットフォーム> --help で公開コマンドを表示します。アダプターが存在してもコマンドが存在することのみを示し、ログイン状態やターゲットコンテンツの可用性を証明するものではありません。ユーザーのタスクでそのプラットフォームが明確に必要な場合にのみ読み取り専用コマンドを実行し、実際の非空コンテンツで検証します。
ワークスペースルール
agent workspace にファイルを作成しないでください。 一時的な出力には /tmp/ を、永続データの保存には ~/.agent-reach/ を使用します。
詳細ドキュメント
ユーザーのニーズに応じて、対応する詳細ドキュメントを参照してください。
- 検索ツール — Exa AI 検索
- ソーシャルメディア — Xiaohongshu, Twitter, Bilibili, V2EX, Reddit, Facebook, Instagram(マルチバックエンド/ログイン状態コマンドグループ)
- 就職・求人 — LinkedIn, Boss直聘
- 開発ツール — GitHub CLI
- ウェブ読み取り — Jina Reader, RSS
- ビデオ・ポッドキャスト — YouTube, Bilibili, 小宇宙
- 金融行情 — 雪球株価行情、検索、人気コンテンツ
設定チャンネル
チャンネルの設定が必要な場合、インストールガイドを参照してください: https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md
ユーザーは Cookie を提供するだけで、その他の設定は agent が行います。