关于 agent-reach
为 Agent 提供跨 13 个以上平台使用上游工具的操作指南,涵盖网页、社交媒体、视频、代码托管和招聘等渠道。还说明渠道状态检查、配置入口及访问失败时的处理方式。
主要功能
- 01涵盖 13 个以上平台的工具用法
- 02搜索和读取网页及社交内容
- 03获取视频信息与字幕
- 04查询 GitHub 仓库和问题
- 05检查渠道状态并提供配置指引
适用场景
- 01跨平台检索资料和社交内容
- 02查找视频并获取字幕
- 03浏览 GitHub 代码、仓库与问题
- 04检查并配置不可用的内容渠道
MCP 相关
指南展示通过 mcporter 调用 Exa、小红书、抖音、LinkedIn 和 Boss直聘等工具;也列出若干其他渠道的命令行或 Python 用法。
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ jichi666/ agent-reach-skill --skill agent-reach安装后在 Claude Code 中输入/agent-reach确认已加载。
详细介绍
Agent Reach — 使用指南
支持 13+ 个平台的上游工具。直接调用即可。
运行 agent-reach doctor,检查哪些渠道可用。
⚠️ 工作区规则
切勿在 Agent 工作区中创建文件。 临时输出请使用 /tmp/,持久化数据请使用 ~/.agent-reach/。
Web — 任意 URL
curl -s "https://r.jina.ai/URL"
Web 搜索(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 # search
xreach tweet URL_OR_ID --json # read tweet (supports /status/ and /article/ URLs)
xreach tweets @username -n 20 --json # user timeline
xreach thread URL_OR_ID --json # full thread
YouTube(yt-dlp)
yt-dlp --dump-json "URL" # video metadata
yt-dlp --write-sub --write-auto-sub --sub-lang "zh-Hans,zh,en" --skip-download -o "/tmp/%(id)s" "URL"
# download subtitles, then read the .vtt file
yt-dlp --dump-json "ytsearch5:query" # search
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或配置代理。
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 导入 Cookie。
抖音 / 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/")'
无需登录。
微信公众号 / 微信文章
搜索(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"
Boss直聘(mcporter)
mcporter call 'bosszhipin.get_recommend_jobs_tool(page: 1)'
mcporter call 'bosszhipin.search_jobs_tool(keyword: "Python", city: "北京")'
备用方案:curl -s "https://r.jina.ai/https://www.zhipin.com/job_detail/xxx"
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”)
如果渠道需要设置(Cookie、Docker 等),请获取安装指南: https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md
用户只需提供 Cookie。其他工作都由你完成。