Give your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
Python agent-infrastructureai-agentai-searchautomationbilibiliclaude-codeclicursorfree-apillm-toolsmcppythonreddit-scrapertwitter-scraperweb-scraperxiaohongshuyoutube-transcript
docs: 4 rounds of Steve Jobs polish on Chinese README
Panniantonga9f5fd93d7ec
diff --git a/README.md b/README.mdindex f0d68a9b..193ccdcf 100644--- a/README.md+++ b/README.md@@ -1,85 +1,34 @@# 👁️ Agent Eyes-**让你的 AI Agent 看见整个互联网。**+**一行命令,让你的 AI Agent 看见整个互联网。**-Agent Eyes 是一个开源的粘合剂项目。它把互联网上最强的几个开源工具整合到一起,让你的 Agent 一次安装就获得所有能力。+你的 AI Agent 很聪明,但几乎是个瞎子。Reddit 封 IP、Twitter API 要 $100/月、B站屏蔽服务器、小红书需要登录——每个平台都有自己的坑,你要一个一个去踩。-> 我们不重复造轮子。我们找到每个领域最好的轮子,然后把它们装到你的 Agent 上。+Agent Eyes 把互联网上最好的开源工具粘在一起,一次安装全部搞定:-[English](docs/README_en.md)-------## 我们整合了什么--每个平台背后都是一个久经考验的开源项目。Agent Eyes 只是把它们粘在一起,让你一行命令就能全部用上。--### 🌐 Jina Reader — 把任意网页变成干净文本--[Jina Reader](https://github.com/jina-ai/reader)(⭐ 9.8K)能把任意 URL 转成 LLM 友好的 Markdown。不是简单的爬虫——它能处理 JavaScript 渲染的页面、去掉广告和导航栏、只留下正文内容。Agent Eyes 用它来读取所有网页。--```bash-agent-eyes read "https://任意网页"-```--### 📺 yt-dlp — 从 1800+ 个视频网站提取字幕--[yt-dlp](https://github.com/yt-dlp/yt-dlp)(⭐ 148K)是互联网上最强的视频下载工具,支持 **1800+ 个视频网站**——不只是 YouTube,还有 B站、Twitch、TikTok 等等。Agent Eyes 用它来提取视频字幕,让 Agent 能"看"视频内容。--```bash-agent-eyes read "https://www.youtube.com/watch?v=xxx"-agent-eyes read "https://www.bilibili.com/video/BVxxx"-```--### 🔍 Exa — AI 原生的语义搜索引擎--[Exa](https://exa.ai) 不是传统的关键词搜索——它用神经网络理解你搜索的**语义**,找到真正相关的内容。一个免费 Key(1000 次/月),同时解锁全网搜索、Reddit 搜索和 Twitter 搜索。--```bash-agent-eyes search "2025年最适合个人开发者的 AI 工具"-agent-eyes search-reddit "best self-hosted LLM" --sub LocalLLaMA-agent-eyes search-twitter "AI agent 实战"-```--### 🐦 birdx — 无需 API,用 Cookie 玩转 Twitter--[birdx](https://github.com/runesleo/birdx) 让你不需要 Twitter API Key(那个贵得离谱),只要浏览器 Cookie 就能搜索时间线、读完整线程、浏览任何用户的推文。--```bash-agent-eyes read "https://x.com/elonmusk/status/xxx" # 读推文-agent-eyes search-twitter "Claude Code tips" # 搜推特-```--### 📡 feedparser — 万能 RSS 阅读器--[feedparser](https://github.com/kurtmckee/feedparser)(⭐ 2.3K)是 Python 世界的 RSS/Atom 解析标准,能处理几乎任何格式的订阅源。--```bash-agent-eyes read "https://hnrss.org/frontpage" # Hacker News-agent-eyes read "https://rsshub.app/github/trending/daily" # GitHub Trending-```--### 📺 Bilibili API — B站视频信息 + 字幕+| 工具 | 它解决了什么 | Stars |+|------|------------|:-----:|+| [Jina Reader](https://github.com/jina-ai/reader) | 任意网页 → 干净 Markdown,处理 JS 渲染,去掉广告 | ⭐ 9.8K |+| [yt-dlp](https://github.com/yt-dlp/yt-dlp) | **1800+ 个视频网站**的字幕提取(YouTube、B站、TikTok…) | ⭐ 148K |+| [Exa](https://exa.ai) | AI 语义搜索引擎,一个 Key 搜全网 + Reddit + Twitter | — |+| [birdx](https://github.com/runesleo/birdx) | 不花 $100/月,用 Cookie 就能搜 Twitter 时间线和线程 | — |+| [feedparser](https://github.com/kurtmckee/feedparser) | 万能 RSS/Atom 解析 | ⭐ 2.3K |-直接调用 B站公开 API,提取视频标题、描述、字幕。本地电脑直接可用,服务器需要代理。+> 不造轮子,只做胶水。统一安装、统一配置、统一接口。-### 📕 小红书 — Cookie 一配就能读--配好 Cookie 后可以读取小红书笔记的完整内容和评论。+[English](docs/README_en.md)---## 30 秒上手-把这句话复制给你的 AI Agent:+复制给你的 AI Agent(Claude Code、OpenClaw、Cursor 等):```帮我安装 Agent Eyes:https://raw.githubusercontent.com/Panniantong/agent-eyes/main/docs/install.md```-> 💡 打开你的 Agent 对话框(Claude Code 终端、OpenClaw 聊天、Cursor Chat),直接粘贴就行。--Agent 会自动装好,告诉你哪些功能已经可以用。+Agent 自动安装、检测环境、告诉你哪些功能已经可以用。<details><summary>手动安装</summary>@@ -87,137 +36,142 @@ Agent 会自动装好,告诉你哪些功能已经可以用。```bashpip install https://github.com/Panniantong/agent-eyes/archive/main.zipagent-eyes install --env=auto-agent-eyes doctor```</details>----## 解锁更多+## 装好就能用-### 🔍 搜索(免费,30 秒)+不需要任何配置,装完直接用:-注册 [Exa](https://exa.ai) 拿一个免费 Key:+```bash+agent-eyes read "https://任意网页" # Jina Reader 驱动+agent-eyes read "https://github.com/openai/gpt-4" # GitHub 仓库/Issue/PR+agent-eyes read "https://www.youtube.com/watch?v=xxx" # yt-dlp 驱动+agent-eyes read "https://www.bilibili.com/video/BVxxx" # B站字幕+agent-eyes read "https://x.com/elonmusk/status/xxx" # 推文+agent-eyes read "https://hnrss.org/frontpage" # RSS 订阅+agent-eyes search-github "LLM 框架" # GitHub 搜索+```++---++## 按需解锁++不用的不用配。每一步都可以跳过。++### 🔍 搜索 — 免费,30 秒++一个 [Exa](https://exa.ai) Key(免费 1000 次/月),同时解锁三个搜索:```bashagent-eyes configure exa-key 你的KEY++agent-eyes search "2025 最好的开源 AI 工具"+agent-eyes search-reddit "best LLM" --sub LocalLLaMA+agent-eyes search-twitter "Claude Code"```-### 🍪 Cookie 解锁(免费,2 分钟)+### 🍪 Cookie — 免费,2 分钟-本地电脑一键导入所有平台 cookies:+解锁 Twitter 高级搜索 + 小红书。本地电脑一键导入:```bashagent-eyes configure --from-browser chrome```-服务器用户?装个 [Cookie-Editor](https://chromewebstore.google.com/detail/cookie-editor/hlkenndednhfkekhgcdicdfddnkalmdm) 扩展,点 Export → Header String,粘贴给 Agent。+> 服务器用户?装个 [Cookie-Editor](https://chromewebstore.google.com/detail/cookie-editor/hlkenndednhfkekhgcdicdfddnkalmdm) 扩展,Export → Header String,粘贴给 Agent。-### 🌐 代理($1/月,仅服务器)+### 🌐 代理 — $1/月,仅服务器需要-Reddit 和 B站封服务器 IP。推荐 [Webshare](https://webshare.io),一个代理管两个平台:+Reddit 和 B站封服务器 IP。一个代理解决两个:```bashagent-eyes configure proxy http://用户名:密码@IP:端口```-> 不买也行——Reddit 搜索通过 Exa 免费可用。+> Reddit 搜索通过 Exa 免费可用,不买代理也能搜,只是读不了完整帖子。+> 推荐 [Webshare](https://webshare.io),$1/月。----## 三种接入方式+## 状态一目了然++```+$ agent-eyes doctor++👁️ Agent Eyes Status+✅ Web [Jina Reader] ✅ GitHub [API] ✅ RSS [feedparser]+✅ YouTube [yt-dlp] ✅ Bilibili [API] ✅ Twitter [birdx]+⬜ Search [need Exa key] ⬜ XiaoHongShu [cookies] ⬜ Reddit [proxy]++6/9 active+```++----**命令行** · **Python API** · **MCP Server**+## 接入方式+### CLI```bash-agent-eyes read "URL" # 阅读-agent-eyes search "关键词" # 搜索-agent-eyes doctor # 状态检查+agent-eyes read "URL"+agent-eyes search "关键词"+agent-eyes doctor```+### Python```pythonfrom agent_eyes import AgentEyes+import asyncioeyes = AgentEyes()-result = asyncio.run(eyes.read("https://example.com"))+asyncio.run(eyes.read("https://example.com"))+asyncio.run(eyes.search("AI agent"))```-<details>-<summary>MCP Server 配置</summary>+### MCP Server(Claude Code / Cursor)-```bash-pip install agent-eyes[mcp]-```+<details>+<summary>配置</summary>```json-{- "mcpServers": {- "agent-eyes": {- "command": "python",- "args": ["-m", "agent_eyes.integrations.mcp_server"]- }- }-}+{"mcpServers": {"agent-eyes": {"command": "python", "args": ["-m", "agent_eyes.integrations.mcp_server"]}}}```</details>----## 配置速查+## 速查| 命令 | 作用 ||------|------|| `agent-eyes doctor` | 查看状态 || `agent-eyes configure --from-browser chrome` | 一键导入 cookies || `agent-eyes configure exa-key KEY` | 解锁搜索 |-| `agent-eyes configure twitter-cookies "..."` | 解锁 Twitter 高级 |+| `agent-eyes configure twitter-cookies "..."` | 解锁 Twitter || `agent-eyes configure xhs-cookie "..."` | 解锁小红书 |-| `agent-eyes configure proxy URL` | 解锁 Reddit + B站(服务器)|+| `agent-eyes configure proxy URL` | 解锁 Reddit + B站 |----## 设计理念+## 设计-Agent Eyes 不造轮子,只做胶水:--- 每个频道 ~50 行代码,就是对底层工具的薄封装-- 换后端?改一个文件就行-- 99% 功能免费,剩下 1% 也就 $1/月-- 支持 CLI、MCP Server、Python API 三种接入+胶水,不是框架。每个频道 ~50 行代码,换后端改一个文件。<details><summary>架构</summary>```-┌──────────────────────────────────────────┐-│ Agent Eyes(胶水层) │-│ │-│ web.py → Jina Reader (⭐ 9.8K) │-│ youtube.py → yt-dlp (⭐ 148K) │-│ twitter.py → birdx │-│ exa.py → Exa Search │-│ github.py → GitHub API │-│ bilibili.py → Bilibili API │-│ reddit.py → Reddit JSON API │-│ rss.py → feedparser (⭐ 2.3K) │-│ xhs.py → XHS Web API │-│ │-│ CLI · MCP Server · Python API │-└──────────────────────────────────────────┘+web.py → Jina Reader github.py → GitHub API+youtube.py → yt-dlp bilibili.py → Bilibili API+twitter.py → birdx reddit.py → Reddit JSON+exa.py → Exa Search rss.py → feedparser+xhs.py → XHS Web API```</details>-----## 致谢-感谢这些项目,Agent Eyes 站在它们的肩膀上:--- [Jina Reader](https://github.com/jina-ai/reader) — 网页转 Markdown-- [yt-dlp](https://github.com/yt-dlp/yt-dlp) — 1800+ 视频网站字幕提取-- [birdx](https://github.com/runesleo/birdx) — 无 API Key 的 Twitter 访问-- [Exa](https://exa.ai) — 语义搜索引擎-- [feedparser](https://github.com/kurtmckee/feedparser) — RSS/Atom 解析--## License+[Jina Reader](https://github.com/jina-ai/reader) · [yt-dlp](https://github.com/yt-dlp/yt-dlp) · [birdx](https://github.com/runesleo/birdx) · [Exa](https://exa.ai) · [feedparser](https://github.com/kurtmckee/feedparser)-MIT+MIT License