c851bd64b9
Changes: 1. browser-cookie3 now in default deps (no separate pip install) 2. install --env=auto now auto-imports cookies on local computers 3. install auto-detects EXA_API_KEY from environment variables 4. install.md cut from 100 lines to 60 lines — two steps not five Before: pip install → agent-eyes install → 'want search?' → 'want cookies?' → configure each After: pip install → agent-eyes install (does everything automatically) → only ask about what's missing Docker clean-room test: all passing, 0 bugs. |
||
|---|---|---|
| .. | ||
| cookie-export.md | ||
| install.md | ||
| README_en.md | ||
👁️ Agent Eyes
Give your AI Agent eyes to see the entire internet.
Your AI Agent is smart but blind. It can't browse Reddit, search Twitter, or read Bilibili videos. Agent Eyes fixes this — once installed, your Agent can search and read content across 10+ platforms.
Install once. Superpowers unlocked. Most features work with zero config, zero cost.
Get Started in 30 Seconds
Copy this to your AI Agent (Claude Code, OpenClaw, Cursor, etc.):
Install Agent Eyes: https://raw.githubusercontent.com/Panniantong/agent-eyes/main/docs/install.md
Your Agent handles everything. You answer 1-2 questions at most.
Manual install
pip install https://github.com/Panniantong/agent-eyes/archive/main.zip
agent-eyes install --env=auto
agent-eyes doctor
Works Out of the Box
No configuration needed:
- 🌐 Web pages — read any URL
- 📦 GitHub — repos, issues, PRs, code search
- 📺 YouTube — video transcripts
- 📺 Bilibili — video info + subtitles
- 📡 RSS — any feed
- 🐦 Twitter — read individual tweets
agent-eyes read "https://github.com/openai/gpt-4"
agent-eyes search-github "LLM framework"
One Key Unlocks Search
Sign up at Exa (free, 1000 searches/month). One key unlocks web + Reddit + Twitter search:
agent-eyes configure exa-key YOUR_KEY
agent-eyes search "best open source LLM 2025"
agent-eyes search-reddit "self-hosted LLM" --sub LocalLLaMA
agent-eyes search-twitter "AI agent"
Unlock More
🍪 Cookie-based (free, 2 minutes)
# Local: auto-import all cookies
agent-eyes configure --from-browser chrome
# Server: use Cookie-Editor extension, export Header String
agent-eyes configure twitter-cookies "cookie_string"
agent-eyes configure xhs-cookie "cookie_string"
Unlocks: Twitter deep search, XiaoHongShu notes
🌐 Proxy ($1/month, servers only)
Reddit and Bilibili block server IPs. Local computers are fine.
agent-eyes configure proxy http://user:pass@ip:port
Recommend Webshare. One proxy covers both Reddit and Bilibili.
Three Ways to Use
CLI · Python API · MCP Server
agent-eyes read "URL"
agent-eyes search "query"
agent-eyes doctor
from agent_eyes import AgentEyes
eyes = AgentEyes()
result = asyncio.run(eyes.read("https://example.com"))
{"mcpServers": {"agent-eyes": {"command": "python", "args": ["-m", "agent_eyes.integrations.mcp_server"]}}}
Why Agent Eyes?
Not a framework. Not an SDK. Just glue — beautifully simple glue.
- Aggregates the best free tools: Jina Reader, birdx, yt-dlp, Exa, feedparser
- Each channel is ~50 lines. Swap any backend by editing one file.
- CLI, MCP Server, Python API
- 99% free. The remaining 1% costs $1/month.
Credits
Jina Reader · birdx · Exa · yt-dlp · feedparser
License
MIT