rename: Agent Eyes → Agent Reach

全局重命名： - 包名: agent_eyes → agent_reach - CLI: agent-eyes → agent-reach - 类名: AgentEyes → AgentReach - 显示名: Agent Eyes → Agent Reach - GitHub: Panniantong/agent-eyes → Panniantong/Agent-Reach 所有 36 个测试通过，CLI/doctor/read/search 全部正常。
2026-02-24 10:25:46 +01:00
parent 4b0ae20fd7
commit 5c62a21f32
38 changed files with 251 additions and 251 deletions
@@ -0,0 +1,69 @@
+# -*- coding: utf-8 -*-
+"""Exa semantic search — the search backbone for Agent Reach.
+
+Backend: Exa API (https://exa.ai) — free 1000 searches/month
+Swap to: Tavily, SerpAPI, or any search API
+"""
+
+import os
+import requests
+from .base import Channel, SearchResult
+from typing import List
+
+
+class ExaSearchChannel(Channel):
+    name = "exa_search"
+    description = "全网语义搜索（同时支持 Reddit/Twitter 搜索）"
+    backends = ["Exa API"]
+    requires_config = ["exa_api_key"]
+    tier = 1
+
+    API_URL = "https://api.exa.ai/search"
+
+    def can_handle(self, url: str) -> bool:
+        return False  # Search-only channel, doesn't read URLs
+
+    async def read(self, url: str, config=None) -> None:
+        raise NotImplementedError("Exa is a search engine, not a reader")
+
+    def _get_key(self, config=None) -> str:
+        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-reach setup"
+        )
+
+    async def search(self, query: str, config=None, **kwargs) -> List[SearchResult]:
+        api_key = self._get_key(config)
+        limit = kwargs.get("limit", 5)
+
+        resp = requests.post(
+            self.API_URL,
+            headers={"Content-Type": "application/json", "x-api-key": api_key},
+            json={
+                "query": query,
+                "numResults": min(limit, 10),
+                "type": "auto",
+                "contents": {"text": {"maxCharacters": 500}},
+            },
+            timeout=15,
+        )
+        resp.raise_for_status()
+
+        results = []
+        for item in resp.json().get("results", []):
+            results.append(SearchResult(
+                title=item.get("title", ""),
+                url=item.get("url", ""),
+                snippet=item.get("text", ""),
+                date=item.get("publishedDate", ""),
+                score=item.get("score", 0),
+            ))
+        return results