agent-reach

Agent Reach（agent-reach）は、AI Agent向けのインターネット接続能力レイヤーであり、Agentが自然言語の1つの指示でツール選定、インストール、ヘルスチェック、ルーティング設定を完了できることを目標としています。プロジェクトはMITライセンスでオープンソース化されており、Python 3.10以上が必要です。 核心的な考え方：Agent Reach自体は各プラットフォームの読み取りロジックを直接ラップせず、Agentが上流ツール（yt-dlp、gh CLI、feedparser、Jina Reader、OpenCLI、twitter-cli、bili-cliなど）を直接呼び出します。Agent Reachは「各プラットフォームで現在利用可能な接続方式」を維持し、Agentが使用するためのSKILL.mdを生成する役割を担います。各チャネルは「優先＋代替」の順序付きバックエンドリストとして設計されており、インストールや診断時に実際に可用性を検出し、ある前置バックエンドが失敗した場合は次のものに切り替えます。ユーザーは `agent-reach doctor` で各チャネルの状態と現在有効なルーティングを確認できます。 クイック使用：インストール指示（docs/install.mdを読む）をshellコマンド実行をサポートするAgent（Claude Code、OpenClaw、Cursor、Windsurfなど）に送信すると、Agentは手順に従ってagent-reach CLIをインストールし、Node.js、gh CLI、mcporterなどの基本依存関係を確認し、明示的な承認の下でAgentのskillsディレクトリに書き込みます。デフォルトの安全性：`agent-reach install` は環境を読み取り専用で確認するだけで、システムを自動変更したり設定を書き込んだりしません。明示的に `--system` を渡した場合のみシステム依存関係をインストールして設定を書き込みます。また `--dry-run` で全操作をプレビューできます。更新も同様に1つの指示で完了できます。 接続済みのチャネルには以下が含まれます：Webページ閲覧（Jina Reader）、YouTube字幕抽出と動画検索（yt-dlp）、RSS/Atom閲覧（feedparser）、全网セマンティック検索（Exa via mcporter）、GitHub（gh CLI、リポジトリ閲覧、検索を含み、設定後はプライベートリポジトリ、Issue/PRをサポート）、Twitter/Xツイート閲覧と検索、Bilibili検索と動画詳細（bili-cliなど）、Reddit検索と投稿閲覧、FacebookページとFeed、Instagramユーザーと投稿、小紅書検索と閲覧、LinkedInプロフィールと求人検索、V2EX、雪球、小宇宙ポッドキャスト（Whisper文字起こし）など。一部のチャネルはゼロ設定で利用可能です。ログイン状態が必要なチャネルは、Agentがユーザーをガイドして設定を完了させます。例えばCookie-Editorで手動でCookieをエクスポートするか、デスクトップブラウザの既存のログインセッションを再利用します。 セキュリティとプライバシー：Cookie/Tokenはローカルの `~/.agent-reach/config.yaml`（ファイル権限600）に保存され、アップロードや外部送信は行いません。コードと依存ツールはすべてオープンソースで監査可能です。プロジェクトは明確に注意を促しています：Cookieログインを使用するプラットフォームでは、プラットフォームに検出されてアカウント停止されるリスクがあるため、メインアカウントではなく専用のサブアカウントを使用することを推奨します。`agent-reach uninstall` はローカル設定、各Agentのskillファイル、MCP設定を削除でき、`--dry-run` でプレビュー、`--keep-config` で再インストール用に設定を保持できます。 設計上の位置づけとして、Agent Reachは「能力レイヤー」であり、もう1つの具体的なツールではありません。基盤となる読み取りはAgentが上流ツールを直接呼び出して完了し、Agent Reachは選定、インストール、ヘルスチェック、ルーティングを担当し、プラットフォームAPI、アンチクロール戦略、CLIツールが継続的に変化する状況に対応します。