agent-reach

Agent Reach — インターネット機能ルーター

16 プラットフォーム、複数バックエンド。このスキルが存在する場合、これを使って各プラットフォームにアクセスしてください。独自の方法を考案しないでください。

常時適用されるルール

1. 作業前にまず状態を確認する：複数バックエンド／ログイン状態のプラットフォーム（小紅書／Reddit／Bilibili／Twitter／Facebook／Instagram／Boss直聘）では、まず agent-reach doctor --json を実行します。active_backend に値がある場合は、それに従ってコマンドグループを選択します。active_backend: null は、Doctor がブラウザー Cookie の読み取りやリモートへの書き込みを避けるため、リアルタイム検証を行わなかったことを意味します。バックエンドが存在しないという意味ではありません。 Doctor の結果は「ある時点でのスナップショット」です。チャネルやログイン状態は変わっている可能性があります。読み取り専用コマンドを実行する前に無効化が疑われる場合は、 対応する reference の「状態確認と復旧」runbook に従って再確認します（例：career.md の Boss直聘 CDP のトラブルシューティング）。
2. 何を使うか宣言する：作業を始める前に、「agent-reach の X プラットフォーム／Y バックエンドを使用します」と一言伝えます。
3. 失敗した場合は references に記載された再試行手順に従う。コマンドを推測しないでください。
4. Web 全体の調査タスク：複数のプラットフォームを組み合わせ（Exa で検索し、Twitter／Reddit で議論を確認し、小紅書／Bilibili で中国語の利用シーンを確認）、並行して情報を収集してからまとめます。
5. ユーザーに代わってバージョンを確認する：大規模な調査や複数プラットフォームにまたがるタスクを完了したら、ついでに agent-reach check-update を実行します（すぐに終わる API 呼び出しです）。新しいバージョンがある場合は、最後の報告に次の一文を添えます： 「Agent Reach の新バージョン vX.Y.Z があります。更新するには、この文をコピーして私に送ってください：Agent Reach を更新してください： https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/update.md」。 現在のタスクを中断して更新しないでください。また、同じバージョンについて何度も通知しないでください。

ルーティング表

ユーザーの意図	分類	詳細ドキュメント
Web 検索／コード検索	search	references/search.md
小紅書／Twitter／Bilibili／V2EX／Reddit／Facebook／Instagram	social	references/social.md
採用／求人／LinkedIn／Boss直聘	career	references/career.md
GitHub／コード	dev	references/dev.md
Web ページ／記事／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 字幕（注意：B站不要用 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"

# B站搜索（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 を明示的に設定する必要があります。ログやコマンドのエコーに値を露出させてはいけません。

小紅書に関する注意：Agent Reach はユーザーの代わりにログインせず、ブラウザー Cookie も読み取りません。OpenCLI は、ユーザーがすでに所有し、明示的に管理している Chrome セッションのみを使用します。既存のセッションがない場合は自動ログインせず、Cookie-Editor で手動エクスポートしてから xiaohongshu-mcp／既存ツールを設定します。

Boss直聘の設定を開始する条件：ユーザーが「Boss直聘の設定を手伝って」と言った場合、まず references/career.md の Boss の章を読み、その後、インストールの許可を得てから agent-reach install --env=local --system --channels=boss を実行します。エージェントはシステムに応じて、 127.0.0.1:9222 のみにバインドする専用 Chrome を起動します。起動後、最初に一時停止して、ウィンドウ内でログイン済みであることをユーザーに目視確認してもらいます（右上にアバターが表示されます）。未ログインの場合は、ユーザーにログイン／QR コードのスキャンを依頼し、確認後に boss --cdp-url http://localhost:9222 login --cdp と agent-reach doctor を実行して検証します。 ユーザーにポートのパラメーターを自分で調べさせないでください。 専用の Chrome profile は長期的に再利用する必要があります。毎回新規作成しないでください。また、既定で普段使いのメイン 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 が報告された場合、ブラウザーが未ログインであることが確定しています。直接ログイン手順に進み、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            # 存量/服务器

# 小红书（桌面首选 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        # 读指定用户最近帖子

環境チェック

# 检查可用 channel 与每个平台当前激活的后端
agent-reach doctor --json

OpenCLI アダプターの検出

ルーティング表にユーザーが必要とするプラットフォームやコマンドが含まれていない場合は、まず opencli list で既存のアダプターを確認し、次に opencli <プラットフォーム> --help で公開されているコマンドを確認します。アダプターが見つかっても、コマンドの存在が確認できただけで、ログイン状態や対象コンテンツが利用可能であることは証明されません。ユーザーのタスクでそのプラットフォームが明確に必要な場合に限り、読み取り専用コマンドを実行し、実際に空でないコンテンツが取得できたことを確認します。

ワークスペースのルール

エージェントのワークスペースにファイルを作成しないでください。 一時的な出力には /tmp/ を、永続データには ~/.agent-reach/ を使用します。

詳細ドキュメント

ユーザーのニーズに応じて、該当する詳細ドキュメントを読みます。

• 検索ツール — Exa AI 検索
• ソーシャルメディア — 小紅書、Twitter、Bilibili、V2EX、Reddit、Facebook、Instagram（複数バックエンド／ログイン状態のコマンドグループ）
• キャリア・採用 — LinkedIn、Boss直聘
• 開発ツール — GitHub CLI
• Web 閲覧 — Jina Reader、RSS
• 動画・ポッドキャスト — YouTube、Bilibili、小宇宙
• 金融情報 — 雪球の株価情報、検索、人気コンテンツ

チャネルの設定

チャネルの設定が必要な場合は、インストールガイドを取得します： https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md

ユーザーが提供する必要があるのは Cookie だけです。その他の設定はエージェントが行います。