Panniantong 8eab038cb9 v1.0.0 — Agent Eyes: search + read the entire internet

Major restructure from x-reader fork to independent project:

Architecture:
- readers/ — content extraction from 10+ platforms (based on x-reader, MIT)
- search/ — semantic search via Exa, GitHub API, birdx (NEW)
- config.py — configuration management (~/.agent-eyes/config.yaml) (NEW)
- doctor.py — environment health checker (NEW)
- core.py — AgentEyes unified entry point (NEW)
- cli.py — full CLI: read, search, setup, doctor (NEW)
- integrations/mcp_server.py — 8 MCP tools (NEW)
- guides/ — 6 Agent-readable setup guides (NEW)
- integrations/skill/ — OpenClaw Skill package (NEW)

Platforms (zero config):
- Web pages, GitHub, Bilibili, YouTube, RSS, single tweets

Platforms (one free API key):
- Web search, Reddit search, Twitter search (via Exa)

Platforms (optional setup):
- Reddit full reader, Twitter advanced, WeChat, XiaoHongShu

Tests: 34/34 passing

Credits: Built on x-reader by @runes_leo (MIT License)

2026-02-24 04:00:47 +01:00

1.8 KiB

Raw Blame History

name	description	install
agent-eyes	Give your AI Agent eyes to see the entire internet. Search + read 10+ platforms with one install.	pip install git+https://github.com/Panniantong/agent-eyes.git

Agent Eyes — 给 Agent 装上眼睛 👁️

安装后你就能搜索和阅读全网内容。

安装

pip install git+https://github.com/Panniantong/agent-eyes.git

装完直接能用的（零配置）

agent-eyes read <URL> — 读取任意网页、GitHub、B站、YouTube、RSS
agent-eyes search-github "query" — 搜索 GitHub 仓库
agent-eyes doctor — 查看所有平台状态

解锁更多功能

运行 agent-eyes setup 进行交互式配置，或者读取以下指南：

功能	指南文件
全网搜索 + Reddit搜索 + Twitter搜索	`agent_eyes/guides/setup-exa.md`
Reddit 完整阅读	`agent_eyes/guides/setup-reddit.md`
Twitter 高级（时间线/线程）	`agent_eyes/guides/setup-twitter.md`
小红书	`agent_eyes/guides/setup-xiaohongshu.md`
微信公众号	`agent_eyes/guides/setup-wechat.md`
视频语音转文字	`agent_eyes/guides/setup-groq.md`

每个指南里有详细的步骤说明，你（Agent）可以照着做，只有需要人类操作的部分（登录、复制 key）才需要问用户。

MCP Server

如果你的 Agent 平台支持 MCP：

pip install agent-eyes[mcp]
python -m agent_eyes.integrations.mcp_server

提供 8 个工具：read_url, read_batch, detect_platform, search, search_reddit, search_github, search_twitter, get_status

Python API

from agent_eyes import AgentEyes
import asyncio

eyes = AgentEyes()

# 读取
result = asyncio.run(eyes.read("https://github.com/openai/gpt-4"))

# 搜索
results = asyncio.run(eyes.search("AI agent framework"))

# 健康检查
print(eyes.doctor_report())

1.8 KiB Raw Blame History Unescape Escape