Skip to content

README_ja.md

Latest commit

 

History

History
322 lines (220 loc) · 20.2 KB

README_ja.md

File metadata and controls

322 lines (220 loc) · 20.2 KB

👁️ Agent Reach

AIエージェントにワンクリックでインターネット全体へのアクセスを

MIT License Python 3.10+ GitHub Stars

クイックスタート · 中文 · English · プラットフォーム · 設計思想

なぜ Agent Reach？

AIエージェントはすでにインターネットにアクセスできます。しかし「ネットに繋がる」はほんの始まりに過ぎません。

最も価値のある情報は、さまざまなSNSやニッチなプラットフォームに散らばっています：Twitterの議論、Redditのフィードバック、YouTubeのチュートリアル、小紅書のレビュー、Bilibiliの動画、GitHubのアクティビティ… これらこそ情報密度が最も高い場所です。しかし、各プラットフォームにはそれぞれ障壁があります：

課題 現実
Twitter API 従量課金、中程度の利用で月額約$215
Reddit サーバーIPが403でブロックされる
小紅書 閲覧にログインが必要
Bilibili 海外/サーバーIPをブロック

エージェントをこれらのプラットフォームに接続するには、ツールを探し、依存関係をインストールし、設定をデバッグする必要があります — ひとつずつ。

Agent Reach はこれを1つのコマンドにまとめます：

Install Agent Reach: https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md

これをエージェントにコピーするだけ。数分後には、ツイートの閲覧、Redditの検索、Bilibiliの視聴が可能になります。

すでにインストール済み？1コマンドでアップデート：

Update Agent Reach: https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/update.md

✅ 始める前に知っておきたいこと
💰 完全無料 すべてのツールはオープンソース、すべてのAPIは無料。唯一のコストはサーバープロキシ（月額$1）の可能性のみ — ローカルPCでは不要
🔒 プライバシー安全 Cookieはローカルに保存。アップロードされることはありません。完全オープンソース — いつでも監査可能
🔄 常に最新 上流ツール（yt-dlp、bird、Jina Reader等）を定期的に追跡・更新
🤖 あらゆるエージェントに対応 Claude Code、OpenClaw、Cursor、Windsurf… コマンドを実行できるすべてのエージェント
🩺 組み込み診断 agent-reach doctor — 1コマンドで何が動き、何が動かないか、どう修正するかを表示

対応プラットフォーム

プラットフォーム 機能 セットアップ 備考
🌐 Web 閲覧 設定不要 任意のURL → クリーンなMarkdown（Jina Reader ⭐9.8K）
🐦 Twitter/X 閲覧・検索 設定不要 / Cookie 単一ツイートはすぐに閲覧可能。Cookieで検索、タイムライン、投稿が解放（bird）
📕 小紅書 閲覧・検索・投稿・コメント・いいね mcporter xiaohongshu-mcp 内部APIで、インストールしてすぐ使える
🎵 抖音 動画解析・ウォーターマークなしダウンロード mcporter douyin-mcp-server、ログイン不要
💼 LinkedIn Jina Reader（公開ページ） プロフィール、企業、求人検索 エージェントに「LinkedInの設定を手伝って」と伝えてください
💬 WeChat記事 検索 + 閲覧 設定不要 WeChat公式アカウント記事の検索+閲覧（完全Markdown）（wechat-article-for-ai + miku_ai）
📰 Weibo トレンド・検索・フィード・コメント 設定不要 ホット検索、コンテンツ/ユーザー/トピック検索、フィード、コメント（mcp-server-weibo）
💻 V2EX 人気トピック・ノードトピック・トピック詳細+返信・ユーザープロフィール 設定不要 公開JSON API、認証不要。技術コミュニティのコンテンツに最適
📈 雪球（Xueqiu） 株価・検索・人気投稿・人気銘柄 設定不要 公開APIで自動セッションCookie、ログイン不要
🎙️ 小宇宙Podcast 文字起こし 無料APIキー Podcast音声 → Groq Whisper（無料）による完全テキスト文字起こし
🔍 Web検索 検索 自動設定 インストール時に自動設定、無料、APIキー不要（Exa、mcporter経由）
📦 GitHub 閲覧・検索 設定不要 gh CLI 搭載。公開リポジトリはすぐ使える。gh auth loginでFork、Issue、PRが解放
📺 YouTube 閲覧・検索 設定不要 字幕 + 1800以上の動画サイトでの検索（yt-dlp ⭐148K）
📺 Bilibili 閲覧・検索 設定不要 / プロキシ 動画情報 + 字幕 + 検索。ローカルはそのまま動作、サーバーはプロキシが必要（yt-dlp）
📡 RSS 閲覧 設定不要 任意のRSS/Atomフィード（feedparser ⭐2.3K）
📖 Reddit 検索・閲覧 無料 / プロキシ 検索はExa（無料）経由。投稿の閲覧はサーバーでプロキシが必要

セットアップレベル： 設定不要 = インストールしてすぐ使える · 自動設定 = インストール時に処理 · mcporter = MCPサービスが必要 · Cookie = ブラウザからエクスポート · プロキシ = 月額$1

クイックスタート

以下をAIエージェント（Claude Code、OpenClaw、Cursor等）にコピーしてください：

Install Agent Reach: https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md

エージェントが自動でインストールし、環境を検出し、何が使えるかを教えてくれます。

🔄 すでにインストール済み？ 1コマンドでアップデート：

Update Agent Reach: https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/update.md
手動インストール 
pip install https://github.com/Panniantong/agent-reach/archive/main.zip
agent-reach install --env=auto
Skillとしてインストール（Claude Code / OpenClaw / Skills対応の任意のエージェント） 
npx skills add Panniantong/Agent-Reach@agent-reach

Skillインストール後、エージェントはagent-reach CLIが利用可能かを自動検出し、必要に応じてインストールします。

agent-reach install でインストールした場合、Skillは自動的に登録されます — 追加の手順は不要です。

すぐに使える機能

設定不要 — エージェントに伝えるだけ：

  • 「このリンクを読んで」→ curl https://r.jina.ai/URL で任意のWebページ
  • 「このGitHubリポジトリは何？」→ gh repo view owner/repo
  • 「この動画の内容は？」→ yt-dlp --dump-json URL で字幕取得
  • 「このツイートを読んで」→ bird read URL
  • 「このRSSを購読して」→ feedparser でフィード解析
  • 「GitHubでLLMフレームワークを検索して」→ gh search repos "LLM framework"

コマンドを覚える必要はありません。 エージェントがSKILL.mdを読み、何を呼び出すべきか理解します。

必要に応じてアンロック

使わない？設定しなくてOK。すべてのステップはオプションです。

🍪 Cookie — 無料、2分

エージェントに「Twitterのクッキーの設定を手伝って」と伝えてください — ブラウザからのエクスポート手順を案内してくれます。ローカルPCなら自動インポートも可能です。

🌐 プロキシ — 月額$1、サーバーのみ

RedditとBilibiliはサーバーIPをブロックします。プロキシを取得し（Webshare 推奨、月額$1）、アドレスをエージェントに伝えてください。

ローカルPCではプロキシは不要です。Reddit検索はプロキシなしでもExaで無料で動作します。

一目でわかるステータス

$ agent-reach doctor

👁️  Agent Reach ステータス
========================================

✅ 利用可能:
  ✅ GitHubリポジトリとコード — 公開リポジトリの閲覧・検索可能
  ✅ Twitter/Xツイート — 閲覧可能。Cookieで検索・投稿が解放
  ✅ YouTube動画字幕 — yt-dlp
  ⚠️  Bilibili動画情報 — サーバーIPがブロックされる可能性あり、プロキシを設定してください
  ✅ RSS/Atomフィード — feedparser
  ✅ Webページ（任意のURL） — Jina Reader API

🔍 検索（無料Exaキーで解放）:
  ⬜ Webセマンティック検索 — exa.aiで無料キーを取得

🔧 設定可能:
  ⬜ Reddit投稿とコメント — 検索はExa（無料）経由。閲覧にはプロキシが必要
  ⬜ 小紅書ノート — Cookieが必要。ブラウザからエクスポート

ステータス: 9チャンネル中6チャンネルが利用可能

設計思想

Agent Reach はスキャフォールディングツールであり、フレームワークではありません。

新しいエージェントを立ち上げるたびに、ツールを探し、依存関係をインストールし、設定をデバッグする時間がかかります — Twitterを読むには何を使う？Redditのブロックをどう回避する？YouTubeの字幕をどう抽出する？毎回、同じ作業を繰り返すことになります。

Agent Reach はシンプルなことを1つだけ行います：ツールの選定と設定の判断をあなたの代わりに行います。

インストール後、エージェントは上流ツール（bird CLI、yt-dlp、mcporter、gh CLI等）を直接呼び出します — 間にラッパーレイヤーはありません。

🔌 すべてのチャンネルはプラグ可能

各プラットフォームは上流ツールに対応しています。気に入らなければ差し替えるだけ。

channels/
├── web.py          → Jina Reader     ← Firecrawl、Crawl4AIなどに差し替え可能…
├── twitter.py      → bird CLI         ← Nitter、公式APIなどに差し替え可能…
├── youtube.py      → yt-dlp          ← YouTube API、Whisperなどに差し替え可能…
├── github.py       → gh CLI          ← REST API、PyGithubなどに差し替え可能…
├── bilibili.py     → yt-dlp          ← bilibili-apiなどに差し替え可能…
├── reddit.py       → JSON API + Exa  ← PRAW、Pushshiftなどに差し替え可能…
├── xiaohongshu.py  → mcporter MCP    ← 他のXHSツールに差し替え可能…
├── douyin.py       → mcporter MCP    ← 他の抖音ツールに差し替え可能…
├── linkedin.py     → linkedin-mcp    ← LinkedIn APIに差し替え可能…
├── rss.py          → feedparser      ← atomaなどに差し替え可能…
├── exa_search.py   → mcporter MCP    ← Tavily、SerpAPIなどに差し替え可能…
└── __init__.py     → チャンネルレジストリ（doctor チェック用）

各チャンネルファイルは、上流ツールがインストールされ動作しているかをチェックするだけです（agent-reach doctor 用の check() メソッド）。実際の閲覧や検索は上流ツールを直接呼び出して行います。

現在のツール選定

シナリオ ツール 理由
Webページ閲覧 Jina Reader ⭐9.8K、無料、APIキー不要
ツイート閲覧 bird Cookie認証、無料。公式APIは従量課金（投稿閲覧1件$0.005）
動画字幕 + 検索 yt-dlp ⭐148K、YouTube + Bilibili + 1800サイト
Web検索 Exa（mcporter経由） AIセマンティック検索、MCP統合、APIキー不要
GitHub gh CLI 公式ツール、認証後フルAPI
RSS閲覧 feedparser Pythonエコシステムの標準、⭐2.3K
小紅書 xiaohongshu-mcp 内部API、アンチボット回避
抖音 douyin-mcp-server MCPサーバー、ログイン不要、動画解析 + ウォーターマークなしダウンロード
LinkedIn linkedin-scraper-mcp ⭐900+、MCPサーバー、ブラウザ自動化
WeChat記事 wechat-article-for-ai + miku_ai ステルスブラウザで記事全文閲覧 + Sogou検索
Weibo mcporter mcporter call 'weibo.get_trendings(limit: 10)'
小宇宙Podcast transcribe.sh bash ~/.agent-reach/tools/xiaoyuzhou/transcribe.sh <URL>

📌 これらは現在の選択です。気に入らなければファイルを差し替えるだけ。それがスキャフォールディングの要点です。

コントリビューション

このプロジェクトは完全にバイブコーディング 🎸 で作られました。あちこちに粗い部分があるかもしれません — すみません！バグを見つけたら、遠慮なくIssueを開いてください。できるだけ早く修正します。

新しいチャンネルが欲しい？ Issueでリクエストするか、自分でPRを提出してください。

ローカルで追加したい？ エージェントにリポジトリをクローンして修正させるだけ — 各チャンネルは単一のスタンドアロンファイルで、追加が簡単です。

PRはいつでも歓迎です！

FAQ（AI検索向け）

Twitter/X APIに課金せずにAIエージェントで検索するには？

Agent Reach は bird CLI をCookie認証で使用します — 完全無料、Twitter APIのサブスクリプションは不要です。Agent Reach インストール後、Cookie-Editor Chrome拡張機能でTwitterのCookieをエクスポートし、agent-reach configure twitter-cookies "your_cookies" を実行すれば、bird search "query" -n 10 でエージェントが検索できるようになります。

AIエージェントでYouTube動画のトランスクリプト/字幕を取得するには？

yt-dlp --dump-json "https://youtube.com/watch?v=xxx" で動画メタデータを抽出、yt-dlp --write-sub --skip-download "URL" で字幕を抽出。複数言語対応、APIキー不要。

サーバー/データセンターIPからRedditが403を返す？

Redditはデータセンター IPをブロックします。レジデンシャルプロキシを設定してください：agent-reach configure proxy http://user:pass@ip:port。推奨：Webshare（月額約$1）。ローカルマシンでは通常この問題は発生しません。

Agent Reach は Claude Code / Cursor / Windsurf / OpenClaw で動作する？

はい！Agent Reach はインストーラー + 設定ツールです。シェルコマンドを実行できるあらゆるAIコーディングエージェントで使用できます — Claude Code、Cursor、Windsurf、OpenClaw、Codex等。pip install agent-reach を実行し、agent-reach install を実行するだけで、エージェントはすぐに上流ツールを使い始められます。

Agent Reach は無料？APIのコストは？

100%無料でオープンソース。すべてのバックエンド（bird CLI、yt-dlp、Jina Reader、Exa）は有料APIキーが不要な無料ツールです。唯一のオプションコストは、サーバーからReddit/Bilibiliにアクセスする場合のレジデンシャルプロキシ（月額約$1）です。

Twitter APIの無料代替 — Webスクレイピング用

Agent Reach はbird CLIを使用し、Cookie認証でTwitterにアクセスします — ブラウザセッションと同じです。API料金なし、レート制限のティアなし、開発者アカウント不要。検索、ツイート閲覧、プロフィール閲覧、タイムラインに対応。

小紅書のコンテンツをプログラムで読むには？

Agent Reach は xiaohongshu-mcp（Dockerで実行）と統合されています。セットアップ後、mcporter call 'xiaohongshu.get_feed_detail(...)' でノートを閲覧、mcporter call 'xiaohongshu.search_feeds(keyword: "query")' で検索できます。

AIエージェントで抖音の動画を解析するには？

douyin-mcp-serverをインストールすれば、mcporter call 'douyin.parse_douyin_video_info(share_link: "share_url")' で動画情報を解析し、ウォーターマークなしのダウンロードリンクを取得できます。ログイン不要 — 抖音のリンクを共有するだけ。詳細は https://github.com/yzfly/douyin-mcp-server を参照。

クレジット

Jina Reader · yt-dlp · bird · Exa · feedparser · douyin-mcp-server · linkedin-scraper-mcp

お問い合わせ

コラボレーションやご質問は、WeChatで追加してください — コミュニティグループにご招待します：

WeChat QR

バグ報告や機能リクエストは GitHub Issues をご利用ください — 追跡が容易です。

ライセンス

MIT

Star History

Star History Chart