Give your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
Python agent-infrastructureai-agentai-searchautomationbilibiliclaude-codeclicursorfree-apillm-toolsmcppythonreddit-scrapertwitter-scraperweb-scraperxiaohongshuyoutube-transcript
refactor: XHS + Exa 全面切换到 mcporter MCP 后端
Panniantongbb9ce6f7f19e
diff --git a/agent_reach/channels/exa_search.py b/agent_reach/channels/exa_search.pyindex 07edb6c0..0a2e3a01 100644--- a/agent_reach/channels/exa_search.py+++ b/agent_reach/channels/exa_search.py@@ -1,18 +1,13 @@# -*- coding: utf-8 -*--"""Exa semantic search — the search backbone for Agent Reach.+"""Exa semantic search — via mcporter + Exa MCP server.-Backend priority:-1. mcporter + Exa MCP server (OAuth, no API key needed)-2. Direct Exa API (requires EXA_API_KEY)--Swap to: Tavily, SerpAPI, or any search API+Backend: Exa MCP at mcp.exa.ai (OAuth, no API key needed)+Requires: mcporter CLI"""-import osimport jsonimport shutilimport subprocess-import requestsfrom .base import Channel, SearchResultfrom typing import List@@ -20,160 +15,96 @@ from typing import Listclass ExaSearchChannel(Channel):name = "exa_search"description = "全网语义搜索(同时支持 Reddit/Twitter 搜索)"- backends = ["Exa MCP Server", "Exa API"]+ backends = ["exa-mcp"]tier = 1- API_URL = "https://api.exa.ai/search"-- def _has_mcporter_exa(self):- """Check if mcporter CLI is available and exa MCP is configured."""+ def _mcporter_ok(self) -> bool:if not shutil.which("mcporter"):return Falsetry:- result = subprocess.run(- ["mcporter", "list"],- capture_output=True, text=True, timeout=10,+ r = subprocess.run(+ ["mcporter", "list"], capture_output=True, text=True, timeout=10)- return "exa" in result.stdout+ return "exa" in r.stdoutexcept Exception:return False- def _mcporter_call(self, tool_call: str, timeout: int = 30) -> str:- """Call an MCP tool via mcporter and return the output."""- result = subprocess.run(- ["mcporter", "call", tool_call],+ def _call(self, expr: str, timeout: int = 30) -> str:+ r = subprocess.run(+ ["mcporter", "call", expr],capture_output=True, text=True, timeout=timeout,)- if result.returncode != 0:- raise RuntimeError(result.stderr or result.stdout)- return result.stdout+ if r.returncode != 0:+ raise RuntimeError(r.stderr or r.stdout)+ return r.stdout++ # ── Channel interface ──def can_handle(self, url: str) -> bool:- return False # Search-only channel, doesn't read URLs+ return False # search-only- async def read(self, url: str, config=None) -> None:+ async def read(self, url: str, config=None):raise NotImplementedError("Exa is a search engine, not a reader")def check(self, config=None):- # Priority 1: mcporter- if self._has_mcporter_exa():- return "ok", "MCP 已连接,免 Key 直接可用(全网搜索 + Reddit + Twitter)"-- # Priority 2: API key- key = None- if config:- key = config.get("exa_api_key")- if not key:- key = os.environ.get("EXA_API_KEY")- if key:- return "ok", "API Key 已配置,全网搜索可用"-- return "off", "注册 exa.ai 获取免费 Key,配置一下就能用。或安装 mcporter 免 Key 使用"-- 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- return ""+ if not shutil.which("mcporter"):+ return "off", (+ "需要 mcporter。安装:npm install -g mcporter && "+ "mcporter config add exa https://mcp.exa.ai/mcp"+ )+ if not self._mcporter_ok():+ return "off", "mcporter 已装但 Exa 未配置。运行:mcporter config add exa https://mcp.exa.ai/mcp"+ return "ok", "MCP 已连接,免 Key 直接可用(全网搜索 + Reddit + Twitter)"async def search(self, query: str, config=None, **kwargs) -> List[SearchResult]:- limit = kwargs.get("limit", 5)-- # Priority 1: mcporter + Exa MCP- if self._has_mcporter_exa():- return await self._search_via_mcp(query, limit)-- # Priority 2: Direct API- api_key = self._get_key(config)- if not api_key:+ if not self._mcporter_ok():raise ValueError(- "Exa search not configured.\n\n"- "Option 1 (easiest): Install mcporter — no API key needed:\n"- " npm install -g mcporter && mcporter config add exa https://mcp.exa.ai/mcp\n\n"- "Option 2: Get a free API key:\n"- " Sign up at https://exa.ai (1000 searches/month free)\n"- " Then run: agent-reach configure exa-key YOUR_KEY"+ "Exa 搜索需要 mcporter。安装:\n"+ " npm install -g mcporter\n"+ " mcporter config add exa https://mcp.exa.ai/mcp")- return await self._search_via_api(query, api_key, limit)-- async def _search_via_mcp(self, query: str, limit: int) -> List[SearchResult]:- """Search via mcporter + Exa MCP server."""- # Escape quotes in query- safe_query = query.replace('"', '\\"')- output = self._mcporter_call(- f'exa.web_search_exa(query: "{safe_query}", numResults: {min(limit, 10)})',+ limit = kwargs.get("limit", 5)+ safe_q = query.replace('"', '\\"')+ out = self._call(+ f'exa.web_search_exa(query: "{safe_q}", numResults: {min(limit, 10)})',timeout=30,)+ return self._parse_output(out, limit)++ # ── Parse mcporter text output ──- # mcporter returns formatted text blocks like:- # Title: ...- # URL: ...- # Published Date: ...- # Text: ...+ def _parse_output(self, text: str, limit: int) -> List[SearchResult]:+ """Parse mcporter's Title/URL/Text block format."""results = []- current = {}+ cur = {}- for line in output.split("\n"):+ for line in text.split("\n"):line = line.strip()if line.startswith("Title: "):- if current.get("title"):- results.append(SearchResult(- title=current.get("title", ""),- url=current.get("url", ""),- snippet=current.get("text", ""),- date=current.get("date", ""),- score=0,- ))- current = {"title": line[7:]}+ if cur.get("title"):+ results.append(self._make_result(cur))+ cur = {"title": line[7:]}elif line.startswith("URL: "):- current["url"] = line[5:]+ cur["url"] = line[5:]elif line.startswith("Published Date: "):- current["date"] = line[16:]+ cur["date"] = line[16:]elif line.startswith("Text: "):- current["text"] = line[6:]- elif current.get("text") is not None and line:- # Continue text block- current["text"] += " " + line-- # Don't forget the last entry- if current.get("title"):- results.append(SearchResult(- title=current.get("title", ""),- url=current.get("url", ""),- snippet=current.get("text", "")[:500],- date=current.get("date", ""),- score=0,- ))+ cur["text"] = line[6:]+ elif "text" in cur and line:+ cur["text"] += " " + line++ if cur.get("title"):+ results.append(self._make_result(cur))return results[:limit]- async def _search_via_api(self, query: str, api_key: str, limit: int) -> List[SearchResult]:- """Search via direct Exa API."""- 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,+ @staticmethod+ def _make_result(d: dict) -> SearchResult:+ return SearchResult(+ title=d.get("title", ""),+ url=d.get("url", ""),+ snippet=d.get("text", "")[:500],+ date=d.get("date", ""),+ score=0,)- 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 resultsdiff --git a/agent_reach/channels/xiaohongshu.py b/agent_reach/channels/xiaohongshu.pyindex 4406e3fb..634de37f 100644--- a/agent_reach/channels/xiaohongshu.py+++ b/agent_reach/channels/xiaohongshu.py@@ -1,120 +1,133 @@# -*- coding: utf-8 -*--"""XiaoHongShu (小红书) — via MCP server or cookie-based web scraping.+"""XiaoHongShu (小红书) — via mcporter + xiaohongshu MCP server.-Backend priority:-1. mcporter + xiaohongshu MCP server (internal API, reliable)-2. Direct web scraping with cookies (fallback, may be blocked by anti-bot)--Swap to: any XHS access method+Backend: xiaohongshu-mcp server (internal API, reliable)+Requires: mcporter CLI + xiaohongshu MCP server running"""-import reimport jsonimport shutilimport subprocess-import requestsfrom urllib.parse import urlparsefrom .base import Channel, ReadResult, SearchResult-from typing import List+from typing import List, Optionalclass XiaoHongShuChannel(Channel):name = "xiaohongshu"description = "小红书笔记"- backends = ["XHS MCP Server", "XHS Web API"]+ backends = ["xiaohongshu-mcp"]tier = 2- def _has_mcporter(self):- """Check if mcporter CLI is available and xiaohongshu MCP is configured."""+ def _mcporter_ok(self) -> bool:+ """Check if mcporter + xiaohongshu MCP is available."""if not shutil.which("mcporter"):return Falsetry:- result = subprocess.run(- ["mcporter", "list"],- capture_output=True, text=True, timeout=10,+ r = subprocess.run(+ ["mcporter", "list"], capture_output=True, text=True, timeout=10)- return "xiaohongshu" in result.stdout+ return "xiaohongshu" in r.stdoutexcept Exception:return False- def _mcporter_call(self, tool_call: str, timeout: int = 30) -> str:- """Call an MCP tool via mcporter and return the output."""- result = subprocess.run(- ["mcporter", "call", tool_call],+ def _call(self, expr: str, timeout: int = 30) -> str:+ r = subprocess.run(+ ["mcporter", "call", expr],capture_output=True, text=True, timeout=timeout,)- if result.returncode != 0:- raise RuntimeError(result.stderr or result.stdout)- return result.stdout+ if r.returncode != 0:+ raise RuntimeError(r.stderr or r.stdout)+ return r.stdout++ # ── Channel interface ──def can_handle(self, url: str) -> bool:- domain = urlparse(url).netloc.lower()- return "xiaohongshu.com" in domain or "xhslink.com" in domain+ d = urlparse(url).netloc.lower()+ return "xiaohongshu.com" in d or "xhslink.com" in ddef check(self, config=None):- if self._has_mcporter():- # Check login status- try:- output = self._mcporter_call("xiaohongshu.check_login_status()")- if "已登录" in output or "logged" in output.lower():- return "ok", "MCP 已连接,完整可用(阅读、搜索、发帖、评论、点赞)"- else:- return "warn", "MCP 已连接但未登录。运行 agent-reach 后用小红书扫码登录"- except Exception:- return "warn", "mcporter 可用但小红书 MCP 连接失败,检查服务是否在运行"-- cookie = config.get("xhs_cookie") if config else None- if cookie:- return "ok", "Cookie 已配置(注意:服务器端可能被反爬拦截)"- return "off", "需要配置 Cookie 才能访问。导入浏览器 Cookie 即可:agent-reach configure --from-browser chrome"+ if not shutil.which("mcporter"):+ return "off", (+ "需要 mcporter + xiaohongshu-mcp。安装:\n"+ " npm install -g mcporter\n"+ " 详见 https://github.com/user/xiaohongshu-mcp"+ )+ if not self._mcporter_ok():+ return "off", (+ "mcporter 已装但小红书 MCP 未配置。运行:\n"+ " mcporter config add xiaohongshu http://localhost:18060/mcp"+ )+ try:+ out = self._call("xiaohongshu.check_login_status()", timeout=10)+ if "已登录" in out or "logged" in out.lower():+ return "ok", "完整可用(阅读、搜索、发帖、评论、点赞)"+ return "warn", "MCP 已连接但未登录,需扫码登录"+ except Exception:+ return "warn", "MCP 连接异常,检查 xiaohongshu-mcp 服务是否在运行"async def read(self, url: str, config=None) -> ReadResult:+ if not self._mcporter_ok():+ return ReadResult(+ title="XiaoHongShu",+ content=(+ "⚠️ 小红书需要 mcporter + xiaohongshu-mcp 才能使用。\n\n"+ "安装步骤:\n"+ "1. npm install -g mcporter\n"+ "2. 安装 xiaohongshu-mcp 服务\n"+ "3. mcporter config add xiaohongshu http://localhost:18060/mcp\n"+ "4. 运行 agent-reach install --env=auto"+ ),+ url=url, platform="xiaohongshu",+ )+note_id = self._extract_note_id(url)+ if not note_id:+ return ReadResult(+ title="XiaoHongShu",+ content=f"⚠️ 无法从 URL 提取笔记 ID: {url}",+ url=url, platform="xiaohongshu",+ )- # Priority 1: mcporter + MCP server- if self._has_mcporter() and note_id:- try:- return await self._read_via_mcp(note_id, url)- except Exception:- pass # Fall through to web scraping+ # Step 1: get xsec_token from feeds+ xsec_token = self._find_token(note_id)- # Priority 2: Web scraping with cookies- cookie = config.get("xhs_cookie") if config else None- if not cookie:+ if not xsec_token:return ReadResult(title="XiaoHongShu",- content="⚠️ XiaoHongShu requires cookies to access.\n"- "Set up: agent-reach configure xhs-cookie \"YOUR_COOKIE_STRING\"\n"- "How to get it: install Cookie-Editor extension → go to xiaohongshu.com → Export → Header String\n\n"- "💡 Tip: If you have mcporter + xiaohongshu MCP server, it works without cookies.\n"- "Install: pip install mcporter && mcporter config add xiaohongshu http://localhost:18060/mcp",- url=url,- platform="xiaohongshu",+ content=(+ f"⚠️ 无法获取笔记 {note_id} 的访问令牌。\n"+ "小红书需要 xsec_token 才能读取笔记详情。\n"+ "请先通过搜索找到这篇笔记,或直接使用搜索功能。"+ ),+ url=url, platform="xiaohongshu",)- if not note_id:- from agent_reach.channels.web import WebChannel- return await WebChannel().read(url, config)+ # Step 2: get detail+ out = self._call(+ f'xiaohongshu.get_feed_detail(feed_id: "{note_id}", xsec_token: "{xsec_token}")',+ timeout=15,+ )- return await self._read_via_web(note_id, url, cookie)+ return ReadResult(+ title=self._extract_title(out) or f"XHS {note_id}",+ content=out.strip(),+ url=url, platform="xiaohongshu",+ )async def search(self, query: str, config=None, **kwargs) -> List[SearchResult]:- """Search XiaoHongShu via MCP server."""- if not self._has_mcporter():+ if not self._mcporter_ok():raise ValueError(- "XiaoHongShu search requires mcporter + xiaohongshu MCP server.\n"- "Install: pip install mcporter && mcporter config add xiaohongshu http://localhost:18060/mcp"+ "小红书搜索需要 mcporter + xiaohongshu-mcp。\n"+ "安装: npm install -g mcporter && mcporter config add xiaohongshu http://localhost:18060/mcp")-limit = kwargs.get("limit", 10)- output = self._mcporter_call(- f'xiaohongshu.search_feeds(keyword: "{query}")',- timeout=30,- )+ safe_q = query.replace('"', '\\"')+ out = self._call(f'xiaohongshu.search_feeds(keyword: "{safe_q}")', timeout=30)results = []try:- data = json.loads(output)+ data = json.loads(out)for item in data.get("feeds", [])[:limit]:card = item.get("noteCard", {})user = card.get("user", {})@@ -127,150 +140,29 @@ class XiaoHongShuChannel(Channel):))except (json.JSONDecodeError, KeyError):pass-return results- async def _read_via_mcp(self, note_id: str, url: str) -> ReadResult:- """Read a note via MCP server: search → get xsec_token → get detail."""- # Step 1: Get xsec_token by listing feeds or searching- # Try to find the note in recent feeds first- output = self._mcporter_call("xiaohongshu.list_feeds()", timeout=15)- xsec_token = None+ # ── Helpers ──++ def _extract_note_id(self, url: str) -> str:+ parts = urlparse(url).path.strip("/").split("/")+ return parts[-1] if parts else ""+ def _find_token(self, note_id: str) -> Optional[str]:+ """Try to find xsec_token for a note from feeds."""try:- data = json.loads(output)+ out = self._call("xiaohongshu.list_feeds()", timeout=15)+ data = json.loads(out)for feed in data.get("feeds", []):if feed.get("id") == note_id:- xsec_token = feed.get("xsecToken", "")- break- except (json.JSONDecodeError, KeyError):+ return feed.get("xsecToken", "")+ except Exception:pass+ return None- # If not found in feeds, search for it- if not xsec_token:- # Use a generic token - XHS MCP may accept it- xsec_token = ""-- if not xsec_token:- return ReadResult(- title="XiaoHongShu",- content=f"⚠️ 无法获取笔记 {note_id} 的访问令牌。\n"- "请先通过首页或搜索找到这篇笔记。",- url=url,- platform="xiaohongshu",- )-- # Step 2: Get detail- output = self._mcporter_call(- f'xiaohongshu.get_feed_detail(feed_id: "{note_id}", xsec_token: "{xsec_token}")',- timeout=15,- )-- # Parse MCP output (it's typically formatted text, not JSON)- title = ""- content = output.strip()- author = ""-- # Try to extract structured info if it's JSON- try:- data = json.loads(output)- if isinstance(data, dict):- title = data.get("title", data.get("displayTitle", ""))- content = data.get("desc", data.get("content", output))- author = data.get("user", {}).get("nickname", "")- except (json.JSONDecodeError, ValueError):- # MCP returns plain text - use as-is- lines = content.split("\n")- if lines:- title = lines[0][:80]-- return ReadResult(- title=title or f"XHS Note {note_id}",- content=content,- url=url,- author=author,- platform="xiaohongshu",- )-- async def _read_via_web(self, note_id: str, url: str, cookie: str) -> ReadResult:- """Read a note via direct web scraping (fallback)."""- headers = {- "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36",- "Cookie": cookie,- "Referer": "https://www.xiaohongshu.com/",- }-- resp = requests.get(- f"https://www.xiaohongshu.com/explore/{note_id}",- headers=headers,- timeout=15,- allow_redirects=False,- )-- # Check for anti-bot redirect- if resp.status_code in (301, 302):- location = resp.headers.get("Location", "")- if "404" in location or "sec_" in location:- return ReadResult(- title="XiaoHongShu",- content="⚠️ XiaoHongShu blocked this request (anti-bot protection).\n"- "Web scraping doesn't work from server IPs.\n\n"- "💡 Better approach: use mcporter + xiaohongshu MCP server:\n"- " mcporter config add xiaohongshu http://localhost:18060/mcp\n"- " Then agent-reach will use the MCP API automatically.",- url=url,- platform="xiaohongshu",- )-- resp.raise_for_status()- html = resp.text-- title, content, author = self._parse_html(html)-- return ReadResult(- title=title or f"XHS Note {note_id}",- content=content or "Could not extract content. Cookie may be expired.",- url=url,- author=author,- platform="xiaohongshu",- )-- def _extract_note_id(self, url: str) -> str:- """Extract note ID from various XHS URL formats."""- path = urlparse(url).path- parts = path.strip("/").split("/")- if parts:- return parts[-1]+ def _extract_title(self, text: str) -> str:+ for line in text.split("\n"):+ line = line.strip()+ if line and not line.startswith(("{", "[", "#", "http")):+ return line[:80]return ""-- def _parse_html(self, html: str):- """Extract title, content, author from XHS HTML."""- title = ""- content = ""- author = ""-- match = re.search(r'window\.__INITIAL_STATE__\s*=\s*({.*?})\s*</script>', html, re.DOTALL)- if match:- try:- state = json.loads(match.group(1).replace('undefined', 'null'))- note_data = state.get("note", {}).get("noteDetailMap", {})- if note_data:- first_note = list(note_data.values())[0]- note = first_note.get("note", {})- title = note.get("title", "")- content = note.get("desc", "")- author = note.get("user", {}).get("nickname", "")- except (json.JSONDecodeError, KeyError, IndexError):- pass-- if not title:- m = re.search(r'<title>(.*?)</title>', html)- if m:- title = m.group(1)-- if not content:- m = re.search(r'<meta name="description" content="(.*?)"', html)- if m:- content = m.group(1)-- return title, content, authordiff --git a/agent_reach/cli.py b/agent_reach/cli.pyindex 3ed51057..e1e791ca 100644--- a/agent_reach/cli.py+++ b/agent_reach/cli.py@@ -73,18 +73,14 @@ def main():p_install = sub.add_parser("install", help="One-shot installer with flags")p_install.add_argument("--env", choices=["local", "server", "auto"], default="auto",help="Environment: local, server, or auto-detect")- p_install.add_argument("--search", choices=["yes", "no"], default="yes",- help="Enable web search (needs free Exa API key)")p_install.add_argument("--proxy", default="",help="Residential proxy for Reddit/Bilibili (http://user:pass@ip:port)")- p_install.add_argument("--exa-key", default="",- help="Exa API key (get free at https://exa.ai)")# ── configure ──p_conf = sub.add_parser("configure", help="Set a config value or auto-extract from browser")p_conf.add_argument("key", nargs="?", default=None,- choices=["exa-key", "proxy", "github-token", "groq-key",- "twitter-cookies", "xhs-cookie", "youtube-cookies"],+ choices=["proxy", "github-token", "groq-key",+ "twitter-cookies", "youtube-cookies"],help="What to configure (omit if using --from-browser)")p_conf.add_argument("value", nargs="*", help="The value(s) to set")p_conf.add_argument("--from-browser", metavar="BROWSER",@@ -149,21 +145,14 @@ def _cmd_install(args):print(f"💻 Environment: Local computer (auto-detected)")# Apply explicit flags- if args.exa_key:- config.set("exa_api_key", args.exa_key)- print(f"✅ Exa search key configured")-if args.proxy:config.set("reddit_proxy", args.proxy)config.set("bilibili_proxy", args.proxy)print(f"✅ Proxy configured for Reddit + Bilibili")- # Auto-detect Exa key from environment- if not config.get("exa_api_key") and not args.exa_key:- env_key = os.environ.get("EXA_API_KEY") or os.environ.get("exa_api_key")- if env_key:- config.set("exa_api_key", env_key)- print(f"✅ Exa key auto-detected from environment")+ # ── mcporter (for Exa search + XiaoHongShu) ──+ print()+ _install_mcporter()# Auto-import cookies on local computersif env == "local":@@ -204,13 +193,6 @@ def _cmd_install(args):ok = sum(1 for r in results.values() if r["status"] == "ok")total = len(results)- # What's missing — only mention Exa if not configured- if not config.get("exa_api_key"):- print()- print("🔍 Recommended: unlock search with a free Exa API key")- print(" agent-reach configure exa-key YOUR_KEY")- print(" Get free key: https://exa.ai")-# Final statusprint()print(format_report(results))@@ -218,6 +200,74 @@ def _cmd_install(args):print(f"✅ Installation complete! {ok}/{total} channels active.")+def _install_mcporter():+ """Install mcporter and configure Exa + XiaoHongShu MCP servers."""+ import shutil+ import subprocess++ print("📦 Setting up mcporter (search + XiaoHongShu backend)...")++ if shutil.which("mcporter"):+ print(" ✅ mcporter already installed")+ else:+ # Check for npm/npx+ if not shutil.which("npm") and not shutil.which("npx"):+ print(" ⚠️ mcporter requires Node.js. Install Node.js first:")+ print(" https://nodejs.org/ or: curl -fsSL https://fnm.vercel.app/install | bash")+ return+ try:+ subprocess.run(+ ["npm", "install", "-g", "mcporter"],+ capture_output=True, text=True, timeout=60,+ )+ if shutil.which("mcporter"):+ print(" ✅ mcporter installed")+ else:+ print(" ❌ mcporter install failed. Try manually: npm install -g mcporter")+ return+ except Exception as e:+ print(f" ❌ mcporter install failed: {e}")+ return++ # Configure Exa MCP (free, no key needed)+ try:+ r = subprocess.run(+ ["mcporter", "list"], capture_output=True, text=True, timeout=10+ )+ if "exa" not in r.stdout:+ subprocess.run(+ ["mcporter", "config", "add", "exa", "https://mcp.exa.ai/mcp"],+ capture_output=True, text=True, timeout=10,+ )+ print(" ✅ Exa search configured (free, no API key needed)")+ else:+ print(" ✅ Exa search already configured")+ except Exception:+ print(" ⚠️ Could not configure Exa. Run manually: mcporter config add exa https://mcp.exa.ai/mcp")++ # Check XiaoHongShu MCP (only if server is running)+ try:+ r = subprocess.run(+ ["mcporter", "list"], capture_output=True, text=True, timeout=10+ )+ if "xiaohongshu" in r.stdout:+ print(" ✅ XiaoHongShu MCP already configured")+ else:+ # Check if XHS MCP server is running on localhost:18060+ import requests+ try:+ requests.get("http://localhost:18060/", timeout=3)+ subprocess.run(+ ["mcporter", "config", "add", "xiaohongshu", "http://localhost:18060/mcp"],+ capture_output=True, text=True, timeout=10,+ )+ print(" ✅ XiaoHongShu MCP auto-detected and configured")+ except Exception:+ print(" ⬜ XiaoHongShu MCP not detected (optional — install xiaohongshu-mcp for XHS support)")+ except Exception:+ pass++def _detect_environment():"""Auto-detect if running on local computer or server."""import os@@ -323,23 +373,6 @@ def _cmd_configure(args):except Exception as e:print(f"❌ Failed: {e}")- elif args.key == "exa-key":- config.set("exa_api_key", value)- print(f"✅ Exa key configured!")-- print("Testing search...", end=" ")- try:- import asyncio- from agent_reach.core import AgentReach- eyes = AgentReach(config)- results = asyncio.run(eyes.search("test", num_results=1))- if results:- print("✅ Search works!")- else:- print("⚠️ No results, but API connected.")- except Exception as e:- print(f"❌ Failed: {e}")-elif args.key == "twitter-cookies":# Accept two formats:# 1. auth_token ct0 (two separate values)@@ -387,28 +420,6 @@ def _cmd_configure(args):print(" 1. agent-reach configure twitter-cookies AUTH_TOKEN CT0")print(' 2. agent-reach configure twitter-cookies "auth_token=xxx; ct0=yyy; ..."')- elif args.key == "xhs-cookie":- config.set("xhs_cookie", value)- print(f"✅ XiaoHongShu cookie configured!")-- print("Testing XHS access...", end=" ")- try:- import requests- resp = requests.get(- "https://www.xiaohongshu.com/",- headers={- "User-Agent": "Mozilla/5.0",- "Cookie": value,- },- timeout=10,- )- if resp.status_code == 200 and "xiaohongshu" in resp.text.lower():- print("✅ XiaoHongShu works!")- else:- print(f"⚠️ Got status {resp.status_code}, cookie might be expired")- except Exception as e:- print(f"❌ Failed: {e}")-elif args.key == "youtube-cookies":config.set("youtube_cookies_from", value)print(f"✅ YouTube cookie source configured: {value}")diff --git a/agent_reach/doctor.py b/agent_reach/doctor.pyindex 76c04cb2..c4e87963 100644--- a/agent_reach/doctor.py+++ b/agent_reach/doctor.py@@ -49,12 +49,12 @@ def format_report(results: Dict[str, dict]) -> str:tier1 = {k: r for k, r in results.items() if r["tier"] == 1}if tier1:lines.append("")- lines.append("🔍 搜索(免费 Exa Key 即可解锁):")+ lines.append("🔍 搜索(mcporter 即可解锁):")for key, r in tier1.items():if r["status"] == "ok":- lines.append(f" ✅ {r['name']}")+ lines.append(f" ✅ {r['name']} — {r['message']}")else:- lines.append(f" ⬜ {r['name']} — 注册 exa.ai 获取免费 Key,配置一下就能用")+ lines.append(f" ⬜ {r['name']} — {r['message']}")# Tier 2 — optional setuptier2 = {k: r for k, r in results.items() if r["tier"] == 2}