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 e96ebdec88 docs: Chinese README as default, English in docs/
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
2026-02-24 07:22:35 +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: Chinese README as default, English in docs/ 2026-02-24 07:22:35 +01:00

👁️ Agent Eyes

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

你的 AI Agent 很聪明,但是它看不见。它不能帮你刷 Reddit、搜 Twitter、读 B站视频。Agent Eyes 解决这个问题——装好之后Agent 就能搜索和阅读互联网上几乎所有内容。

装一次,能力拉满。大部分功能零配置、零花费。

English


30 秒上手

把这句话复制给你的 AI Agent

帮我安装 Agent Eyeshttps://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 也能用——只是不能搜索,读取功能不受影响。


解锁更多平台

本地电脑一键导入所有 cookies

agent-eyes configure --from-browser chrome

关掉 Chrome 再运行。支持 chrome / firefox / edge / brave / opera。

服务器用户?装个 Cookie-Editor 浏览器扩展,在网站上点一下 Export → Header String粘贴给 Agent 就行。

Cookie 能解锁:

平台 额外能力
🐦 Twitter 时间线搜索、完整线程、高级搜索
📕 小红书 笔记内容 + 评论

🌐 代理解锁($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 ServerClaude 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            │
└─────────────────────────────────────────┘

致谢

License

MIT