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)
79 lines
2 KiB
Python
79 lines
2 KiB
Python
# -*- coding: utf-8 -*-
|
|
"""Exa semantic web search.
|
|
|
|
Get a free API key at https://exa.ai (1000 searches/month free).
|
|
"""
|
|
|
|
import os
|
|
import requests
|
|
from loguru import logger
|
|
from typing import Any, Dict, List, Optional
|
|
|
|
|
|
EXA_API_URL = "https://api.exa.ai/search"
|
|
|
|
|
|
def _get_api_key(config=None) -> str:
|
|
"""Get Exa API key from config or env."""
|
|
if config:
|
|
key = config.get("exa_api_key")
|
|
if key:
|
|
return key
|
|
key = os.environ.get("EXA_API_KEY")
|
|
if key:
|
|
return key
|
|
raise ValueError(
|
|
"Exa API key not configured.\n"
|
|
"Get a free key at https://exa.ai (1000 searches/month free)\n"
|
|
"Then run: agent-eyes setup"
|
|
)
|
|
|
|
|
|
async def search_web(
|
|
query: str,
|
|
num_results: int = 5,
|
|
search_type: str = "auto",
|
|
config=None,
|
|
) -> List[Dict[str, Any]]:
|
|
"""
|
|
Semantic web search via Exa.
|
|
|
|
Args:
|
|
query: Search query (supports site: prefix)
|
|
num_results: Number of results (default 5, max 10)
|
|
search_type: "auto" / "neural" / "keyword"
|
|
config: Optional Config instance
|
|
|
|
Returns:
|
|
List of {title, url, snippet, published_date, score}
|
|
"""
|
|
api_key = _get_api_key(config)
|
|
logger.info(f"Exa search: {query} (n={num_results})")
|
|
|
|
resp = requests.post(
|
|
EXA_API_URL,
|
|
headers={
|
|
"Content-Type": "application/json",
|
|
"x-api-key": api_key,
|
|
},
|
|
json={
|
|
"query": query,
|
|
"numResults": min(num_results, 10),
|
|
"type": search_type,
|
|
"contents": {"text": {"maxCharacters": 500}},
|
|
},
|
|
timeout=15,
|
|
)
|
|
resp.raise_for_status()
|
|
data = resp.json()
|
|
|
|
results = []
|
|
for item in data.get("results", []):
|
|
results.append({
|
|
"title": item.get("title", ""),
|
|
"url": item.get("url", ""),
|
|
"snippet": item.get("text", ""),
|
|
"published_date": item.get("publishedDate", ""),
|
|
"score": item.get("score", 0),
|
|
})
|
|
return results
|