docs: 4 rounds of Steve Jobs polish on Chinese README
Round 1: Problem-solution structure, showcase underlying tools
Round 2: Too verbose - 4 'can't do' examples is repetitive, tightened
Round 3: Compact doctor output, restored quick-reference table,
cut code examples to essentials
Round 4: Opening paragraph tighter - one sentence for all pain points
Key: README doesn't say 'we can read URLs' (every tool does that).
It says 'here are the best open-source tools for each platform,
we glued them together so you install once and get everything.'
This commit is contained in:
Panniantong
parent
f8234e3b96
commit
a9f5fd93d7
1 changed files with 87 additions and 133 deletions
220
README.md
220
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 把互联网上最好的开源工具粘在一起，一次安装全部搞定：
|
||||
|
||||
| 工具 | 它解决了什么 | 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 |
|
||||
|
||||
> 不造轮子，只做胶水。统一安装、统一配置、统一接口。
|
||||
|
||||
[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站视频信息 + 字幕
|
||||
|
||||
直接调用 B站公开 API，提取视频标题、描述、字幕。本地电脑直接可用，服务器需要代理。
|
||||
|
||||
### 📕 小红书 — Cookie 一配就能读
|
||||
|
||||
配好 Cookie 后可以读取小红书笔记的完整内容和评论。
|
||||
|
||||
---
|
||||
|
||||
## 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 会自动装好，告诉你哪些功能已经可以用。
|
|||
```bash
|
||||
pip install https://github.com/Panniantong/agent-eyes/archive/main.zip
|
||||
agent-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 次/月），同时解锁三个搜索：
|
||||
|
||||
```bash
|
||||
agent-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 高级搜索 + 小红书。本地电脑一键导入：
|
||||
|
||||
```bash
|
||||
agent-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。一个代理解决两个：
|
||||
|
||||
```bash
|
||||
agent-eyes configure proxy http://用户名:密码@IP:端口
|
||||
```
|
||||
|
||||
> 不买也行——Reddit 搜索通过 Exa 免费可用。
|
||||
> Reddit 搜索通过 Exa 免费可用，不买代理也能搜，只是读不了完整帖子。
|
||||
> 推荐 [Webshare](https://webshare.io)，$1/月。
|
||||
|
||||
---
|
||||
|
||||
## 三种接入方式
|
||||
## 状态一目了然
|
||||
|
||||
**命令行** · **Python API** · **MCP Server**
|
||||
```
|
||||
$ agent-eyes doctor
|
||||
|
||||
```bash
|
||||
agent-eyes read "URL" # 阅读
|
||||
agent-eyes search "关键词" # 搜索
|
||||
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
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 接入方式
|
||||
|
||||
### CLI
|
||||
```bash
|
||||
agent-eyes read "URL"
|
||||
agent-eyes search "关键词"
|
||||
agent-eyes doctor
|
||||
```
|
||||
|
||||
### Python
|
||||
```python
|
||||
from agent_eyes import AgentEyes
|
||||
import asyncio
|
||||
eyes = AgentEyes()
|
||||
result = asyncio.run(eyes.read("https://example.com"))
|
||||
asyncio.run(eyes.read("https://example.com"))
|
||||
asyncio.run(eyes.search("AI agent"))
|
||||
```
|
||||
|
||||
### MCP Server（Claude Code / Cursor）
|
||||
|
||||
<details>
|
||||
<summary>MCP Server 配置</summary>
|
||||
|
||||
```bash
|
||||
pip install agent-eyes[mcp]
|
||||
```
|
||||
<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) · [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)
|
||||
|
||||
- [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
|
||||
|
||||
MIT
|
||||
MIT License
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue