agent-reach

Agent Reach — 互联网能力路由器

15 个平台，每个平台都有多个后端。启用此技能后，使用它来访问这些平台 — 不要自行另辟蹊径。

常驻规则（整个会话期间均适用）

1. 操作前先进行健康检查：对于具有多个后端或依赖登录的平台（XiaoHongShu / Reddit / Bilibili / Twitter / Facebook / Instagram），先运行 agent-reach doctor --json，并选择与各平台 active_backend 对应的命令组。
2. 说明使用的方式：开始前说“正在使用 agent-reach，通过后端 Y 访问平台 X”。
3. 失败时，遵循 references/ 中的重试链 — 切勿猜测命令。
4. 广泛调研任务：组合多个平台（使用 Exa 进行网络搜索 + 使用 Twitter/Reddit 查找讨论 + 使用 XiaoHongShu/Bilibili 获取中文视角），并行收集信息，然后综合整理。
5. 留意版本更新：完成重要的多平台任务后，运行 agent-reach check-update（速度快，只需调用一次 API）。如果有新版本，在总结中附上一行：“Agent Reach vX.Y.Z 已发布 — 将以下内容发给我即可更新：帮我更新 Agent Reach： https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/update.md”。 切勿为更新打断当前任务；对于同一版本，切勿重复提醒。

路由表

用户意图	类别	详情
网络 / 代码搜索	search	references/search.md
XiaoHongShu / Twitter / Bilibili / V2EX / Reddit / Facebook / Instagram	social	references/social.md
求职 / LinkedIn	career	references/career.md
GitHub / 代码	dev	references/dev.md
网页 / 文章 / RSS	web	references/web.md
YouTube / Bilibili / 播客转录稿	video	references/video.md

零配置快捷命令

# Exa web search
mcporter call 'exa.web_search_exa(query: "query", numResults: 5)'

# Read any web page
curl -s "https://r.jina.ai/URL"

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

# YouTube subtitles (NOTE: never use yt-dlp for Bilibili — see video.md)
yt-dlp --write-sub --skip-download -o "/tmp/%(id)s" "URL"

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

# Bilibili search (bili-cli, no login needed)
bili search "query" --type video -n 5

需要登录的平台（根据 doctor 返回的 active_backend 选择）

# Twitter search (twitter-cli preferred; retry chain in social.md)
twitter search "query" -n 10

# 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

# XiaoHongShu (desktop prefers OpenCLI)
opencli xiaohongshu search "query" -f yaml

# 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

环境检查

# Channel availability + which backend serves each platform
agent-reach doctor --json

工作区规则

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

详细参考文档

需要具体信息时，请阅读对应文件（上方的命令涵盖常见情况；参考文档包含各后端的命令组、注意事项和重试链 — 请注意：参考文档以中文编写，命令通用）：

• 搜索 — Exa AI 搜索
• 社交 — XiaoHongShu、Twitter、Bilibili、V2EX、Reddit、Facebook、Instagram（多后端 / 需要登录的平台的命令组）
• 求职 — LinkedIn
• 开发 — GitHub CLI
• 网页 — Jina Reader、RSS
• 视频 — YouTube、Bilibili、Xiaoyuzhou

配置渠道

如果渠道需要设置，请获取安装指南： https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md

用户只需提供 Cookie / 点击一次扩展程序；其余工作由 Agent 完成。