Agent Reach 導入ガイド: Claude Code / OpenClaw が X（旧Twitter）/ 小紅書 / Bilibili を理解できるようにする

一言まとめ: あなたの AI Agent はコードを書くのがめちゃくちゃ上手い。でも「ネットで何かを調べてくれ」と言うと急に動けなくなる？ Agent Reach は一行コマンドの特効薬――X（旧Twitter）、Reddit、YouTube、B站（Bilibili）、小紅書、Douyin（抖音）、WeChat 公衆アカウント（微信公众号）…など 14+ のプラットフォームを一気にセットアップ。Agent は自分でどのツールを使えばいいか分かります。

プロジェクト概要

Agent Reach は **AI Agent 向けの「インターネット機能インストーラ」**で、GitHub: Panniantong/Agent-Reach、MIT ライセンス、Python パッケージです。

その核となる立ち位置はかなり独特: **フレームワークではなく、足場（scaffolding）**です。

どういうこと？ AI Agent（Claude Code / OpenClaw / Cursor / Windsurf...）に Agent Reach を入れると、Agent Reach のラッピング層を経由せず、そのまま上流ツールを呼び出します――twitter-cli / rdt-cli / yt-dlp / xhs-cli / douyin-mcp-server / Jina Reader / gh CLI など、プロジェクト作者が選び抜き、つまずきどころを踏んだうえで、デフォルト設定まで整えたツールです。Agent Reach は主に次の役割だけを担います:

1. インストーラ ― 一行 pip install agent-reach + agent-reach install で、上流ツールを全部まとめて導入
2. 診断器 ― agent-reach doctor を一発実行し、どのプラットフォームが使える／使えないか、どう直すかを教える
3. 設定器 ― Cookie 認証、API Key、MCP サービスなどを一度でまとめて管理
4. SKILL 注入 ― Agent に SKILL.md を登録し、「推特を調べる」「動画を見る」みたいな要求が来たら、自動で対応ツールを呼び出す

対応している 14+ のプラットフォーム:

一言: コマンドを覚えなくていい、クローラ設定もしなくていい。Agent に話しかければネットに出ていきます。

難易度 / 所要時間 / 得られるもの

• 難易度: ⭐（初心者向け、本当に「一行コマンド」）
• 所要時間: 5〜15 分（ローカルPC） / 30 分（サーバー、Cookie 設定込み）
• 得られるもの:
  • Claude Code / OpenClaw がそのまま X（旧Twitter）を読んだり、小紅書を閲覧したり、YouTube の字幕を読めるようになる
  • AI Agent のツールエコシステムにおける「scaffolding vs framework」の設計差が理解できる
  • Cookie-Editor で複数プラットフォームの Cookie を統一管理し、QR ログインの罠を回避できる
  • agent-reach doctor が Agent ツールチェーンの「良い実践」だと分かる

対象読者像

• Claude Code / OpenClaw / Cursor を使って開発作業をしている人
• Agent に 本当にネットで資料を調べさせたい、ただ固まってほしいわけではない人
• X（旧Twitter）/ Reddit / 小紅書 をそれぞれ別々にクローラをいじるのも、課金 API を払うのも嫌な人
• 既に AI Agent のツールチェーンがあり、そこに「インターネット能力」の層を足したい人
• Agent が長時間タスクを回すときの、“あまり痛くない”計算資源（計算コスト）の使い方を探している人（後で話します）

コア依存関係と環境

最小構成:

推奨 / 任意:

完全なプロジェクト構造ツリー

Agent-Reach/
├── pyproject.toml                # Python パッケージ定義
├── agent_reach/
│   ├── __init__.py               # バージョン番号
│   ├── cli.py                    # CLI エントリ（argparse）
│   ├── core.py                   # コア read/search ルーティング
│   ├── config.py                 # YAML 設定管理
│   ├── doctor.py                 # 診断エンジン
│   ├── cookie_extract.py         # Cookie 抽出ツール
│   ├── channels/                 # 各プラットフォームごとのファイル
│   │   ├── base.py               # BaseChannel 抽象クラス
│   │   ├── web.py                # Jina Reader
│   │   ├── twitter.py            # twitter-cli
│   │   ├── youtube.py            # yt-dlp
│   │   ├── github.py             # gh CLI
│   │   ├── bilibili.py           # yt-dlp + bili-cli
│   │   ├── reddit.py             # rdt-cli
│   │   ├── xiaohongshu.py        # xhs-cli
│   │   ├── douyin.py             # douyin-mcp-server
│   │   ├── linkedin.py           # linkedin-mcp
│   │   ├── wechat.py             # Exa + Camoufox
│   │   ├── rss.py                # feedparser
│   │   ├── exa_search.py         # Exa via mcporter
│   │   ├── weibo.py
│   │   ├── v2ex.py
│   │   ├── xueqiu.py
│   │   └── xiaoyuzhou.py
│   ├── integrations/
│   │   └── mcp_server.py         # MCP サーバー接続
│   ├── skill/                    # Agent 用の SKILL.md
│   ├── guides/                   # 利用ドキュメント（中/英/日/韓）
│   ├── scripts/                  # インストールスクリプト
│   └── utils/
├── config/
│   └── mcporter.json             # MCP ツール設定
├── tests/                        # pytest テスト
└── docs/                         # README 多言語版

ユーザーとして触る必要があるのは pip install / agent-reach install / agent-reach doctor の 3 コマンドだけです。channels/ は開発者が拡張するための場所です。

手順ステップ

手順 1: 基本インストール（メインルート）

# 推奨: pipx で隔離インストール
pipx install agent-reach

# または pip（注意: システムの Python に入れない）
python3 -m venv ~/.agent-reach-venv
source ~/.agent-reach-venv/bin/activate
pip install agent-reach

インストール後に次のコマンドが使えるはずです:

agent-reach --version
# agent-reach 1.4.0

手順 2: 上流ツールを一括インストール

# デフォルト: 環境を自動検出して全ての依存を導入
agent-reach install --env=auto

実行すると順番に:

1. システム依存（Node.js / gh CLI / mcporter / twitter-cli / rdt-cli など）をインストール
2. 検索エンジンを設定（Exa を MCP 経由で接続、Key不要）
3. ローカルかサーバーかを判断し、それぞれ別の案内を出す
4. Agent の skills/ ディレクトリに SKILL.md を登録

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

手順 3: チャネル状態の診断

agent-reach doctor

次のような結果が見えるはずです:

✅ web              Jina Reader OK
✅ youtube          yt-dlp 2025.10.x installed
✅ rss              feedparser 6.0.x
✅ exa_search       Exa MCP connected
✅ github           gh CLI 2.x authenticated
⚠️  twitter         twitter-cli not logged in  → run: twitter login
⚠️  reddit          rdt-cli not logged in       → run: rdt login
✅ bilibili         yt-dlp OK
⚠️  xiaohongshu     xhs-cli not logged in      → see step 4
✅ douyin           douyin-mcp-server OK
✅ wechat           Exa search OK
✅ v2ex             API OK

✅ はすぐ使える状態、⚠️ は追加設定が必要（通常は Cookie 認証）です。

手順 4: Cookie が必要なプラットフォームに認証を設定（重要）

Twitter / 小紅書 / Reddit の3つはログイン状態が必要で、QR 認証ではなく Cookie 認証で進めます。

まず Cookie-Editor を入れる: Chrome / Edge のアプリストアで **「Cookie-Editor」**を検索してインストール。

統一手順:

1. ブラウザで手動ログイン（x.com / xiaohongshu.com / reddit.com）
2. Cookie-Editor の拡張アイコン → 「Export」→「Netscape」形式を選択
3. 出力した Cookie 文字列を Agent に渡し、こう伝える: 「Twitter を設定して」
4. Agent が cookie_extract.py を使って保存し、~/.agent-reach/config.yaml に書き込む
5. ファイル権限 600、あなたのアカウントのみ読み取り可能にする

# 直接コマンドラインで設定することも可能（Agent 経由なし）
agent-reach config set twitter.cookie "$(pbpaste)"  # macOS
agent-reach config set xhs.cookie "$(xclip -o)"     # Linux

手順 5: Cookie 設定のプラットフォームを確認

agent-reach doctor

もう一度診断を実行すると、先ほど ⚠️ だったプラットフォームが ✅ になっているはずです。

手順 6: Agent に一度試させる

あなたの Agent（Claude Code / OpenClaw / Cursor）に次のように言います:

このツイートが何を言ってるか見て： https://x.com/vercel/status/1234567890

Agent は SKILL.md を読んだ後、自動で twitter tweet URL コマンドを呼び、数秒でツイート内容を返してくれます。

いくつか組み合わせてみましょう:

Reddit の r/LocalLLaMA で最近何が話題になってるか検索して
この YouTube 動画を見て： https://youtube.com/watch?v=xxx
小紅書で「キャンプ用品」について、バズっている投稿は何か見て
この GitHub リポジトリは何をしてるの？： https://github.com/xxx/yyy

ここでのポイント: Agent に「どのコマンドを叩け」と言う必要がありません。SKILL.md に「推特を読む = twitter CLI」「動画を見る = yt-dlp」といった対応関係がすでに書かれているからです。これが Agent Reach と一般的なツール集との最大の違い――セットアップ後、Agent は意識してツールを選択し、闇雲に試しません。

手順 7（任意）: 全ネットのセマンティック検索

デフォルトで Exa に接続済みなので、API Key は不要です。Agent に聞くだけ:

2026 年に最新の LLM Agent フレームワーク比較について、最も関連が深いものを 5 本まとめて

Agent は Exa の MCP ツールを呼び出し、結果を受け取ったら Jina Reader で本文を取得して、レポートに整理します。

手順 8（任意）: GitHub の非公開リポジトリへのアクセス

# 最初に一回ログイン
gh auth login

OAuth を完了すると、Agent はあなたのアカウント下の非公開リポジトリを読み取り、Issue、PR、review までできます。

手順 9（任意）: Bilibili / Douyin の強化

**Bilibili（ローカル）**は開けたらすぐ使えます。海外サーバーだとプロキシが必要（~$1/月、FluxNode などの住宅用プロキシを推奨）です:

# 例: あなたのプロキシが http://127.0.0.1:7890 のとき
agent-reach config set bilibili.proxy "http://127.0.0.1:7890"
agent-reach doctor  # もう一度診断

**Douyin（抖音）**はログイン不要で、共有リンクを Agent に渡すだけ:

この Douyin 動画を解析して： https://v.douyin.com/xxxxx

Agent は mcporter call 'douyin.parse_douyin_video_info(...)' を呼び、動画情報と無水印のダウンロードリンクを返します。

手順 10（任意）: セーフモード / アンインストール

セーフモード（本番サーバーや複数ユーザーのマシンで使用）:

# システムパッケージは自動で入れず、確認用に一覧だけ表示
agent-reach install --env=auto --safe

# または、何をするか先にプレビューして実行しない
agent-reach install --env=auto --dry-run

完全アンインストール:

agent-reach uninstall             # 設定＋skill ファイルを削除
agent-reach uninstall --keep-config  # トークンを保持し、再インストール時に使う
pip uninstall agent-reach         # Python パッケージを削除

よくある質問のトラブルシューティング

Q1: OpenClaw ユーザーでインストール時に「permission denied」/ Agent が動かない

原因: OpenClaw のデフォルト tools.profile = messaging では、Agent がシェルコマンドを実行できません。対処:

openclaw config set tools.profile "coding"
openclaw gateway restart
# 新しいセッションを開いてから「Agent Reach をインストールして」を送る

または ~/.openclaw/openclaw.json を変更:

{
  "tools": { "profile": "coding" }
}

Q2: 小紅書の QR ログインがずっとクルクル回る

QR は使わないでください。直接:

1. Chrome のアプリストアで Cookie-Editor を入れる
2. ブラウザで小紅書の Web 版にログイン
3. Cookie-Editor → Export → Netscape
4. 文字列を Agent に渡して「小紅書を設定して」と言う
5. 30 秒で完了

Q3: Reddit は呼び出すとすぐ 403 になる

Reddit は 2024 年以降、認証を強制するようになりました。対処:

# rdt-cli をインストール（Agent Reach install 段階で入っているはず）
pipx install rdt-cli

# まとめてログイン（Chrome の Cookie を自動で取得します）
rdt login

# 確認
rdt search "LocalLLaMA" --limit 5

Twitter / 小紅書と同じく、rdt login はブラウザ Cookie の自動抽出で進み、QR ではありません。

Q4: Bilibili の海外サーバーに接続できない

海外 IP は Bilibili にブロックされます。住宅用プロキシが必要です。選択肢は2つ:

# 方案 1: コマンドラインで設定（おすすめ: FluxNode などの安いプロキシ）
agent-reach config set bilibili.proxy "http://user:pass@proxy:port"

# 方案 2: 環境変数
export HTTP_PROXY="http://user:pass@proxy:port"
export HTTPS_PROXY="http://user:pass@proxy:port"

安い住宅用プロキシは ~$1/月で済むので、自分で構築する必要はありません。

Q5: agent-reach doctor が「channel not found」/ チャネルファイルの競合

通常、上流ツールの一部が失敗してインストールできているか、pipx ではなくシステム Python に入れてしまったことが原因です。一番きれいに直す方法は完全に作り直すこと:

agent-reach uninstall
pipx uninstall agent-reach
# 残骸があれば削除: ~/.agent-reach/
rm -rf ~/.agent-reach/

pipx install agent-reach
agent-reach install --env=auto
agent-reach doctor

Q6: ブラウザを変えた / Cookie が期限切れ

Cookie は数か月で期限切れになるので、改めて「ブラウザでログイン → Cookie-Editor でエクスポート → Agent に渡す」の流れをやり直すだけです。Agent は自動で ~/.agent-reach/config.yaml の古い Cookie を上書きします。

Q7（Bonus）: Agent が長時間タスクで請求が爆発する。どうやって見積もる？

僕が自分で Agent を運用していて踏んだ罠を話します。

Agent Reach は「Agent がどうやってネットにつながるか」を解決しますが、Agent がツール呼び出しを行う本質的なコストは、やはり LLM のトークン消費です。典型的な「競合をリサーチして要約する」タスクでは、検索・Web取得・X の読み取り・再検索・再読込など、5〜10 ラウンドのツール呼び出しが絡みます。1ラウンドで数十万トークンになって、1日に20回以上タスクを回すと、請求はすぐに爆発します。

実測での3つのつなぎ方（僕のデプロイ経験）:

1. Anthropic の公式 API に接続 ― 体験が一番完成度高い。ですが Claude Opus で Agent タスクを回して、1日で請求が4桁（人民元）になるのは普通
2. OpenRouter などの集約 API に接続 ― 公式より少し安いが、まだ高い
3. Defapi に接続 ― いまの僕の方針。公式価格の半額で、しかもプロトコル層が完全互換です。Agent Reach 側はそのまま、SKILL / prompt / ツール呼び出しコードを何も変えずに運用できます

具体設定（Agent が Claude / Anthropic プロトコルを使う想定）:

# ~/.openclaw/openclaw.json または Claude Code の env 設定
ANTHROPIC_BASE_URL=https://api.defapi.org
ANTHROPIC_API_KEY=sk-xxxxxx    # defapi.org の管理画面で取得

Defapi の各モデルは、基本的に 3 つの主要プロトコルに対応しています――v1/chat/completions（OpenAI）/ v1/messages（Anthropic）/ v1beta/models（Gemini）。モデルを切り替えるなら名前を変えるだけです。Agent が X の取得や小紅書分析、動画字幕の要約みたいな「ツール呼び出し密集型」タスクを回すと、毎月の請求が 4桁→3桁に下がるのは事実です。

関連リンク / 進歩の方向性

• カスタム channel: agent_reach/channels/ にファイルを追加し、BaseChannel を継承して can_handle(url) / read(url) / search(query) / check() の4メソッドを実装。あとは pip install -e . するだけ。ハードルは低く、1プラットフォームにつき1ファイル
• 上流ツールの置き換え: channels/web.py はデフォルトで Jina Reader を使っていますが、足りないと思ったら Firecrawl / Crawl4AI / 自作クローラでもOK。import を変えるだけで終わります
• SKILL.md の仕組み: Agent が Agent Reach を入れると、SKILL.md は自動で ~/.claude/skills/ / ~/.openclaw/skills/ に登録されます。自分で SKILL.md を書けば、特定の状況ではどの channel を優先して呼ぶかを Agent に教えられます
• mcporter で任意の MCP: Exa だけでなく、MCP 互換のサーバーなら config/mcporter.json を通して接続できます。対応する alias の起動コマンドを変えるだけ
• 複数 Agent で共有: Agent Reach の設定 ~/.agent-reach/config.yaml はファイル単位なので、同じマシンで複数の Agent（Claude Code + OpenClaw + Cursor）を同時に動かす場合に共有できます
• Defapi と連携: Agent Reach はデータ取得を担い、Defapi は推論を担当します。「情報取得層」と「計算コスト層」がプロトコル駆動でつながるので、組み合わせると「低コストの Agent 長時間タスクワークフロー」になります

GitHub リポジトリ: Panniantong/Agent-Reach、多言語ドキュメントは docs/README_en.md / docs/README_ja.md / docs/README_ko.md。設計思想は README 末尾の「設計理念」パートにあります。channel の PR を出すなら、そのまま貢献できます。作者の Neo Reid はメンテナンスがとても活発です。