Give your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
Find a file
Panniantong f8234e3b96 docs: rewrite README — showcase underlying tools, not generic capabilities
Core insight from Neo: 'reading a URL is not a feature — every AI tool does that'

New approach: introduce each underlying project and what makes it special:
- Jina Reader (9.8K): any URL → clean Markdown, handles JS rendering
- yt-dlp (148K): subtitles from 1800+ video sites, not just YouTube
- Exa: neural semantic search, not keyword matching
- birdx: Twitter without expensive API Key, just browser cookies
- feedparser (2.3K): universal RSS/Atom parser

Framing: 'We find the best wheel for each job, then attach them all to your Agent'
2026-02-24 07:30:04 +01:00
agent_eyes fix: 3 bugs found in Docker clean-room test 2026-02-24 07:11:22 +01:00
docs docs: Chinese README as default, English in docs/ 2026-02-24 07:22:35 +01:00
scripts feat: add upstream sync script for x-reader updates 2026-02-24 05:22:48 +01:00
tests v2.0.0 — Pure glue architecture: zero copied code, pluggable channels 2026-02-24 05:38:21 +01:00
.env.example v1.0.0 — Agent Eyes: search + read the entire internet 2026-02-24 04:00:47 +01:00
.gitignore v1.0.0 — Agent Eyes: search + read the entire internet 2026-02-24 04:00:47 +01:00
LICENSE Initial: forked from runesleo/x-reader (MIT License) - thank you @runes_leo! 2026-02-24 03:00:05 +01:00
pyproject.toml fix: 3 bugs found in Docker clean-room test 2026-02-24 07:11:22 +01:00
README.md docs: rewrite README — showcase underlying tools, not generic capabilities 2026-02-24 07:30:04 +01:00

👁️ Agent Eyes

让你的 AI Agent 看见整个互联网。

Agent Eyes 是一个开源的粘合剂项目。它把互联网上最强的几个开源工具整合到一起,让你的 Agent 一次安装就获得所有能力。

我们不重复造轮子。我们找到每个领域最好的轮子,然后把它们装到你的 Agent 上。

English


我们整合了什么

每个平台背后都是一个久经考验的开源项目。Agent Eyes 只是把它们粘在一起,让你一行命令就能全部用上。

🌐 Jina Reader — 把任意网页变成干净文本

Jina Reader 9.8K)能把任意 URL 转成 LLM 友好的 Markdown。不是简单的爬虫——它能处理 JavaScript 渲染的页面、去掉广告和导航栏、只留下正文内容。Agent Eyes 用它来读取所有网页。

agent-eyes read "https://任意网页"

📺 yt-dlp — 从 1800+ 个视频网站提取字幕

yt-dlp 148K是互联网上最强的视频下载工具支持 1800+ 个视频网站——不只是 YouTube还有 B站、Twitch、TikTok 等等。Agent Eyes 用它来提取视频字幕,让 Agent 能"看"视频内容。

agent-eyes read "https://www.youtube.com/watch?v=xxx"
agent-eyes read "https://www.bilibili.com/video/BVxxx"

🔍 Exa — AI 原生的语义搜索引擎

Exa 不是传统的关键词搜索——它用神经网络理解你搜索的语义,找到真正相关的内容。一个免费 Key1000 次/月同时解锁全网搜索、Reddit 搜索和 Twitter 搜索。

agent-eyes search "2025年最适合个人开发者的 AI 工具"
agent-eyes search-reddit "best self-hosted LLM" --sub LocalLLaMA
agent-eyes search-twitter "AI agent 实战"

birdx 让你不需要 Twitter API Key那个贵得离谱只要浏览器 Cookie 就能搜索时间线、读完整线程、浏览任何用户的推文。

agent-eyes read "https://x.com/elonmusk/status/xxx"     # 读推文
agent-eyes search-twitter "Claude Code tips"               # 搜推特

📡 feedparser — 万能 RSS 阅读器

feedparser 2.3K)是 Python 世界的 RSS/Atom 解析标准,能处理几乎任何格式的订阅源。

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 后可以读取小红书笔记的完整内容和评论。


30 秒上手

把这句话复制给你的 AI Agent

帮我安装 Agent Eyeshttps://raw.githubusercontent.com/Panniantong/agent-eyes/main/docs/install.md

💡 打开你的 Agent 对话框Claude Code 终端、OpenClaw 聊天、Cursor Chat直接粘贴就行。

Agent 会自动装好,告诉你哪些功能已经可以用。

手动安装
pip install https://github.com/Panniantong/agent-eyes/archive/main.zip
agent-eyes install --env=auto
agent-eyes doctor

解锁更多

🔍 搜索免费30 秒)

注册 Exa 拿一个免费 Key

agent-eyes configure exa-key 你的KEY

本地电脑一键导入所有平台 cookies

agent-eyes configure --from-browser chrome

服务器用户?装个 Cookie-Editor 扩展,点 Export → Header String粘贴给 Agent。

🌐 代理($1/月,仅服务器)

Reddit 和 B站封服务器 IP。推荐 Webshare,一个代理管两个平台:

agent-eyes configure proxy http://用户名:密码@IP:端口

不买也行——Reddit 搜索通过 Exa 免费可用。


三种接入方式

命令行 · Python API · MCP Server

agent-eyes read "URL"              # 阅读
agent-eyes search "关键词"          # 搜索
agent-eyes doctor                   # 状态检查
from agent_eyes import AgentEyes
eyes = AgentEyes()
result = asyncio.run(eyes.read("https://example.com"))
MCP Server 配置
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 不造轮子,只做胶水:

  • 每个频道 ~50 行代码,就是对底层工具的薄封装
  • 换后端?改一个文件就行
  • 99% 功能免费,剩下 1% 也就 $1/月
  • 支持 CLI、MCP Server、Python API 三种接入
架构
┌──────────────────────────────────────────┐
│           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             │
└──────────────────────────────────────────┘

致谢

感谢这些项目Agent Eyes 站在它们的肩膀上:

  • Jina Reader — 网页转 Markdown
  • yt-dlp — 1800+ 视频网站字幕提取
  • birdx — 无 API Key 的 Twitter 访问
  • Exa — 语义搜索引擎
  • feedparser — RSS/Atom 解析

License

MIT