Give your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
Python agent-infrastructureai-agentai-searchautomationbilibiliclaude-codeclicursorfree-apillm-toolsmcppythonreddit-scrapertwitter-scraperweb-scraperxiaohongshuyoutube-transcript
docs: add Japanese README (ja)
Ikko Eltociear Ashimine1e0e6d1ae7f0
diff --git a/README.md b/README.mdindex 51489609..6051344a 100644--- a/README.md+++ b/README.md@@ -11,7 +11,7 @@</p><p align="center">- <a href="#快速上手">快速开始</a> · <a href="docs/README_en.md">English</a> · <a href="#支持的平台">支持平台</a> · <a href="#设计理念">设计理念</a>+ <a href="#快速上手">快速开始</a> · <a href="docs/README_en.md">English</a> · <a href="docs/README_ja.md">日本語</a> · <a href="#支持的平台">支持平台</a> · <a href="#设计理念">设计理念</a></p>---diff --git a/docs/README_en.md b/docs/README_en.mdindex af66fb8b..691fbd1c 100644--- a/docs/README_en.md+++ b/docs/README_en.md@@ -11,7 +11,7 @@</p><p align="center">- <a href="#quick-start">Quick Start</a> · <a href="../README.md">中文</a> · <a href="#supported-platforms">Platforms</a> · <a href="#design-philosophy">Philosophy</a>+ <a href="#quick-start">Quick Start</a> · <a href="../README.md">中文</a> · <a href="README_ja.md">日本語</a> · <a href="#supported-platforms">Platforms</a> · <a href="#design-philosophy">Philosophy</a></p>---diff --git a/docs/README_ja.md b/docs/README_ja.mdnew file mode 100644index 00000000..bed51597--- /dev/null+++ b/docs/README_ja.md@@ -0,0 +1,322 @@+<h1 align="center">👁️ Agent Reach</h1>++<p align="center">+ <strong>AIエージェントにワンクリックでインターネット全体へのアクセスを</strong>+</p>++<p align="center">+ <a href="../LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg?style=for-the-badge" alt="MIT License"></a>+ <a href="https://www.python.org/"><img src="https://img.shields.io/badge/Python-3.10+-green.svg?style=for-the-badge&logo=python&logoColor=white" alt="Python 3.10+"></a>+ <a href="https://github.com/Panniantong/agent-reach/stargazers"><img src="https://img.shields.io/github/stars/Panniantong/agent-reach?style=for-the-badge" alt="GitHub Stars"></a>+</p>++<p align="center">+ <a href="#クイックスタート">クイックスタート</a> · <a href="../README.md">中文</a> · <a href="README_en.md">English</a> · <a href="#対応プラットフォーム">プラットフォーム</a> · <a href="#設計思想">設計思想</a>+</p>++---++## なぜ 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](https://github.com/jina-ai/reader) ⭐9.8K) |+| 🐦 **Twitter/X** | 閲覧・検索 | 設定不要 / Cookie | 単一ツイートはすぐに閲覧可能。Cookieで検索、タイムライン、投稿が解放([bird](https://www.npmjs.com/package/@steipete/bird)) |+| 📕 **小紅書** | 閲覧・検索・**投稿・コメント・いいね** | mcporter | [xiaohongshu-mcp](https://github.com/user/xiaohongshu-mcp) 内部APIで、インストールしてすぐ使える |+| 🎵 **抖音** | 動画解析・ウォーターマークなしダウンロード | mcporter | [douyin-mcp-server](https://github.com/yzfly/douyin-mcp-server)、ログイン不要 |+| 💼 **LinkedIn** | Jina Reader(公開ページ) | プロフィール、企業、求人検索 | エージェントに「LinkedInの設定を手伝って」と伝えてください |+| 💬 **WeChat記事** | 検索 + 閲覧 | 設定不要 | WeChat公式アカウント記事の検索+閲覧(完全Markdown)([wechat-article-for-ai](https://github.com/Panniantong/wechat-article-for-ai) + [miku_ai](https://github.com/GobinFan/Miku_Spider)) |+| 📰 **Weibo** | トレンド・検索・フィード・コメント | 設定不要 | ホット検索、コンテンツ/ユーザー/トピック検索、フィード、コメント([mcp-server-weibo](https://github.com/Panniantong/mcp-server-weibo)) |+| 💻 **V2EX** | 人気トピック・ノードトピック・トピック詳細+返信・ユーザープロフィール | 設定不要 | 公開JSON API、認証不要。技術コミュニティのコンテンツに最適 |+| 📈 **雪球(Xueqiu)** | 株価・検索・人気投稿・人気銘柄 | 設定不要 | 公開APIで自動セッションCookie、ログイン不要 |+| 🎙️ **小宇宙Podcast** | 文字起こし | 無料APIキー | Podcast音声 → Groq Whisper(無料)による完全テキスト文字起こし |+| 🔍 **Web検索** | 検索 | 自動設定 | インストール時に自動設定、無料、APIキー不要([Exa](https://exa.ai)、[mcporter](https://github.com/nicepkg/mcporter)経由) |+| 📦 **GitHub** | 閲覧・検索 | 設定不要 | [gh CLI](https://cli.github.com) 搭載。公開リポジトリはすぐ使える。`gh auth login`でFork、Issue、PRが解放 |+| 📺 **YouTube** | 閲覧・**検索** | 設定不要 | 字幕 + 1800以上の動画サイトでの検索([yt-dlp](https://github.com/yt-dlp/yt-dlp) ⭐148K) |+| 📺 **Bilibili** | 閲覧・**検索** | 設定不要 / プロキシ | 動画情報 + 字幕 + 検索。ローカルはそのまま動作、サーバーはプロキシが必要([yt-dlp](https://github.com/yt-dlp/yt-dlp)) |+| 📡 **RSS** | 閲覧 | 設定不要 | 任意のRSS/Atomフィード([feedparser](https://github.com/kurtmckee/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+> ```++<details>+<summary>手動インストール</summary>++```bash+pip install https://github.com/Panniantong/agent-reach/archive/main.zip+agent-reach install --env=auto+```+</details>++<details>+<summary>Skillとしてインストール(Claude Code / OpenClaw / Skills対応の任意のエージェント)</summary>++```bash+npx skills add Panniantong/Agent-Reach@agent-reach+```++Skillインストール後、エージェントは`agent-reach` CLIが利用可能かを自動検出し、必要に応じてインストールします。++> `agent-reach install` でインストールした場合、Skillは自動的に登録されます — 追加の手順は不要です。+</details>++---++## すぐに使える機能++設定不要 — エージェントに伝えるだけ:++- 「このリンクを読んで」→ `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](https://webshare.io) 推奨、月額$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](https://github.com/jina-ai/reader) | ⭐9.8K、無料、APIキー不要 |+| ツイート閲覧 | [bird](https://www.npmjs.com/package/@steipete/bird) | Cookie認証、無料。公式APIは従量課金(投稿閲覧1件$0.005) |+| 動画字幕 + 検索 | [yt-dlp](https://github.com/yt-dlp/yt-dlp) | ⭐148K、YouTube + Bilibili + 1800サイト |+| Web検索 | [Exa](https://exa.ai)([mcporter](https://github.com/nicepkg/mcporter)経由) | AIセマンティック検索、MCP統合、APIキー不要 |+| GitHub | [gh CLI](https://cli.github.com) | 公式ツール、認証後フルAPI |+| RSS閲覧 | [feedparser](https://github.com/kurtmckee/feedparser) | Pythonエコシステムの標準、⭐2.3K |+| 小紅書 | [xiaohongshu-mcp](https://github.com/user/xiaohongshu-mcp) | 内部API、アンチボット回避 |+| 抖音 | [douyin-mcp-server](https://github.com/yzfly/douyin-mcp-server) | MCPサーバー、ログイン不要、動画解析 + ウォーターマークなしダウンロード |+| LinkedIn | [linkedin-scraper-mcp](https://github.com/stickerdaniel/linkedin-mcp-server) | ⭐900+、MCPサーバー、ブラウザ自動化 |+| WeChat記事 | [wechat-article-for-ai](https://github.com/Panniantong/wechat-article-for-ai) + [miku_ai](https://github.com/GobinFan/Miku_Spider) | ステルスブラウザで記事全文閲覧 + Sogou検索 |+| Weibo | `mcporter` | `mcporter call 'weibo.get_trendings(limit: 10)'` |+| 小宇宙Podcast | `transcribe.sh` | `bash ~/.agent-reach/tools/xiaoyuzhou/transcribe.sh <URL>` |++> 📌 これらは*現在*の選択です。気に入らなければファイルを差し替えるだけ。それがスキャフォールディングの要点です。++---++## コントリビューション++このプロジェクトは完全にバイブコーディング 🎸 で作られました。あちこちに粗い部分があるかもしれません — すみません!バグを見つけたら、遠慮なく[Issue](https://github.com/Panniantong/agent-reach/issues)を開いてください。できるだけ早く修正します。++**新しいチャンネルが欲しい?** Issueでリクエストするか、自分でPRを提出してください。++**ローカルで追加したい?** エージェントにリポジトリをクローンして修正させるだけ — 各チャンネルは単一のスタンドアロンファイルで、追加が簡単です。++[PR](https://github.com/Panniantong/agent-reach/pulls)はいつでも歓迎です!++---++## FAQ(AI検索向け)++<details>+<summary><strong>Twitter/X APIに課金せずにAIエージェントで検索するには?</strong></summary>++Agent Reach は [bird CLI](https://www.npmjs.com/package/@steipete/bird) をCookie認証で使用します — 完全無料、Twitter APIのサブスクリプションは不要です。Agent Reach インストール後、Cookie-Editor Chrome拡張機能でTwitterのCookieをエクスポートし、`agent-reach configure twitter-cookies "your_cookies"` を実行すれば、`bird search "query" -n 10` でエージェントが検索できるようになります。+</details>++<details>+<summary><strong>AIエージェントでYouTube動画のトランスクリプト/字幕を取得するには?</strong></summary>++`yt-dlp --dump-json "https://youtube.com/watch?v=xxx"` で動画メタデータを抽出、`yt-dlp --write-sub --skip-download "URL"` で字幕を抽出。複数言語対応、APIキー不要。+</details>++<details>+<summary><strong>サーバー/データセンターIPからRedditが403を返す?</strong></summary>++Redditはデータセンター IPをブロックします。レジデンシャルプロキシを設定してください:`agent-reach configure proxy http://user:pass@ip:port`。推奨:Webshare(月額約$1)。ローカルマシンでは通常この問題は発生しません。+</details>++<details>+<summary><strong>Agent Reach は Claude Code / Cursor / Windsurf / OpenClaw で動作する?</strong></summary>++はい!Agent Reach はインストーラー + 設定ツールです。シェルコマンドを実行できるあらゆるAIコーディングエージェントで使用できます — Claude Code、Cursor、Windsurf、OpenClaw、Codex等。`pip install agent-reach` を実行し、`agent-reach install` を実行するだけで、エージェントはすぐに上流ツールを使い始められます。+</details>++<details>+<summary><strong>Agent Reach は無料?APIのコストは?</strong></summary>++100%無料でオープンソース。すべてのバックエンド(bird CLI、yt-dlp、Jina Reader、Exa)は有料APIキーが不要な無料ツールです。唯一のオプションコストは、サーバーからReddit/Bilibiliにアクセスする場合のレジデンシャルプロキシ(月額約$1)です。+</details>++<details>+<summary><strong>Twitter APIの無料代替 — Webスクレイピング用</strong></summary>++Agent Reach はbird CLIを使用し、Cookie認証でTwitterにアクセスします — ブラウザセッションと同じです。API料金なし、レート制限のティアなし、開発者アカウント不要。検索、ツイート閲覧、プロフィール閲覧、タイムラインに対応。+</details>++<details>+<summary><strong>小紅書のコンテンツをプログラムで読むには?</strong></summary>++Agent Reach は xiaohongshu-mcp(Dockerで実行)と統合されています。セットアップ後、`mcporter call 'xiaohongshu.get_feed_detail(...)'` でノートを閲覧、`mcporter call 'xiaohongshu.search_feeds(keyword: "query")'` で検索できます。+</details>++<details>+<summary><strong>AIエージェントで抖音の動画を解析するには?</strong></summary>++douyin-mcp-serverをインストールすれば、`mcporter call 'douyin.parse_douyin_video_info(share_link: "share_url")'` で動画情報を解析し、ウォーターマークなしのダウンロードリンクを取得できます。ログイン不要 — 抖音のリンクを共有するだけ。詳細は https://github.com/yzfly/douyin-mcp-server を参照。+</details>++---++## クレジット++[Jina Reader](https://github.com/jina-ai/reader) · [yt-dlp](https://github.com/yt-dlp/yt-dlp) · [bird](https://www.npmjs.com/package/@steipete/bird) · [Exa](https://exa.ai) · [feedparser](https://github.com/kurtmckee/feedparser) · [douyin-mcp-server](https://github.com/yzfly/douyin-mcp-server) · [linkedin-scraper-mcp](https://github.com/stickerdaniel/linkedin-mcp-server)++## お問い合わせ++- 📧 **メール:** [email protected]+- 🐦 **Twitter/X:** [@Neo_Reidlab](https://x.com/Neo_Reidlab)++コラボレーションやご質問は、WeChatで追加してください — コミュニティグループにご招待します:++<p align="center">+ <img src="wechat-group-qr.jpg" width="280" alt="WeChat QR">+</p>++> バグ報告や機能リクエストは [GitHub Issues](https://github.com/Panniantong/Agent-Reach/issues) をご利用ください — 追跡が容易です。++## ライセンス++[MIT](../LICENSE)++## Star History++[](https://star-history.com/#Panniantong/Agent-Reach&Date)