Panniantong
8eab038cb9
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)
66 lines
1.8 KiB
Markdown
66 lines
1.8 KiB
Markdown
---
|
|
name: agent-eyes
|
|
description: "Give your AI Agent eyes to see the entire internet. Search + read 10+ platforms with one install."
|
|
install: pip install git+https://github.com/Panniantong/agent-eyes.git
|
|
---
|
|
|
|
# Agent Eyes — 给 Agent 装上眼睛 👁️
|
|
|
|
安装后你就能搜索和阅读全网内容。
|
|
|
|
## 安装
|
|
|
|
```bash
|
|
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：
|
|
|
|
```bash
|
|
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
|
|
|
|
```python
|
|
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())
|
|
```
|