Panniantong/Agent-Reach

Agent Reach – AIエージェントのためのワンクリック・インターネット機能拡張

概要 – Pythonベースの機能レイヤーであり、コマンドライン駆動のAIエージェント（Claude Code、OpenClaw、Cursor、Windsurfなど）に、幅広いウェブサービスへの即時アクセス機能を提供します。各プラットフォーム（YouTube字幕、Twitterツイート、Reddit投稿、GitHubデータ、RSSフィードなど）に最も信頼性の高いツールを検出し、インストールおよび設定を行い、サイトのAPI変更やスクレイピング対策が行われた際もルーティングを最新の状態に保ちます。

重要性 – 現代のエージェントはコードを書いたりプロジェクトを管理したりできますが、「オンラインで何かを調べる」よう求められると立ち往生することがあります。Agent Reachは、手動でエラーが発生しやすい設定作業（CLIツールのインストール、Cookieの処理、CAPTCHAへの対応）を排除し、エージェントがより高レベルなタスクに集中できるようにします。

主な機能

• ゼロコンフィグ・チャンネル：多くの人気サイト（ウェブページ、YouTube、RSS、GitHub、LinkedInなど）に対応。
• ログインが必要なオプションチャンネル：Twitter/X、Reddit、Facebook、Instagram、小紅書（Xiaohongshu）などは、簡単な「帮我配 XXX」プロンプトで有効化可能。Cookieのエクスポートやブラウザセッションの連携手順をツールが案内します。
• 自動バックエンド選択：各チャンネルはプライマリおよびフォールバックの実装を定義しています（例：twitter-cli → OpenCLI → bird）。CLIが環境を調査し、最初に動作するバックエンドを選択し、agent-reach doctorを通じて結果を報告します。
• 安全第一のインストール：agent-reach installは、ユーザーが--systemを追加しない限り、環境のチェックのみを行います。ドライランモードでは、インストールされる内容を正確に確認できます。
• ローカルのみの認証情報ストレージ：Cookieとトークンは~/.agent-reach/config.yamlに権限600で保存され、外部への送信は一切行われません。
• 自己診断：agent-reach doctorが、どのチャンネルが機能しており、壊れている場合にどう修正すべきかを教えてくれます。
• クロスエージェント互換性：シェルコマンドを実行できるあらゆるエージェントで動作します。OpenClawユーザーはexecツールプロファイルを有効にするだけで利用可能です。

使用方法

1. 以下の1行の指示をエージェントのチャットにコピーしてください：

   帮我安装 Agent Reach：https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md
   

2. エージェントがインストールスクリプトを実行し、以下の処理を行います：
   • agent-reach CLIのインストール（yt-dlp、feedparserなどをバンドル）
   • 必要なシステムツールのチェック（Node.js、gh CLI、mcporter）
   • SKILL.mdファイルの登録（エージェントがどのコマンドを呼び出すべきかを認識するため）
3. インストール後、エージェントに「このリンクを読んで」、「YouTube動画を要約して」、「Redditで…を検索して」と頼むだけで、適切なバックエンドが自動的に呼び出されます。
4. 後で更新する場合は、同じ1行のプロンプトを更新URLと共に送信してください。

サポートされているプラットフォーム（概要）

プラットフォーム	すぐに利用可能	追加設定が必要
ウェブページ	✅ (Jina Reader)	—
YouTube	✅ (yt‑dlp subtitles)	—
RSS/Atom	✅ (feedparser)	—
GitHub (公開)	✅ (gh CLI)	プライベートリポジトリはログインが必要
Twitter/X	✅ (tweet fetch)	検索/タイムラインはログインが必要
Reddit	✅ (post fetch)	完全な検索はログインが必要
Bilibili	✅ (bili‑cli)	—
Facebook / Instagram	✅ (OpenCLI)	ログインが必要
小紅書	✅ (OpenCLI)	ログインが必要
LinkedIn	✅ (mcp‑server‑linkedin)	ログインが必要
その他 (Snowball, Boss直聘など)	✅ (特定の CLI)	手動のChromeセッションが必要な場合あり

設計哲学 – Agent Reachは単なるスクレイパーではなく、ツールの選択、インストール、健全性チェックを抽象化する機能レイヤーです。各チャンネルはプライマリおよびフォールバックのバックエンドをリスト化した小さなPythonモジュールであり、doctorコマンドがそれらを調査してアクティブなものを報告します。バックエンドが壊れた場合（例：yt‑dlpがBilibiliにブロックされた場合）、プロジェクトはリストを並べ替えるだけで済み、ユーザー側のコード変更は不要です。

セキュリティとプライバシー

• すべてのCookie/トークンはユーザーのPC内に留まり、リポジトリがそれらを送信することはありません。
• --systemが渡されない限り、インストールによってシステムファイルが変更されることはありません。
• READMEでは、ログインベースのチャンネルを使用する際のアカウント停止リスクについて警告しており、使い捨てアカウントの使用を推奨しています。

はじめに – リポジトリには以下が含まれています：

• docs/install.md および docs/update.md（エージェントに渡すURL）。
• プラットフォームごとのアダプターを含むchannels/ディレクトリ。
• CLIコマンド：agent-reach install, agent-reach doctor, agent-reach uninstall。

対象ユーザー – カスタムAIアシスタントを構築する開発者、データ収集のために内部エージェントをデプロイするチーム、またはスクレイピングコードを書かずにエージェントにウェブブラウジングさせたい愛好家。

---

上記の情報はすべてプロジェクトのREADMEから直接引用したものであり、追加の機能は推測されていません。