Agent Reach — 使用指南

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

运行 agent-reach doctor 检查可用渠道。

⚠️ 工作区规则

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

网页 — 任意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/ 格式URL）
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=QUERY&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: [/path/img.jpg], tags: [标签])

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

抖音 / 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/用户名

Boss直聘 (mcporter)

bash
mcporter call bosszhipin.getrecommendjobs_tool(page: 1)
mcporter call bosszhipin.searchjobstool(keyword: Python, city: 北京)

备用方案: curl -s https://r.jina.ai/https://www.zhipin.com/job_detail/xxx

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）

如果某个渠道需要配置（Cookie、Docker等），请获取安装指南：
https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md

用户仅提供Cookie，其余配置工作由你完成。