# -*- coding: utf-8 -*- """ Agent Reach CLI โ€” command-line interface. Usage: agent-reach read agent-reach search agent-reach search-reddit [--sub ] agent-reach search-github [--lang ] agent-reach search-twitter agent-reach setup agent-reach doctor agent-reach version """ import sys import asyncio import argparse import json import os from agent_reach import __version__ def _configure_logging(verbose: bool = False): """Suppress loguru output unless --verbose is set.""" from loguru import logger logger.remove() # Remove default stderr handler if verbose: logger.add(sys.stderr, level="INFO") def main(): parser = argparse.ArgumentParser( prog="agent-reach", description="๐Ÿ‘๏ธ Give your AI Agent eyes to see the entire internet", ) parser.add_argument("-v", "--verbose", action="store_true", help="Show debug logs") parser.add_argument("--version", action="version", version=f"Agent Reach v{__version__}") sub = parser.add_subparsers(dest="command", help="Available commands") # โ”€โ”€ read โ”€โ”€ p_read = sub.add_parser("read", help="Read content from a URL") p_read.add_argument("url", help="URL to read") p_read.add_argument("--json", dest="as_json", action="store_true", help="Output as JSON") # โ”€โ”€ search โ”€โ”€ p_search = sub.add_parser("search", help="Search the web (Exa)") p_search.add_argument("query", nargs="+", help="Search query") p_search.add_argument("-n", "--num", type=int, default=5, help="Number of results") # โ”€โ”€ search-reddit โ”€โ”€ p_sr = sub.add_parser("search-reddit", help="Search Reddit") p_sr.add_argument("query", nargs="+", help="Search query") p_sr.add_argument("--sub", help="Subreddit filter") p_sr.add_argument("-n", "--num", type=int, default=10, help="Number of results") # โ”€โ”€ search-github โ”€โ”€ p_sg = sub.add_parser("search-github", help="Search GitHub") p_sg.add_argument("query", nargs="+", help="Search query") p_sg.add_argument("--lang", help="Language filter") p_sg.add_argument("-n", "--num", type=int, default=5, help="Number of results") # โ”€โ”€ search-twitter โ”€โ”€ p_st = sub.add_parser("search-twitter", help="Search Twitter") p_st.add_argument("query", nargs="+", help="Search query") p_st.add_argument("-n", "--num", type=int, default=10, help="Number of results") # โ”€โ”€ search-youtube โ”€โ”€ p_sy = sub.add_parser("search-youtube", help="Search YouTube") p_sy.add_argument("query", nargs="+", help="Search query") p_sy.add_argument("-n", "--num", type=int, default=5, help="Number of results") # โ”€โ”€ search-bilibili โ”€โ”€ p_sb = sub.add_parser("search-bilibili", help="Search Bilibili") p_sb.add_argument("query", nargs="+", help="Search query") p_sb.add_argument("-n", "--num", type=int, default=5, help="Number of results") # โ”€โ”€ search-xhs โ”€โ”€ p_sx = sub.add_parser("search-xhs", help="Search XiaoHongShu") p_sx.add_argument("query", nargs="+", help="Search query") p_sx.add_argument("-n", "--num", type=int, default=10, help="Number of results") # โ”€โ”€ setup โ”€โ”€ sub.add_parser("setup", help="Interactive configuration wizard") # โ”€โ”€ install โ”€โ”€ 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("--proxy", default="", help="Residential proxy for Reddit/Bilibili (http://user:pass@ip:port)") # โ”€โ”€ 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=["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", choices=["chrome", "firefox", "edge", "brave", "opera"], help="Auto-extract ALL platform cookies from browser (chrome/firefox/edge/brave/opera)") # โ”€โ”€ doctor โ”€โ”€ sub.add_parser("doctor", help="Check platform availability") # โ”€โ”€ version โ”€โ”€ sub.add_parser("version", help="Show version") args = parser.parse_args() # Suppress loguru noise unless --verbose _configure_logging(getattr(args, "verbose", False)) if not args.command: parser.print_help() sys.exit(0) if args.command == "version": print(f"Agent Reach v{__version__}") sys.exit(0) if args.command == "doctor": _cmd_doctor() elif args.command == "setup": _cmd_setup() elif args.command == "install": _cmd_install(args) elif args.command == "configure": _cmd_configure(args) elif args.command == "read": asyncio.run(_cmd_read(args)) elif args.command.startswith("search"): asyncio.run(_cmd_search(args)) # โ”€โ”€ Command handlers โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€ def _cmd_install(args): """One-shot deterministic installer.""" import os from agent_reach.config import Config from agent_reach.doctor import check_all, format_report config = Config() print() print("๐Ÿ‘๏ธ Agent Reach Installer") print("=" * 40) # Auto-detect environment env = args.env if env == "auto": env = _detect_environment() if env == "server": print(f"๐Ÿ“ก Environment: Server/VPS (auto-detected)") else: print(f"๐Ÿ’ป Environment: Local computer (auto-detected)") # Apply explicit flags if args.proxy: config.set("reddit_proxy", args.proxy) config.set("bilibili_proxy", args.proxy) print(f"โœ… Proxy configured for Reddit + Bilibili") # โ”€โ”€ Install system dependencies โ”€โ”€ print() _install_system_deps() # โ”€โ”€ mcporter (for Exa search + XiaoHongShu) โ”€โ”€ print() _install_mcporter() # Auto-import cookies on local computers if env == "local": print() print("๐Ÿช Trying to import cookies from browser...") try: from agent_reach.cookie_extract import configure_from_browser results = configure_from_browser("chrome", config) found = False for platform, success, message in results: if success: print(f" โœ… {platform}: {message}") found = True if not found: # Try firefox results = configure_from_browser("firefox", config) for platform, success, message in results: if success: print(f" โœ… {platform}: {message}") found = True if not found: print(" โฌœ No cookies found (normal if you haven't logged into these sites)") except Exception: print(" โฌœ Could not read browser cookies (browser might be open)") # Environment-specific advice if env == "server": print() print("๐Ÿ’ก Tip: Reddit and Bilibili block server IPs.") print(" Reddit search still works via Exa (free).") print(" For full access: agent-reach configure proxy http://user:pass@ip:port") print(" Cheap option: https://www.webshare.io ($1/month)") # Test channels print() print("Testing channels...") results = check_all(config) ok = sum(1 for r in results.values() if r["status"] == "ok") total = len(results) # Final status print() print(format_report(results)) print() print(f"โœ… Installation complete! {ok}/{total} channels active.") if ok < total: print() print("๐Ÿค– Some channels are not active yet. If you're an AI Agent, try to fix them yourself โ€” then run `agent-reach doctor` again.") def _install_system_deps(): """Install system-level dependencies: gh CLI, Node.js (for mcporter).""" import shutil import subprocess import platform print("๐Ÿ”ง Checking system dependencies...") # โ”€โ”€ gh CLI โ”€โ”€ if shutil.which("gh"): print(" โœ… gh CLI already installed") else: print(" ๐Ÿ“ฅ Installing gh CLI...") os_type = platform.system().lower() if os_type == "linux": try: # Official GitHub method for Linux cmds = [ "curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | dd of=/usr/share/keyrings/githubcli-archive-keyring.gpg 2>/dev/null", 'echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | tee /etc/apt/sources.list.d/github-cli.list > /dev/null', "apt-get update -qq 2>/dev/null", "apt-get install -y -qq gh 2>/dev/null", ] for cmd in cmds: subprocess.run(cmd, shell=True, capture_output=True, timeout=60) if shutil.which("gh"): print(" โœ… gh CLI installed") else: print(" โš ๏ธ gh CLI install failed. You can try: snap install gh, or download from https://github.com/cli/cli/releases") except Exception: print(" โš ๏ธ gh CLI install failed. You can try: snap install gh, or download from https://github.com/cli/cli/releases") elif os_type == "darwin": if shutil.which("brew"): try: subprocess.run(["brew", "install", "gh"], capture_output=True, timeout=120) if shutil.which("gh"): print(" โœ… gh CLI installed") else: print(" โš ๏ธ gh CLI install failed. Try: brew install gh") except Exception: print(" โš ๏ธ gh CLI install failed. Try: brew install gh") else: print(" โš ๏ธ gh CLI not found. Install: https://cli.github.com") else: print(" โš ๏ธ gh CLI not found. Install: https://cli.github.com") # โ”€โ”€ Node.js (needed for mcporter) โ”€โ”€ if shutil.which("node") and shutil.which("npm"): print(" โœ… Node.js already installed") else: print(" ๐Ÿ“ฅ Installing Node.js...") try: # Use NodeSource for quick install subprocess.run( "curl -fsSL https://deb.nodesource.com/setup_22.x | bash - 2>/dev/null && apt-get install -y -qq nodejs 2>/dev/null", shell=True, capture_output=True, timeout=120, ) if shutil.which("node"): print(" โœ… Node.js installed") else: print(" โš ๏ธ Node.js install failed. Try: apt install nodejs npm, or nvm install 22, or download from https://nodejs.org") except Exception: print(" โš ๏ธ Node.js install failed. Try: apt install nodejs npm, or nvm install 22, or download from https://nodejs.org") # โ”€โ”€ birdx (for Twitter search) โ”€โ”€ if shutil.which("birdx"): print(" โœ… birdx already installed") else: if shutil.which("pip3") or shutil.which("pip"): pip_cmd = "pip3" if shutil.which("pip3") else "pip" try: subprocess.run( [pip_cmd, "install", "-q", "birdx"], capture_output=True, text=True, timeout=120, ) if shutil.which("birdx"): print(" โœ… birdx installed (Twitter search + timeline)") else: print(" โฌœ birdx install failed (optional โ€” Twitter reading still works via Jina)") except Exception: print(" โฌœ birdx install failed (optional โ€” Twitter reading still works via Jina)") 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=120, ) if shutil.which("mcporter"): print(" โœ… mcporter installed") else: print(" โŒ mcporter install failed. Retry: npm install -g mcporter (check network/timeout), or try: npx mcporter@latest list") 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 # Check common server indicators indicators = 0 # SSH session if os.environ.get("SSH_CONNECTION") or os.environ.get("SSH_CLIENT"): indicators += 2 # Docker / container if os.path.exists("/.dockerenv") or os.path.exists("/run/.containerenv"): indicators += 2 # No display (headless) if not os.environ.get("DISPLAY") and not os.environ.get("WAYLAND_DISPLAY"): indicators += 1 # Cloud VM identifiers for cloud_file in ["/sys/hypervisor/uuid", "/sys/class/dmi/id/product_name"]: if os.path.exists(cloud_file): try: content = open(cloud_file).read().lower() if any(x in content for x in ["amazon", "google", "microsoft", "digitalocean", "linode", "vultr", "hetzner"]): indicators += 2 except: pass # systemd-detect-virt try: import subprocess result = subprocess.run(["systemd-detect-virt"], capture_output=True, text=True, timeout=3) if result.returncode == 0 and result.stdout.strip() != "none": indicators += 1 except: pass return "server" if indicators >= 2 else "local" def _cmd_configure(args): """Set a config value and test it, or auto-extract from browser.""" from agent_reach.config import Config config = Config() # โ”€โ”€ Auto-extract from browser โ”€โ”€ if args.from_browser: from agent_reach.cookie_extract import configure_from_browser browser = args.from_browser print(f"๐Ÿ” Extracting cookies from {browser}...") print() results = configure_from_browser(browser, config) found_any = False for platform, success, message in results: if success: print(f" โœ… {platform}: {message}") found_any = True else: print(f" โฌœ {platform}: {message}") print() if found_any: print("โœ… Cookies configured! Run `agent-reach doctor` to see updated status.") else: print(f"No cookies found. Make sure you're logged into the platforms in {browser}.") return # โ”€โ”€ Manual configure โ”€โ”€ if not args.key: print("Usage: agent-reach configure ") print(" or: agent-reach configure --from-browser chrome") return value = " ".join(args.value) if args.value else "" if not value: print(f"Missing value for {args.key}") return if args.key == "proxy": config.set("reddit_proxy", value) config.set("bilibili_proxy", value) print(f"โœ… Proxy configured for Reddit + Bilibili!") # Auto-test print("Testing Reddit access...", end=" ") try: import requests resp = requests.get( "https://www.reddit.com/r/test.json?limit=1", headers={"User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36"}, proxies={"http": value, "https": value}, timeout=10, ) if resp.status_code == 200: print("โœ… Reddit works!") else: print(f"โš ๏ธ Reddit returned {resp.status_code}") except Exception as e: print(f"โŒ Failed: {e}") elif args.key == "twitter-cookies": # Accept two formats: # 1. auth_token ct0 (two separate values) # 2. Full cookie header string: "auth_token=xxx; ct0=yyy; ..." auth_token = None ct0 = None if "auth_token=" in value and "ct0=" in value: # Full cookie string โ€” parse it for part in value.replace(";", " ").split(): if part.startswith("auth_token="): auth_token = part.split("=", 1)[1] elif part.startswith("ct0="): ct0 = part.split("=", 1)[1] elif len(value.split()) == 2 and "=" not in value: # Two separate values: AUTH_TOKEN CT0 parts = value.split() auth_token = parts[0] ct0 = parts[1] if auth_token and ct0: config.set("twitter_auth_token", auth_token) config.set("twitter_ct0", ct0) print(f"โœ… Twitter cookies configured!") print("Testing Twitter access...", end=" ") try: import subprocess result = subprocess.run( ["birdx", "search", "test", "-n", "1", "--auth-token", auth_token, "--ct0", ct0], capture_output=True, text=True, timeout=15, ) if result.returncode == 0 and result.stdout.strip(): print("โœ… Twitter Advanced works!") else: print(f"โš ๏ธ Test returned no results (cookies might be wrong)") except FileNotFoundError: print("โš ๏ธ birdx not installed. Run: pip install birdx") except Exception as e: print(f"โŒ Failed: {e}") else: print("โŒ Could not find auth_token and ct0 in your input.") print(" Accepted formats:") 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 == "youtube-cookies": config.set("youtube_cookies_from", value) print(f"โœ… YouTube cookie source configured: {value}") print(" yt-dlp will use cookies from this browser for age-restricted/member videos.") elif args.key == "github-token": config.set("github_token", value) print(f"โœ… GitHub token configured!") elif args.key == "groq-key": config.set("groq_api_key", value) print(f"โœ… Groq key configured!") def _cmd_doctor(): from agent_reach.config import Config from agent_reach.doctor import check_all, format_report config = Config() results = check_all(config) print(format_report(results)) def _cmd_setup(): from agent_reach.config import Config config = Config() print() print("๐Ÿ‘๏ธ Agent Reach Setup") print("=" * 40) print() # Step 1: Exa print("ใ€ๆŽจ่ใ€‘ๅ…จ็ฝ‘ๆœ็ดข โ€” Exa Search API") print(" ๅ…่ดน 1000 ๆฌก/ๆœˆ๏ผŒๆณจๅ†Œๅœฐๅ€: https://exa.ai") current = config.get("exa_api_key") if current: print(f" ๅฝ“ๅ‰็Šถๆ€: โœ… ๅทฒ้…็ฝฎ ({current[:8]}...)") change = input(" ่ฆๆ›ดๆขๅ—๏ผŸ[y/N]: ").strip().lower() if change != "y": print() else: key = input(" EXA_API_KEY: ").strip() if key: config.set("exa_api_key", key) print(" โœ… ๅทฒๆ›ดๆ–ฐ๏ผ") print() else: print(" ๅฝ“ๅ‰็Šถๆ€: โฌœ ๆœช้…็ฝฎ") key = input(" EXA_API_KEY (ๅ›ž่ฝฆ่ทณ่ฟ‡): ").strip() if key: config.set("exa_api_key", key) print(" โœ… ๅ…จ็ฝ‘ๆœ็ดข + Redditๆœ็ดข + Twitterๆœ็ดข ๅทฒๅผ€ๅฏ๏ผ") else: print(" โ„น๏ธ ่ทณ่ฟ‡ใ€‚็จๅŽๅฏ่ฟ่กŒ agent-reach setup ้…็ฝฎ") print() # Step 2: GitHub token print("ใ€ๅฏ้€‰ใ€‘GitHub Token โ€” ๆ้ซ˜ API ้™้ข") print(" ๆ—  token: 60 ๆฌก/ๅฐๆ—ถ | ๆœ‰ token: 5000 ๆฌก/ๅฐๆ—ถ") print(" ่Žทๅ–: https://github.com/settings/tokens (ๆ— ้œ€ไปปไฝ•ๆƒ้™)") current = config.get("github_token") if current: print(f" ๅฝ“ๅ‰็Šถๆ€: โœ… ๅทฒ้…็ฝฎ") else: key = input(" GITHUB_TOKEN (ๅ›ž่ฝฆ่ทณ่ฟ‡): ").strip() if key: config.set("github_token", key) print(" โœ… GitHub API ๅทฒๆๅ‡่‡ณ 5000 ๆฌก/ๅฐๆ—ถ๏ผ") else: print(" โ„น๏ธ ่ทณ่ฟ‡ใ€‚ๅ…ฌๅผ€ API ไนŸ่ƒฝ็”จ") print() # Step 3: Reddit proxy print("ใ€ๅฏ้€‰ใ€‘Reddit ไปฃ็† โ€” ๅฎŒๆ•ด้˜…่ฏป Reddit ๅธ–ๅญ+่ฏ„่ฎบ") print(" Reddit ๅฐ้”ๅพˆๅคš IP๏ผŒ้œ€่ฆ ISP ไปฃ็†ๆ‰่ƒฝ็›ดๆŽฅ่ฎฟ้—ฎ") print(" ๆ ผๅผ: http://็”จๆˆทๅ:ๅฏ†็ @IP:็ซฏๅฃ") current = config.get("reddit_proxy") if current: print(f" ๅฝ“ๅ‰็Šถๆ€: โœ… ๅทฒ้…็ฝฎ") else: proxy = input(" REDDIT_PROXY (ๅ›ž่ฝฆ่ทณ่ฟ‡): ").strip() if proxy: config.set("reddit_proxy", proxy) print(" โœ… Reddit ๅฎŒๆ•ด้˜…่ฏปๅทฒๅผ€ๅฏ๏ผ") else: print(" โ„น๏ธ ่ทณ่ฟ‡ใ€‚ไปๅฏ้€š่ฟ‡ๆœ็ดข่Žทๅ– Reddit ๅ†…ๅฎน") print() # Step 4: Groq (Whisper) print("ใ€ๅฏ้€‰ใ€‘Groq API โ€” ่ง†้ข‘ๆ— ๅญ—ๅน•ๆ—ถ็š„่ฏญ้Ÿณ่ฝฌๆ–‡ๅญ—") print(" ๅ…่ดน้ขๅบฆ๏ผŒๆณจๅ†Œ: https://console.groq.com") current = config.get("groq_api_key") if current: print(f" ๅฝ“ๅ‰็Šถๆ€: โœ… ๅทฒ้…็ฝฎ") else: key = input(" GROQ_API_KEY (ๅ›ž่ฝฆ่ทณ่ฟ‡): ").strip() if key: config.set("groq_api_key", key) print(" โœ… ่ฏญ้Ÿณ่ฝฌๆ–‡ๅญ—ๅทฒๅผ€ๅฏ๏ผ") else: print(" โ„น๏ธ ่ทณ่ฟ‡") print() # Summary print("=" * 40) print(f"โœ… ้…็ฝฎๅทฒไฟๅญ˜ๅˆฐ {config.config_path}") print("่ฟ่กŒ agent-reach doctor ๆŸฅ็œ‹ๅฎŒๆ•ด็Šถๆ€") print() async def _cmd_read(args): from agent_reach.core import AgentReach eyes = AgentReach() try: result = await eyes.read(args.url) if args.as_json: print(json.dumps(result, ensure_ascii=False, indent=2)) else: print(f"\n๐Ÿ“– {result.get('title', 'Untitled')}") print(f"๐Ÿ”— {result.get('url', '')}") if result.get("author"): print(f"๐Ÿ‘ค {result['author']}") print(f"\n{result.get('content', '')}") except Exception as e: error_str = str(e) if "400" in error_str and "Bad Request" in error_str: print(f"โŒ Invalid URL: {args.url}", file=sys.stderr) print(" Please provide a valid URL (e.g., https://example.com)", file=sys.stderr) elif "ConnectionError" in type(e).__name__ or "Timeout" in type(e).__name__: print(f"โŒ Could not connect to: {args.url}", file=sys.stderr) print(" Check your internet connection or the URL.", file=sys.stderr) else: print(f"โŒ Error: {e}", file=sys.stderr) sys.exit(1) async def _cmd_search(args): from agent_reach.core import AgentReach eyes = AgentReach() query = " ".join(args.query).strip() num = args.num if not query: print("Please provide a search query.", file=sys.stderr) sys.exit(1) try: if args.command == "search": results = await eyes.search(query, num_results=num) elif args.command == "search-reddit": results = await eyes.search_reddit(query, subreddit=getattr(args, "sub", None), limit=num) elif args.command == "search-github": results = await eyes.search_github(query, language=getattr(args, "lang", None), limit=num) elif args.command == "search-twitter": results = await eyes.search_twitter(query, limit=num) elif args.command == "search-youtube": results = await eyes.search_youtube(query, limit=num) elif args.command == "search-bilibili": results = await eyes.search_bilibili(query, limit=num) elif args.command == "search-xhs": results = await eyes.search_xhs(query, limit=num) else: print(f"Unknown command: {args.command}", file=sys.stderr) sys.exit(1) except Exception as e: error_str = str(e) if "401" in error_str or "Unauthorized" in error_str: print("โš ๏ธ Exa API key not configured or invalid.") print("Get a free key at https://exa.ai (1000 searches/month free)") print("Then run: agent-reach configure exa-key YOUR_KEY") sys.exit(1) elif "exa" in error_str.lower() or "api_key" in error_str.lower(): print("โš ๏ธ Exa API key not configured.") print("Get a free key at https://exa.ai") print("Then run: agent-reach configure exa-key YOUR_KEY") sys.exit(1) else: print(f"โŒ Error: {e}", file=sys.stderr) sys.exit(1) if not results: print("No results found.") return for i, r in enumerate(results, 1): title = r.get("title") or r.get("name") or r.get("text", "")[:60] url = r.get("url", "") snippet = r.get("snippet") or r.get("description") or r.get("text", "") print(f"\n{i}. {title}") print(f" ๐Ÿ”— {url}") if snippet: print(f" {snippet[:200]}") # Extra info for GitHub extra = r.get("extra", {}) if extra.get("stars"): print(f" โญ {extra['stars']} ๐Ÿด {extra.get('forks', 0)} ๐Ÿ“ {extra.get('language', '')}") if __name__ == "__main__": main()