agent-reach

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Agent Reach — internet capability router

Agent Reach — 互联网能力路由器

15 platforms, multiple backends each. When this skill exists, use it for these platforms — do not invent your own approach.
支持 15 个平台,每个平台均有多个后端。当此 skill 存在时,针对这些平台应使用它——不要自创方案。

Standing rules (apply for the whole session)

常驻规则(适用于整个会话)

  1. Health-check before acting: for multi-backend/login-backed platforms (XiaoHongShu / Reddit / Bilibili / Twitter / Facebook / Instagram), run
    agent-reach doctor --json
    first and pick the command group matching each platform's
    active_backend
    .
  2. Announce what you use: say "using agent-reach, platform X via backend Y" before starting.
  3. On failure, follow the retry chains in references/ — never guess commands.
  4. For broad research tasks: combine platforms (Exa for web search + Twitter/Reddit for discussions + XiaoHongShu/Bilibili for Chinese perspectives), collect in parallel, then synthesize.
  5. Watch versions for the user: after finishing a substantial multi-platform task, run
    agent-reach check-update
    (fast, one API call). If a new version exists, append one line to your wrap-up: "Agent Reach vX.Y.Z is available — paste this to me to update: 帮我更新 Agent Reach: https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/update.md". Never interrupt the current task to update; never nag about the same version twice.
  1. 执行操作前进行健康检查:对于多后端/依赖登录的平台(XiaoHongShu / Reddit / Bilibili / Twitter / Facebook / Instagram),先运行
    agent-reach doctor --json
    ,然后根据每个平台的
    active_backend
    选择对应的命令组。
  2. 声明所使用的工具:开始前说明“using agent-reach, platform X via backend Y”。
  3. 失败时,遵循 references/ 中的重试链——绝不猜测命令。
  4. 对于广泛的调研任务:组合多个平台(使用 Exa 进行 Web 搜索 + 使用 Twitter/Reddit 获取讨论 + 使用 XiaoHongShu/Bilibili 获取中文观点),并行收集,然后进行综合分析。
  5. 为用户关注版本:完成实质性的多平台任务后,运行
    agent-reach check-update
    (快速,仅需一次 API 调用)。 如果有新版本,在总结末尾追加一行:“Agent Reach vX.Y.Z is available — paste this to me to update: 帮我更新 Agent Reach: https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/update.md”。 绝不要中断当前任务来更新;也不要就同一版本重复催促。

Routing table

路由表

User intentCategoryDetails
Web / code searchsearchreferences/search.md
XiaoHongShu / Twitter / Bilibili / V2EX / Reddit / Facebook / Instagramsocialreferences/social.md
Jobs / LinkedIncareerreferences/career.md
GitHub / codedevreferences/dev.md
Web pages / articles / RSSwebreferences/web.md
YouTube / Bilibili / podcast transcriptsvideoreferences/video.md
用户意图分类详情
Web / 代码搜索searchreferences/search.md
XiaoHongShu / Twitter / Bilibili / V2EX / Reddit / Facebook / Instagramsocialreferences/social.md
职位 / LinkedIncareerreferences/career.md
GitHub / 代码devreferences/dev.md
Web 页面 / 文章 / RSSwebreferences/web.md
YouTube / Bilibili / 播客文字稿videoreferences/video.md

Zero-config quick commands

零配置快捷命令

bash
undefined
bash
undefined

Exa web search

Exa web search

mcporter call 'exa.web_search_exa(query: "query", numResults: 5)'
mcporter call 'exa.web_search_exa(query: "query", numResults: 5)'

Read any web page

Read any web page

GitHub search

GitHub search

gh search repos "query" --sort stars --limit 10
gh search repos "query" --sort stars --limit 10

YouTube subtitles (NOTE: never use yt-dlp for Bilibili — see video.md)

YouTube subtitles (NOTE: never use yt-dlp for Bilibili — see video.md)

yt-dlp --write-sub --skip-download -o "/tmp/%(id)s" "URL"
yt-dlp --write-sub --skip-download -o "/tmp/%(id)s" "URL"

V2EX hot topics

V2EX hot topics

curl -s "https://www.v2ex.com/api/topics/hot.json" -H "User-Agent: agent-reach/1.0"
curl -s "https://www.v2ex.com/api/topics/hot.json" -H "User-Agent: agent-reach/1.0"

Bilibili search (bili-cli, no login needed)

Bilibili search (bili-cli, no login needed)

bili search "query" --type video -n 5
undefined
bili search "query" --type video -n 5
undefined

Login-backed platforms (pick by doctor's active_backend)

需要登录的平台(根据 doctor 的 active_backend 选择)

bash
undefined
bash
undefined

Twitter search (twitter-cli preferred; retry chain in social.md)

Twitter search (twitter-cli preferred; retry chain in social.md)

twitter search "query" -n 10
twitter search "query" -n 10

Reddit (NO zero-config path — OpenCLI or rdt-cli, login required)

Reddit (NO zero-config path — OpenCLI or rdt-cli, login required)

opencli reddit search "query" -f yaml # desktop rdt search "query" --limit 10 # legacy/server
opencli reddit search "query" -f yaml # desktop rdt search "query" --limit 10 # legacy/server

XiaoHongShu (desktop prefers OpenCLI)

XiaoHongShu (desktop prefers OpenCLI)

opencli xiaohongshu search "query" -f yaml
opencli xiaohongshu search "query" -f yaml

Facebook / Instagram (desktop OpenCLI, browser session)

Facebook / Instagram (desktop OpenCLI, browser session)

opencli facebook search "query" -f yaml opencli facebook groups -f yaml opencli instagram search "query" -f yaml # user search opencli instagram user USERNAME -f yaml # recent posts from one user
undefined
opencli facebook search "query" -f yaml opencli facebook groups -f yaml opencli instagram search "query" -f yaml # user search opencli instagram user USERNAME -f yaml # recent posts from one user
undefined

Environment check

环境检查

bash
undefined
bash
undefined

Channel availability + which backend serves each platform

Channel availability + which backend serves each platform

agent-reach doctor --json
undefined
agent-reach doctor --json
undefined

Workspace rules

工作区规则

Never create files in the agent workspace. Use
/tmp/
for temporary output and
~/.agent-reach/
for persistent data.
绝不要在 agent 工作区中创建文件。 使用
/tmp/
存放临时输出,使用
~/.agent-reach/
存放持久化数据。

Detailed references

详细参考

Read the matching file when you need specifics (commands above cover the common cases; references hold per-backend command groups, caveats, retry chains — note: reference docs are written in Chinese, commands are universal):
  • Search — Exa AI search
  • Social — XiaoHongShu, Twitter, Bilibili, V2EX, Reddit, Facebook, Instagram (multi-backend/login-backed groups)
  • Career — LinkedIn
  • Dev — GitHub CLI
  • Web — Jina Reader, RSS
  • Video — YouTube, Bilibili, Xiaoyuzhou
需要具体信息时,读取对应的文件(上述命令覆盖常见场景;references 中包含各后端的命令组、注意事项和重试链——注意:参考文档使用中文编写,命令通用):
  • 搜索 — Exa AI 搜索
  • 社交 — XiaoHongShu、Twitter、Bilibili、V2EX、Reddit、Facebook、Instagram(多后端/依赖登录分组)
  • 职业 — LinkedIn
  • 开发 — GitHub CLI
  • Web — Jina Reader、RSS
  • 视频 — YouTube、Bilibili、Xiaoyuzhou

Configure a channel

配置渠道

The user only provides cookies / one extension click; the agent does the rest.
如果某个渠道需要设置,请获取安装指南: https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md
用户只需提供 cookies / 点击一次扩展;其余操作由 agent 完成。