Give your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
Chinese README polished 3 rounds:
- Round 1: direct translation
- Round 2: too dry, too many tables, too technical
- Round 3: conversational tone, scenario-driven, collapsible details
Key improvements:
- Opens with WHY not WHAT ('你的Agent很聪明,但是看不见')
- Install section explains WHERE to paste for newbies
- Features shown as bullet list not tables (better visual scan)
- Architecture hidden in collapsible section (most users don't care)
- 'Why Agent Eyes' section explains positioning clearly
- English version at docs/README_en.md
|
||
|---|---|---|
| agent_eyes | ||
| docs | ||
| scripts | ||
| tests | ||
| .env.example | ||
| .gitignore | ||
| LICENSE | ||
| pyproject.toml | ||
| README.md | ||
👁️ Agent Eyes
让你的 AI Agent 看见整个互联网。
你的 AI Agent 很聪明,但是它看不见。它不能帮你刷 Reddit、搜 Twitter、读 B站视频。Agent Eyes 解决这个问题——装好之后,Agent 就能搜索和阅读互联网上几乎所有内容。
装一次,能力拉满。大部分功能零配置、零花费。
30 秒上手
把这句话复制给你的 AI Agent:
帮我安装 Agent Eyes:https://raw.githubusercontent.com/Panniantong/agent-eyes/main/docs/install.md
💡 不知道怎么发?打开你的 Agent 对话框(Claude Code 终端、OpenClaw 聊天、Cursor Chat),直接粘贴上面这段话就行。
Agent 会自动装好并告诉你哪些功能已经可以用了。你最多需要回答 1-2 个问题。
想手动装?点这里
pip install https://github.com/Panniantong/agent-eyes/archive/main.zip
agent-eyes install --env=auto
agent-eyes doctor
装好就能用的
不需要任何配置,装好直接用:
- 🌐 网页 — 给个 URL,帮你读出来
- 📦 GitHub — 仓库、Issue、PR、代码搜索
- 📺 YouTube — 自动提取视频字幕
- 📺 B站 — 视频信息 + 字幕提取
- 📡 RSS — 任意订阅源
- 🐦 Twitter — 读单条推文
agent-eyes read "https://github.com/openai/gpt-4"
agent-eyes read "https://www.bilibili.com/video/BV1xx411c7mD"
agent-eyes search-github "LLM 框架"
一个 Key 解锁搜索
注册 Exa(免费,1000 次/月),一个 Key 同时解锁 全网搜索 + Reddit 搜索 + Twitter 搜索:
agent-eyes configure exa-key 你的KEY
agent-eyes search "2025 最好的开源 LLM"
agent-eyes search-reddit "best self-hosted LLM" --sub LocalLLaMA
agent-eyes search-twitter "AI agent"
没有 Exa Key 也能用——只是不能搜索,读取功能不受影响。
解锁更多平台
🍪 Cookie 解锁(免费,2 分钟)
本地电脑一键导入所有 cookies:
agent-eyes configure --from-browser chrome
关掉 Chrome 再运行。支持 chrome / firefox / edge / brave / opera。
服务器用户?装个 Cookie-Editor 浏览器扩展,在网站上点一下 Export → Header String,粘贴给 Agent 就行。
Cookie 能解锁:
| 平台 | 额外能力 |
|---|---|
| 时间线搜索、完整线程、高级搜索 | |
| 📕 小红书 | 笔记内容 + 评论 |
🌐 代理解锁($1/月,仅服务器需要)
Reddit 和 B站封服务器 IP。本地电脑不受影响。
agent-eyes configure proxy http://用户名:密码@IP:端口
推荐 Webshare,$1/月。一个代理同时解锁 Reddit + B站。
不买也行——Reddit 搜索 通过 Exa 免费可用,只是不能读完整帖子。
三种使用方式
命令行
agent-eyes read "https://任意URL"
agent-eyes search "任意搜索词"
agent-eyes search-github "关键词"
agent-eyes search-reddit "关键词"
agent-eyes search-twitter "关键词"
agent-eyes doctor
Python
from agent_eyes import AgentEyes
import asyncio
eyes = AgentEyes()
result = asyncio.run(eyes.read("https://example.com"))
results = asyncio.run(eyes.search("AI agent"))
MCP Server(Claude Code / Cursor)
pip install agent-eyes[mcp]
{
"mcpServers": {
"agent-eyes": {
"command": "python",
"args": ["-m", "agent_eyes.integrations.mcp_server"]
}
}
}
配置速查
| 命令 | 作用 |
|---|---|
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 xhs-cookie "..." |
解锁小红书 |
agent-eyes configure proxy URL |
解锁 Reddit + B站(服务器) |
为什么用 Agent Eyes?
不是框架,不是 SDK,就是胶水。
- 把最好的免费工具粘在一起:Jina Reader、birdx、yt-dlp、Exa、feedparser
- 每个平台就是一个 ~50 行的薄封装,换后端只改一个文件
- CLI、MCP Server、Python API 三种接入方式
- 99% 功能免费,剩下 1% 也就 $1/月
架构图
┌─────────────────────────────────────────┐
│ Agent Eyes(纯胶水) │
│ │
│ web.py → Jina Reader API │
│ github.py → GitHub API │
│ twitter.py → birdx + Jina │
│ youtube.py → yt-dlp │
│ reddit.py → Reddit JSON API │
│ bilibili.py → Bilibili API │
│ rss.py → feedparser │
│ exa.py → Exa Search API │
│ xhs.py → XHS Web API │
│ │
│ CLI · MCP Server · Python API │
└─────────────────────────────────────────┘
致谢
- Jina Reader — 网页阅读
- birdx by @runes_leo — Twitter
- Exa — 语义搜索
- yt-dlp — YouTube
- feedparser — RSS
License
MIT