\r \r

Agent Reach — Usage Guide\r

\r Upstream tools for 13+ platforms. Call them directly.\r \r Run agent-reach doctor to check which channels are available.\r \r

⚠️ Workspace Rules\r

\r Never create files in the agent workspace. Use /tmp/ for temporary output and ~/.agent-reach/ for persistent data.\r \r

Web — Any URL\r

\r

curl -s "https://r.jina.ai/URL"\r
```\r
\r
## Web Search (Exa)\r
\r
```bash\r
mcporter call 'exa.web_search_exa(query: "query", numResults: 5)'\r
mcporter call 'exa.get_code_context_exa(query: "code question", tokensNum: 3000)'\r
```\r
\r
## Twitter/X (xreach)\r
\r
```bash\r
xreach search "query" -n 10 --json          # search\r
xreach tweet URL_OR_ID --json                # read tweet (supports /status/ and /article/ URLs)\r
xreach tweets @username -n 20 --json         # user timeline\r
xreach thread URL_OR_ID --json               # full thread\r
```\r
\r
## YouTube (yt-dlp)\r
\r
```bash\r
yt-dlp --dump-json "URL"                     # video metadata\r
yt-dlp --write-sub --write-auto-sub --sub-lang "zh-Hans,zh,en" --skip-download -o "/tmp/%(id)s" "URL"\r
                                             # download subtitles, then read the .vtt file\r
yt-dlp --dump-json "ytsearch5:query"         # search\r
```\r
\r
## Bilibili (yt-dlp)\r
\r
```bash\r
yt-dlp --dump-json "https://www.bilibili.com/video/BVxxx"\r
yt-dlp --write-sub --write-auto-sub --sub-lang "zh-Hans,zh,en" --convert-subs vtt --skip-download -o "/tmp/%(id)s" "URL"\r
```\r
\r
> Server IPs may get 412. Use `--cookies-from-browser chrome` or configure proxy.\r
\r
## Reddit\r
\r
```bash\r
curl -s "https://www.reddit.com/r/SUBREDDIT/hot.json?limit=10" -H "User-Agent: agent-reach/1.0"\r
curl -s "https://www.reddit.com/search.json?q=QUERY&limit=10" -H "User-Agent: agent-reach/1.0"\r
```\r
\r
> Server IPs may get 403. Search via Exa instead, or configure proxy.\r
\r
## GitHub (gh CLI)\r
\r
```bash\r
gh search repos "query" --sort stars --limit 10\r
gh repo view owner/repo\r
gh search code "query" --language python\r
gh issue list -R owner/repo --state open\r
gh issue view 123 -R owner/repo\r
```\r
\r
## 小红书 / XiaoHongShu (mcporter)\r
\r
```bash\r
mcporter call 'xiaohongshu.search_feeds(keyword: "query")'\r
mcporter call 'xiaohongshu.get_feed_detail(feed_id: "xxx", xsec_token: "yyy")'\r
mcporter call 'xiaohongshu.get_feed_detail(feed_id: "xxx", xsec_token: "yyy", load_all_comments: true)'\r
mcporter call 'xiaohongshu.publish_content(title: "标题", content: "正文", images: ["/path/img.jpg"], tags: ["tag"])'\r
```\r
\r
> Requires login. Use Cookie-Editor to import cookies.\r
\r
## 抖音 / Douyin (mcporter)\r
\r
```bash\r
mcporter call 'douyin.parse_douyin_video_info(share_link: "https://v.douyin.com/xxx/")'\r
mcporter call 'douyin.get_douyin_download_link(share_link: "https://v.douyin.com/xxx/")'\r
```\r
\r
> No login needed.\r
\r
## 微信公众号 / WeChat Articles\r
\r
**Search** (miku_ai):\r
```python\r
python3 -c "\r
import asyncio\r
from miku_ai import get_wexin_article\r
async def s():\r
    for a in await get_wexin_article('query', 5):\r
        print(f'{a[\"title\"]} | {a[\"url\"]}')\r
asyncio.run(s())\r
"\r
```\r
\r
**Read** (Camoufox — bypasses WeChat anti-bot):\r
```bash\r
cd ~/.agent-reach/tools/wechat-article-for-ai && python3 main.py "https://mp.weixin.qq.com/s/ARTICLE_ID"\r
```\r
\r
> WeChat articles cannot be read with Jina Reader or curl. Must use Camoufox.\r
\r
## LinkedIn (mcporter)\r
\r
```bash\r
mcporter call 'linkedin.get_person_profile(linkedin_url: "https://linkedin.com/in/username")'\r
mcporter call 'linkedin.search_people(keyword: "AI engineer", limit: 10)'\r
```\r
\r
Fallback: `curl -s "https://r.jina.ai/https://linkedin.com/in/username"`\r
\r
## Boss直聘 (mcporter)\r
\r
```bash\r
mcporter call 'bosszhipin.get_recommend_jobs_tool(page: 1)'\r
mcporter call 'bosszhipin.search_jobs_tool(keyword: "Python", city: "北京")'\r
```\r
\r
Fallback: `curl -s "https://r.jina.ai/https://www.zhipin.com/job_detail/xxx"`\r
\r
## RSS\r
\r
```python\r
python3 -c "\r
import feedparser\r
for e in feedparser.parse('FEED_URL').entries[:5]:\r
    print(f'{e.title} — {e.link}')\r
"\r
```\r
\r
## Troubleshooting\r
\r
- **Channel not working?** Run `agent-reach doctor` — shows status and fix instructions.\r
- **Twitter fetch failed?** Ensure `undici` is installed: `npm install -g undici`. Configure proxy: `agent-reach configure proxy URL`.\r
\r
## Setting Up a Channel ("帮我配 XXX")\r
\r
If a channel needs setup (cookies, Docker, etc.), fetch the install guide:\r
https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md\r
\r
User only provides cookies. Everything else is your job.\r