Agent Reach — 使用指南

13+ 平台的上游工具。直接调用它们。

运行 agent-reach doctor 检查哪些通道可用。

⚠️ 工作区规则

切勿在 agent 工作区创建文件。 临时输出请使用 /tmp/，持久数据请使用 ~/.agent-reach/。

Web — 任意 URL

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

网页搜索 (Exa)

bash
mcporter call exa.websearchexa(query: 查询词, numResults: 5)
mcporter call exa.getcodecontext_exa(query: 代码问题, tokensNum: 3000)

Twitter/X (xreach)

bash
xreach search 查询词 -n 10 --json # 搜索
xreach tweet URLORID --json # 读取推文（支持 /status/ 和 /article/ 链接）
xreach tweets @用户名 -n 20 --json # 用户时间线
xreach thread URLORID --json # 完整线程

YouTube (yt-dlp)

bash
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:查询词 # 搜索

Bilibili (yt-dlp)

bash
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

bash
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=查询词&limit=10 -H User-Agent: agent-reach/1.0

服务器 IP 可能遇到 403 错误。请改用 Exa 搜索，或配置代理。

GitHub (gh CLI)

bash
gh search repos 查询词 --sort stars --limit 10
gh repo view 所有者/仓库
gh search code 查询词 --language python
gh issue list -R 所有者/仓库 --state open
gh issue view 123 -R 所有者/仓库

小红书 / XiaoHongShu (mcporter)

bash
mcporter call xiaohongshu.search_feeds(keyword: 查询词)
mcporter call xiaohongshu.getfeeddetail(feedid: xxx, xsectoken: yyy)
mcporter call xiaohongshu.getfeeddetail(feedid: xxx, xsectoken: yyy, loadallcomments: true)
mcporter call xiaohongshu.publish_content(title: 标题, content: 正文, images: [/路径/图片.jpg], tags: [标签])

需要登录。请使用 Cookie-Editor 导入 cookies。

抖音 / Douyin (mcporter)

bash
mcporter call douyin.parsedouyinvideoinfo(sharelink: https://v.douyin.com/xxx/)
mcporter call douyin.getdouyindownloadlink(sharelink: https://v.douyin.com/xxx/)

无需登录。

微信公众号 / WeChat Articles

搜索 (miku_ai):
python
python3 -c
import asyncio
from mikuai import getwexin_article
async def s():
for a in await getwexinarticle(查询词, 5):
print(f{a[\title\]} | {a[\url\]})
asyncio.run(s())

阅读 (Camoufox — 绕过微信反爬虫):
bash
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)

bash
mcporter call linkedin.getpersonprofile(linkedin_url: https://linkedin.com/in/用户名)
mcporter call linkedin.search_people(keyword: AI工程师, limit: 10)

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

RSS (feedparser)

RSS

python
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。其余工作由你完成。