Panniantong /

Agent-Reach

AI Agent可试用PythonMIT

★ GitHub 仓库 ↗

总 Stars

★ 25,773

本周 +

+4,361

Forks

2,136

贡献者

29

未解 Issues

46

能做什么

适合AI agent需要获取社交平台实时信息，如舆情分析、内容采集

核心特性

1零API费用访问Twitter、Reddit等平台
2一条命令即可搜索国内外主流社交网络
3支持B站、小红书等国内平台

原文 README

在 GitHub 查看原文 ↗

👁️ Agent Reach

给你的 AI Agent 一键装上互联网能力

快速开始 · English · 日本語 · 한국어 · 支持平台 · 设计理念

为什么需要 Agent Reach？

AI Agent 已经能帮你写代码、改文档、管项目——但你让它去网上找点东西，它就抓瞎了：

📺 "帮我看看这个 YouTube 教程讲了什么" → 看不了，拿不到字幕
🐦 "帮我搜一下推特上大家怎么评价这个产品" → 搜不了，Twitter API 要付费
📖 "去 Reddit 上看看有没有人遇到过同样的 bug" → 403 被封，服务器 IP 被拒
📕 "帮我看看小红书上这个品的口碑" → 打不开，必须登录才能看
📺 "B站上有个技术视频，帮我总结一下" → 连不上，海外/服务器 IP 被屏蔽
🔍 "帮我在网上搜一下最新的 LLM 框架对比" → 没有好用的搜索，要么付费要么质量差
🌐 "帮我看看这个网页写了啥" → 抓回来一堆 HTML 标签，根本没法读
📦 "这个 GitHub 仓库是干嘛的？Issue 里说了什么？" → 能用，但认证配置很麻烦
📡 "帮我订阅这几个 RSS 源，有更新告诉我" → 要自己装库写代码

这些不难实现，但是需要自己折腾配置

每个平台都有自己的门槛——要付费的 API、要绕过的封锁、要登录的账号、要清洗的数据。你要一个一个去踩坑、装工具、调配置，光是让 Agent 能读个推特就得折腾半天。

Agent Reach 把这件事变成一句话：

帮我安装 Agent Reach：https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md

复制给你的 Agent，几分钟后它就能读推特、搜 Reddit、看 YouTube、刷小红书了。

已经装过了？更新也是一句话：

帮我更新 Agent Reach：https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/update.md

⭐ Star 这个项目，我们会持续追踪各平台的变化、接入新的渠道。你不用自己盯——平台封了我们修，有新渠道我们加。

✅ 在你用之前，你可能想知道


💰 完全免费	所有工具开源、所有 API 免费。唯一可能花钱的是服务器代理（$1/月），本地电脑不需要
🔒 隐私安全	Cookie 只存在你本地，不上传不外传。代码完全开源，随时可审查
🔄 持续更新	底层工具（yt-dlp、twitter-cli、rdt-cli、Jina Reader 等）定期追踪更新到最新版，你不用自己盯
🤖 兼容所有 Agent	Claude Code、OpenClaw、Cursor、Windsurf……任何能跑命令行的 Agent 都能用
🩺 自带诊断	`agent-reach doctor` 一条命令告诉你哪个通、哪个不通、怎么修

支持的平台

平台	装好即用	配置后解锁	怎么配
🌐 网页	阅读任意网页	—	无需配置
📺 YouTube	字幕提取 + 视频搜索	—	无需配置
📡 RSS	阅读任意 RSS/Atom 源	—	无需配置
🔍 全网搜索	—	全网语义搜索	自动配置（MCP 接入，免费无需 Key）
📦 GitHub	读公开仓库 + 搜索	私有仓库、提 Issue/PR、Fork	告诉 Agent「帮我登录 GitHub」
🐦 Twitter/X	读单条推文	搜索推文、浏览时间线、发推	告诉 Agent「帮我配 Twitter」
📺 B站	本地：字幕提取 + 搜索	服务器也能用	告诉 Agent「帮我配代理」
📖 Reddit	搜索 + 读帖子和评论（通过 rdt-cli）	Cookie	需要登录认证（`rdt login`），详见 rdt-cli
📕 小红书	—	阅读、搜索、发帖、评论、点赞	告诉 Agent「帮我配小红书」
🎵 抖音	—	视频解析、无水印下载链接获取	告诉 Agent「帮我配抖音」
💼 LinkedIn	Jina Reader 读公开页面	Profile 详情、公司页面、职位搜索	告诉 Agent「帮我配 LinkedIn」
💬 微信公众号	搜索 + 阅读公众号文章（全文 Markdown）	—	无需配置
📰 微博	热搜、搜索内容/用户/话题、用户动态、评论	—	无需配置
💻 V2EX	热门帖子、节点帖子、帖子详情+回复、用户信息	—	无需配置
📈 雪球	股票行情、搜索股票、热门帖子、热门股票排行	—	告诉 Agent「帮我配雪球」
🎙️ 小宇宙播客	—	播客音频转文字（Whisper 转录，免费 Key）	告诉 Agent「帮我配小宇宙播客」

不知道怎么配？不用查文档。 直接告诉 Agent「帮我配 XXX」，它知道需要什么、会一步一步引导你。

🍪 需要 Cookie 的平台（Twitter、小红书等），优先使用 Chrome 插件 Cookie-Editor 导出 Cookie，发给 Agent 即可配置。流程统一：浏览器登录 → Cookie-Editor 导出 → 发给 Agent。比扫码更简单可靠。

🔒 Cookie 只存在你本地，不上传不外传。代码完全开源，随时可审查。 💻 本地电脑不需要代理。代理只有部署在服务器上才需要（~$1/月）。

快速上手

⚠️ OpenClaw 用户请先确认 exec 权限已开启

Agent Reach 依赖 Agent 执行 shell 命令（pip install、mcporter、twitter 等）。如果你的 OpenClaw 使用了默认的 messaging 工具配置，Agent 将无法执行命令。安装前请先开启 exec 权限：
openclaw config set tools.profile "coding"
或在 ~/.openclaw/openclaw.json 中设置 "tools": { "profile": "coding" }。设置后重启 Gateway（openclaw gateway restart）并开启新对话即可。其他平台（Claude Code、Cursor、Windsurf 等）不受此限制。

复制这句话给你的 AI Agent（Claude Code、OpenClaw、Cursor 等）：

帮我安装 Agent Reach：https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md

就这一步。Agent 会自己完成剩下的所有事情。

🔄 已安装过？ 更新也是一句话：

帮我更新 Agent Reach：https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/update.md

🛡️ 担心安全？ 可以用安全模式——不会自动装系统包，只告诉你需要什么：
帮我安装 Agent Reach（安全模式）：https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md
安装时使用 --safe 参数

它会做什么？（点击展开）

安装 CLI 工具 — pip install 装好 agent-reach 命令行
安装系统依赖 — 自动检测并安装 Node.js、gh CLI、mcporter、twitter-cli、rdt-cli 等
配置搜索引擎 — 通过 MCP 接入 Exa（免费，无需 API Key）
检测环境 — 判断是本地电脑还是服务器，给出对应的配置建议
注册 SKILL.md — 在 Agent 的 skills 目录安装使用指南，以后 Agent 遇到"搜推特"、"看视频"这类需求，会自动知道该调哪个上游工具

安装完之后，agent-reach doctor 一条命令告诉你每个渠道的状态。

装好就能用

不需要任何配置，告诉 Agent 就行：

"帮我看看这个链接" → curl https://r.jina.ai/URL 读任意网页
"这个 GitHub 仓库是做什么的" → gh repo view owner/repo
"这个视频讲了什么" → yt-dlp --dump-json URL 提取字幕
"帮我看看这条推文" → twitter tweet URL
"订阅这个 RSS" → feedparser 解析
"搜一下 GitHub 上有什么 LLM 框架" → gh search repos "LLM framework"

不需要记命令。 Agent 读了 SKILL.md 之后自己知道该调什么。

设计理念

Agent Reach 是一个脚手架（scaffolding），不是框架。

你给一个新 Agent 装环境的时候，总要花时间去找工具、装依赖、调配置——Twitter 用什么读？Reddit 怎么绕封？YouTube 字幕怎么提取？每次都要重新踩一遍。

Agent Reach 做的事情很简单：帮你把这些选型和配置的活儿做完了。

安装完成后，Agent 直接调用上游工具（twitter-cli、rdt-cli、xhs-cli、yt-dlp、mcporter、gh CLI 等），不需要经过 Agent Reach 的包装层。

🔌 每个渠道都是可插拔的

每个平台背后是一个独立的上游工具。不满意？换掉就行。

channels/
├── web.py          → Jina Reader     ← 可以换成 Firecrawl、Crawl4AI……
├── twitter.py      → twitter-cli       ← 可以换成官方 API……
├── youtube.py      → yt-dlp          ← 可以换成 YouTube API、Whisper……
├── github.py       → gh CLI          ← 可以换成 REST API、PyGithub……
├── bilibili.py     → yt-dlp          ← 可以换成 bilibili-api……
├── reddit.py       → rdt-cli         ← 搜索+阅读，需 Cookie 认证
├── xiaohongshu.py  → mcporter MCP    ← 可以换成其他 XHS 工具……
├── douyin.py       → mcporter MCP    ← 可以换成其他抖音工具……
├── linkedin.py     → linkedin-mcp    ← 可以换成 LinkedIn API……
├── wechat.py       → Exa (+ Camoufox) ← 搜索+阅读微信公众号文章
├── rss.py          → feedparser      ← 可以换成 atoma……
├── exa_search.py   → mcporter MCP    ← 可以换成 Tavily、SerpAPI……
└── __init__.py     → 渠道注册（doctor 检测用）

每个渠道文件只负责检测对应上游工具是否可用（check() 方法），给 agent-reach doctor 提供状态信息。实际的读取和搜索由 Agent 直接调用上游工具完成。

当前选型

场景	选型	为什么选它
读网页	Jina Reader	9.8K Star，免费，不需要 API Key
读推特	twitter-cli	2.1K Star，Cookie 登录，搜索/读推文/时间线/长文
Reddit	rdt-cli	304 Star，Cookie 认证，搜索+全文+评论
视频字幕 + 搜索	yt-dlp	154K Star，YouTube + B站 + 1800 站通吃
B站增强	bili-cli	590 Star，热门/排行/搜索/动态
搜全网	Exa via mcporter	AI 语义搜索，MCP 接入免 Key
GitHub	gh CLI	官方工具，认证后完整 API 能力
读 RSS	feedparser	Python 生态标准选择，2.3K Star
小红书	xhs-cli	1.5K Star，pipx 一行安装，搜索/阅读/评论/发帖
抖音	douyin-mcp-server	MCP 服务，无需登录，视频解析 + 无水印下载
LinkedIn	linkedin-scraper-mcp	⭐1.2K，MCP 服务，浏览器自动化
微信公众号	Exa（搜索+阅读）+ Camoufox（可选）	零配置搜索+全文阅读，Camoufox 可选增强

📌 这些都是「当前选型」。不满意？换掉对应文件就行。这正是脚手架的意义。

抖音 / 小红书脚本提取的可选实现

如果你不只是想“解析抖音视频信息”，还想统一处理：

抖音视频脚本提取
小红书视频笔记脚本提取
小红书图文笔记正文 + 图片文字提取
固定输出 script.md 和 info.json

可以把 douyin 这个 mcporter alias 指向另一个兼容实现：

social-post-extractor-mcp

这个实现保留了旧工具名兼容性：

parse_douyin_video_info
get_douyin_download_link
extract_douyin_text

同时新增统一工具：

parse_social_post_info
extract_social_post_script

所以从 Agent Reach 的视角看，它依然只是一个 mcporter 里的 douyin server，只是能力更完整。

安全性

Agent Reach 在设计上重视安全：

措施	说明
🔒 凭据本地存储	Cookie、Token 只存在你本机 `~/.agent-reach/config.yaml`，文件权限 600（仅所有者可读写），不上传不外传
🛡️ 安全模式	`agent-reach install --safe` 不会自动修改系统，只列出需要什么，由你决定装不装
👀 完全开源	代码透明，随时可审查。所有依赖工具也是开源项目
🔍 Dry Run	`agent-reach install --dry-run` 预览所有操作，不做任何改动
🧩 可插拔架构	不信任某个组件？换掉对应的 channel 文件即可，不影响其他

🍪 Cookie 安全建议

⚠️ 封号风险提醒： 使用 Cookie 登录的平台（Twitter、小红书等），通过脚本/API 调用存在被平台检测并封号的风险。请务必使用专用小号，不要用你的主账号。

需要 Cookie 的平台（Twitter、小红书）建议使用专用小号，不要用主账号。原因有二：

封号风险 — 平台可能检测到非正常浏览器的 API 调用行为，导致账号被限制或封禁
安全风险 — Cookie 等同于完整登录权限，用小号可以在凭据泄露时限制影响范围

📦 安装方式

方式	命令	适合场景
一键全自动（默认）	`agent-reach install --env=auto`	个人电脑、开发环境
安全模式	`agent-reach install --env=auto --safe`	生产服务器、多人共用机器
仅预览	`agent-reach install --env=auto --dry-run`	先看看会做什么

🗑️ 卸载

agent-reach uninstall

会清除：~/.agent-reach/（含所有 token/cookie）、各 Agent 的 skill 文件、mcporter 中的 MCP 配置。

# 只预览，不实际删除
agent-reach uninstall --dry-run

# 只删 skill 文件，保留 token 配置（重装时用）
agent-reach uninstall --keep-config

卸载 Python 包本身：pip uninstall agent-reach

贡献

这个项目是纯 vibe coding 出来的 🎸 可能会有一些不完美的地方，如果遇到问题请多多包涵。有 bug 尽管提 Issue，我都会尽快修复。

想要新渠道？ 直接提 Issue 告诉我们，或者自己提 PR。

想在本地加？ 让你的 Agent clone 下来改就行，每个渠道就是一个独立文件，加起来很简单。

PR 也随时欢迎！

⭐ 为什么值得 Star

这个项目我自己每天在用，所以我会一直维护它。

有新需求或者大家提了想要的渠道，我会陆续加上
每个渠道我会尽量保证能用、好用、免费
平台改了反爬或者 API 变了，我会想办法解决

为 Web 4.0 基建贡献一份自己的力量。

Star 一下，下次需要的时候能找到。⭐

常见问题 / FAQ

AI Agent 怎么搜索 Twitter / X？不想付 API 费用

Agent Reach 使用 twitter-cli 通过 Cookie 认证访问 Twitter，完全免费。安装：pipx install twitter-cli，确保浏览器已登录 x.com，Agent 就可以用 twitter search "关键词" 搜索、twitter tweet URL 读推文了。

How to search Twitter/X with AI agent for free (no API)?

Agent Reach uses twitter-cli with cookie auth — zero API fees. Install with pipx install twitter-cli, make sure you're logged into x.com in your browser, then your agent can search with twitter search "query" and read tweets with twitter tweet URL.

Reddit 返回 403 怎么办？

Agent Reach 使用 rdt-cli 访问 Reddit。Reddit 自 2024 年起要求认证，安装后需运行 rdt login 登录。安装：pipx install 'git+https://github.com/public-clis/rdt-cli.git'（PyPI 版本暂时落后，从 GitHub 装），然后 rdt login（自动从浏览器提取 Cookie）。之后 Agent 可以用 rdt search "关键词" 搜索、rdt read POST_ID 读帖子全文和评论。

How to get YouTube video transcripts for AI?

yt-dlp --dump-json "https://youtube.com/watch?v=xxx" extracts video metadata; yt-dlp --write-sub --skip-download "URL" extracts subtitles. Uses yt-dlp under the hood, supports multiple languages. No API key needed.

怎么让 AI Agent 读小红书？

安装 pipx install xiaohongshu-cli，然后 xhs login（自动从浏览器提取 Cookie）。之后 Agent 就能用 xhs search "关键词" 搜索笔记、xhs read NOTE_ID 阅读详情、xhs comments NOTE_ID 查看评论了。不需要 Docker。

怎么让 AI Agent 解析抖音视频？

安装 douyin-mcp-server 后，Agent 就能用 mcporter call 'douyin.parse_douyin_video_info(share_link: "分享链接")' 解析视频信息、获取无水印下载链接。不需要登录，把抖音分享链接发给 Agent 就行。详见 https://github.com/yzfly/douyin-mcp-server

Compatible with Claude Code / Cursor / OpenClaw / Windsurf?

Yes! Agent Reach is an installer + configuration tool — any AI coding agent that can run shell commands can use it. Works with Claude Code, Cursor, OpenClaw, Windsurf, Codex, and more. Just pip install agent-reach, run agent-reach install, and the agent can start using the upstream tools immediately.

OpenClaw note: If your OpenClaw is using the default messaging tool profile, the agent won't be able to run shell commands. Enable exec first: openclaw config set tools.profile "coding" (or set "tools": { "profile": "coding" } in ~/.openclaw/openclaw.json), then restart the Gateway and start a new conversation before installing.

Is this free? Any API costs?

100% free. All backends are open-source tools (twitter-cli, rdt-cli, xhs-cli, yt-dlp, Jina Reader, Exa, etc.) that don't require paid API keys. The only optional cost is a residential proxy (~$1/month) if you need Bilibili access from an overseas server.