Agent Reach

将 Agent Reach 用作互联网能力路由工具。它可告知您当前可用的平台后端，以及应使用的命令族。实际分析工作仍由您自行负责。

既定规则

1. 在开展平台相关工作前，请先运行健康检查：

agent-reach doctor --json

若 agent-reach 未加入系统 PATH，请使用：

python -m agent_reach.cli doctor --json

2. 明确声明所使用的平台与后端，例如：using agent-reach, Bilibili via B站搜索 API。
3. 仅使用 status 为 ok 的通道；若状态为 warn，则须确认其限制不会阻碍所需的读取/搜索任务，方可使用。
4. 执行失败时，请查阅对应参考文件，切勿凭猜测构造命令。
5. 禁止执行发布、评论、点赞、关注、私信（DM）、表单提交等任何写入操作（write operations）。
6. 开展广泛调研时，应组合使用不同信息源角色：以 search/web 发现信息，以社交平台获取讨论观点，以视频平台查找教程，以 GitHub 捕捉开发者信号，以 RSS 获取更新动态。

路由表

常用命令

# 查看通道可用性及当前激活的后端
agent-reach doctor --json

# Exa 网页搜索（需已配置 mcporter/exa）
mcporter call 'exa.web_search_exa(query: "query", numResults: 5)'

# 通过 Jina Reader 读取公开网页
curl -s "https://r.jina.ai/URL"

# GitHub 公开搜索（需已安装并配置 gh CLI）
gh search repos "query" --sort stars --limit 10
gh search issues "query" --limit 20

# YouTube 元数据/字幕（需已安装 yt-dlp）
yt-dlp --dump-json "URL"
yt-dlp --write-sub --skip-download -o "%(id)s" "URL"

# Bilibili 搜索（需已安装 bili-cli）
bili search "query" --type video -n 10

# V2EX 公开热门话题
curl -s "https://www.v2ex.com/api/topics/hot.json" -H "User-Agent: agent-reach/1.0"

# 登录态平台（仅在完成配置后使用）
twitter search "query" -n 10
opencli reddit search "query" -f yaml
opencli xiaohongshu search "query" -f yaml
opencli douyin search "query" --limit 10 -f yaml

配置

若某通道需要前置配置，请参照安装指南：

https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md

如仅需诊断功能且不希望触发任何自动系统变更，请启用安全模式：

agent-reach install --env=auto --safe

依赖 Cookie 的平台应使用专用的低风险账号。Cookie 始终保留在本地，但平台方可能实施的风控措施风险依然存在。