Agent Reach 是一个让 AI 智能体获得“眼睛”以读取和搜索整个互联网的统一 CLI 工具,覆盖 Twitter/X、Reddit、YouTube、GitHub、Bilibili、小红书、RSS 以及任意网页等 9 个以上平台。
用途 Agent Reach 面向需要让 AI 智能体访问和检索多平台内容的场景,通过单一命令行入口统一处理不同平台的读取与搜索,避免为每个平台单独接入。
安装与初始化 首先检查是否已安装: agent-reach doctor
如果命令未找到,则安装: pip install https://github.com/Panniantong/agent-reach/archive/main.zip agent-reach install --env=auto
install 会自动检测环境并安装所有依赖(Node.js、mcporter、bird CLI、gh CLI)。安装后阅读输出并运行 agent-reach doctor 查看哪些频道已激活。 对于需要用户输入的频道,需要向用户询问。完整设置指南见:https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md
主要能力 读取任意 URL: agent-reach read <url> agent-reach read <url> --json # 结构化输出 可处理推文、Reddit 帖子、文章、YouTube(转写文本)、GitHub 仓库等。
搜索: agent-reach search "query" # 网页搜索(Exa) agent-reach search-twitter "query" # Twitter/X agent-reach search-reddit "query" # Reddit(--sub <subreddit>) agent-reach search-github "query" # GitHub(--lang <language>) agent-reach search-youtube "query" # YouTube agent-reach search-bilibili "query" # Bilibili(B站) agent-reach search-xhs "query" # 小红书 所有搜索命令支持 -n <count> 指定结果数量。
管理命令: agent-reach doctor # 频道状态总览 agent-reach watch # 快速健康与更新检查(用于计划任务) agent-reach check-update # 检查新版本
配置频道: agent-reach configure twitter-cookies "auth_token=xxx; ct0=yyy" agent-reach configure proxy http://user:pass@ip:port agent-reach configure --from-browser chrome # 自动提取 cookie
频道状态分级 Tier 0(零配置):Web、YouTube、RSS、Twitter(通过 Jina 只读) Tier 1(免费设置):Exa 网页搜索(需要 mcporter) Tier 2(用户配置):Twitter 搜索(cookie)、Reddit 完整功能(代理)、GitHub(token)、Bilibili(代理)、小红书(MCP) 运行 agent-reach doctor 可查看哪些频道处于激活状态。
使用建议 对任何 URL,优先尝试 agent-reach read <url>,它会自动检测平台。 对于 Twitter cookie,建议用户安装 Cookie-Editor Chrome 扩展。 Reddit 和 Bilibili 会屏蔽服务器 IP——如果运行在服务器上,建议使用住宅代理(约 $1/月)。 如果某个频道失效,运行 agent-reach doctor 进行诊断。
限制 部分频道(Twitter 搜索、Reddit 完整功能、GitHub、Bilibili、小红书)需要用户自行配置 cookie、token、代理或 MCP 才能使用;Reddit 和 Bilibili 在服务器 IP 下可能被屏蔽,需借助住宅代理。其余关于收费、价格、平台覆盖细节等资料暂未提供。