mcpField
A
agent-reach

agent-reach

github.com/jichi666生产力5162 次安装34 周前更新
代码仓库

关于 agent-reach

为 Agent 提供跨 13 个以上平台使用上游工具的操作指南,涵盖网页、社交媒体、视频、代码托管和招聘等渠道。还说明渠道状态检查、配置入口及访问失败时的处理方式。

主要功能

  1. 01涵盖 13 个以上平台的工具用法
  2. 02搜索和读取网页及社交内容
  3. 03获取视频信息与字幕
  4. 04查询 GitHub 仓库和问题
  5. 05检查渠道状态并提供配置指引

适用场景

  1. 01跨平台检索资料和社交内容
  2. 02查找视频并获取字幕
  3. 03浏览 GitHub 代码、仓库与问题
  4. 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 或配置代理。

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 导入 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。其他工作都由你完成。

评论

支持 Markdown