零配置读取
网页通过 Jina Reader，YouTube/B站基础能力通过 yt-dlp，GitHub 公开信息通过 gh CLI，RSS 通过 feedparser。
Internet Access Scaffolding for Agents
Agent Reach 调研报告
Agent Reach 是一个给 AI Agent 安装互联网读取与搜索能力的 Python CLI。它不是统一代理层，而是 installer、doctor 和配置脚手架：装好后，Agent 直接调用 yt-dlp、gh CLI、twitter-cli、rdt-cli、xhs-cli、mcporter 等上游工具。
Python 3.10+
MIT
Cookie auth
Scraping risk
1. 结论摘要
适合场景
让 Claude Code、Cursor、OpenClaw、Windsurf、Codex 等能运行命令行的 Agent 快速获得网页读取、YouTube 字幕、GitHub、RSS、社媒搜索和平台内容读取能力。
核心风险
Agent Reach 会引导安装多个上游抓取/CLI/MCP 工具，并可能保存 Cookie、token、代理和 API key。Cookie 等同登录态，泄露后影响可能接近账号完整接管。
19,813GitHub stars，调研时 API 返回值
v1.4.0最新 release，2026-03-31
15+README/doctor 语境中的平台渠道规模
600配置文件 Unix 权限目标
2. 当前状态
| 项目 | 观察 |
|---|---|
| 仓库 | Panniantong/Agent-Reach，默认分支 main，MIT License。 |
| 定位 | GitHub 描述为给 AI Agent 互联网读取能力，支持 Twitter、Reddit、YouTube、GitHub、Bilibili、小红书等，且强调 one CLI、zero API fees。 |
| 语言与包 | 主要为 Python，pyproject.toml 中包名 agent-reach，需要 Python 3.10+，入口命令为 agent-reach。 |
| 版本 | pyproject.toml 为 1.4.0；GitHub latest release 为 v1.4.0；README 与 CLAUDE.md 的部分版本描述可能存在滞后。 |
| 配置 | 源码显示默认配置位于 ~/.agent-reach/config.yaml，保存时尝试用 0o600 权限创建。 |
3. 核心能力与渠道
登录后解锁
Twitter/X、小红书、雪球、Reddit 等可能需要 Cookie、浏览器登录态或专用 CLI 登录。README 建议使用专用小号。
MCP/外部服务
Exa、mcporter、douyin-mcp-server、linkedin-scraper-mcp 等作为可插拔上游工具，Agent Reach 负责安装、检测和配置。
主要命令
| 命令 | 用途 |
|---|---|
agent-reach install | 安装核心工具和可选渠道，支持 --env、--safe、--dry-run、--channels。 |
agent-reach doctor | 检查各平台可用性，并提示哪些渠道还需要配置。 |
agent-reach configure | 配置 proxy、GitHub token、Groq key、Twitter/XHS cookies，或从浏览器提取 Cookie。 |
agent-reach skill | 把 Agent Reach 的技能文件注册到 Agent skills 目录。 |
agent-reach uninstall | 移除配置、token、skill 文件，支持 dry-run 和 keep-config。 |
# 安全预览
agent-reach install --env=auto --dry-run
# 安全模式，不自动改系统
agent-reach install --env=auto --safe
# 安装特定渠道
agent-reach install --env=auto --channels=twitter,weibo4. 在 Agent 工作流中的应用
1. 安装让 Agent 按 install.md 执行，但优先 dry-run 或 safe mode。
2. 诊断运行
agent-reach doctor，确认哪些渠道已可用。3. 配置需要 Cookie 或 key 的渠道由用户提供凭据。
4. 调用上游Agent 根据 SKILL.md 直接调用 yt-dlp、gh、twitter、rdt 等。
5. 清理任务结束后审查配置和临时文件，必要时 uninstall 或撤销 Cookie。
提示词示例：帮我安装 Agent Reach，但先使用 --dry-run 列出会安装什么，不要自动输入 sudo，不要修改当前项目目录。
提示词示例：用 Agent Reach 读取这个 YouTube 视频字幕和 GitHub 仓库 README，输出引用链接和摘要，不要登录任何平台。
5. 风险分析
Cookie 和账号风险
Twitter、小红书、雪球等 Cookie 能代表登录态。泄露后可能读取私信/关注/收藏、发帖、点赞、评论或触发平台风控。README 也明确提醒封号和使用小号。
安装链过长
Agent Reach 会安装或引导安装多个第三方 CLI、MCP server、Node/Python 包。每个上游都是供应链风险源，且版本变化会影响可用性。
平台条款和反爬
“免费无 API Key”往往依赖抓取、Cookie 或网页自动化，可能违反平台条款，导致账号限制、IP 封禁或法律/合规问题。
工作区污染
install.md 明确要求不要在 Agent workspace 克隆仓库或创建文件，应使用 ~/.agent-reach/ 和 /tmp/，这点需要严格执行。
建议控制
| 控制项 | 建议 |
|---|---|
| 执行权限 | 先 dry-run；禁止 Agent 自行 sudo；安装前展示将安装的包和来源。 |
| 账号 | 使用专用小号和最小权限；不要使用主账号 Cookie；任务后撤销 Cookie 或重新登录。 |
| 凭据 | 不要把 Cookie/token 写入报告、git、prompt 历史；检查 ~/.agent-reach/config.yaml 权限。 |
| 合规 | 明确使用平台内容的授权、版权和 ToS 边界；避免批量抓取和敏感个人信息采集。 |