Agent-Reach/agent_eyes/guides/setup-exa.md
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.3 KiB
Raw Blame History

Exa Search 配置指南

功能说明

Exa 是一个语义搜索引擎,免费提供 1000 次/月搜索。配置后解锁:

  • 全网搜索
  • Reddit 搜索(通过 site:reddit.com
  • Twitter 搜索(通过 site:x.com

Agent 可自动完成的步骤

  1. 检查是否已配置:
agent-eyes doctor | grep "Web Search"
  1. 如果用户提供了 key写入配置
# 方法1: 通过 setup 命令
agent-eyes setup

# 方法2: 直接写入配置文件
python3 -c "
from agent_eyes.config import Config
c = Config()
c.set('exa_api_key', '用户提供的KEY')
print('✅ Exa API key saved')
"
  1. 测试是否有效:
agent-eyes search "test query" -n 1

需要用户手动做的步骤

请告诉用户:

我需要一个 Exa API Key 来开启搜索功能。完全免费,每月 1000 次搜索。

步骤:

  1. 打开 https://exa.ai
  2. 点击 "Get API Key" 或 "Sign Up"
  3. 用 Google 账号或邮箱注册
  4. 注册后在 Dashboard 页面复制你的 API Key
  5. 把 Key 发给我

大概 30 秒就能搞定。

Agent 收到 key 后的操作

  1. 写入配置:config.set("exa_api_key", key)
  2. 测试:运行一次搜索确认可用
  3. 反馈:" 全网搜索已开启现在我可以帮你搜索全网、Reddit 和 Twitter 了。"