Agent Reach — 使用指南

支持 13+ 个平台的上游工具，可直接调用。

运行 agent-reach doctor 查看当前可用的通道（channel）。

⚠️ 工作区规则

切勿在 agent workspace 中创建文件。 临时输出请使用 /tmp/，持久化数据请存入 ~/.agent-reach/。

网页 — 任意 URL

curl -s "https://r.jina.ai/URL"

网页搜索（Exa）

mcporter call 'exa.web_search_exa(query: "query", numResults: 5)'
mcporter call 'exa.get_code_context_exa(query: "code question", tokensNum: 3000)'

Twitter/X（xreach）

xreach search "query" -n 10 --json          # 搜索
xreach tweet URL_OR_ID --json                # 读取推文（支持 /status/ 和 /article/ 格式 URL）
xreach tweets @username -n 20 --json         # 用户时间线
xreach thread URL_OR_ID --json               # 完整转发链（thread）

YouTube（yt-dlp）

yt-dlp --dump-json "URL"                     # 视频元数据
yt-dlp --write-sub --write-auto-sub --sub-lang "zh-Hans,zh,en" --skip-download -o "/tmp/%(id)s" "URL"
                                             # 下载字幕，随后读取 .vtt 文件
yt-dlp --dump-json "ytsearch5:query"         # 搜索

Bilibili（yt-dlp）

yt-dlp --dump-json "https://www.bilibili.com/video/BVxxx"
yt-dlp --write-sub --write-auto-sub --sub-lang "zh-Hans,zh,en" --convert-subs vtt --skip-download -o "/tmp/%(id)s" "URL"

服务器 IP 可能返回 412 错误。建议使用 --cookies-from-browser chrome 或配置代理。

Reddit

curl -s "https://www.reddit.com/r/SUBREDDIT/hot.json?limit=10" -H "User-Agent: agent-reach/1.0"
curl -s "https://www.reddit.com/search.json?q=QUERY&limit=10" -H "User-Agent: agent-reach/1.0"

服务器 IP 可能返回 403 错误。推荐改用 Exa 进行搜索，或配置代理。

GitHub（gh CLI）

gh search repos "query" --sort stars --limit 10
gh repo view owner/repo
gh search code "query" --language python
gh issue list -R owner/repo --state open
gh issue view 123 -R owner/repo

小红书 / XiaoHongShu（mcporter）

mcporter call 'xiaohongshu.search_feeds(keyword: "query")'
mcporter call 'xiaohongshu.get_feed_detail(feed_id: "xxx", xsec_token: "yyy")'
mcporter call 'xiaohongshu.get_feed_detail(feed_id: "xxx", xsec_token: "yyy", load_all_comments: true)'
mcporter call 'xiaohongshu.publish_content(title: "标题", content: "正文", images: ["/path/img.jpg"], tags: ["tag"])'

需登录后使用。请通过 Cookie-Editor 导入 cookies。

抖音 / Douyin（mcporter）

mcporter call 'douyin.parse_douyin_video_info(share_link: "https://v.douyin.com/xxx/")'
mcporter call 'douyin.get_douyin_download_link(share_link: "https://v.douyin.com/xxx/")'

无需登录。

微信公众号 / WeChat Articles

搜索（miku_ai）：

python3 -c "
import asyncio
from miku_ai import get_wexin_article
async def s():
    for a in await get_wexin_article('query', 5):
        print(f'{a["title"]} | {a["url"]}')
asyncio.run(s())
"

阅读（Camoufox — 绕过微信反爬机制）：

cd ~/.agent-reach/tools/wechat-article-for-ai && python3 main.py "https://mp.weixin.qq.com/s/ARTICLE_ID"

微信公众号文章无法通过 Jina Reader 或 curl 正常读取，必须使用 Camoufox。

LinkedIn（mcporter）

mcporter call 'linkedin.get_person_profile(linkedin_url: "https://linkedin.com/in/username")'
mcporter call 'linkedin.search_people(keyword: "AI engineer", limit: 10)'

备用方案：curl -s "https://r.jina.ai/https://linkedin.com/in/username"

RSS（feedparser）

RSS

python3 -c "
import feedparser
for e in feedparser.parse('FEED_URL').entries[:5]:
    print(f'{e.title} — {e.link}')
"

故障排查

• 某个通道不可用？ 运行 agent-reach doctor — 将显示各通道状态及修复指引。
• Twitter 数据拉取失败？ 确保已全局安装 undici：npm install -g undici；并配置代理：agent-reach configure proxy URL。

配置通道（“帮我配 XXX”）

若某通道需额外配置（如 cookies、Docker 等），请获取安装指南： https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md

用户仅提供 cookies，其余所有配置均由你完成。