bmad-plus 0.7.4 → 0.8.0

package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/brightdata.py

@@ -1,101 +1,101 @@
-#!/usr/bin/env python3
-"""Bright Data MCP wrapper — scrape, search, search-geo, search-yandex. Stdlib only.
-
-Uses mcp-client.py for MCP JSON-RPC calls.
-"""
-
-import json
-import os
-import subprocess
-import sys
-
-sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
-from _http import get_key, get_workspace
-
-
-def init():
-    workspace, _, _ = get_workspace()
-    return get_key("BRIGHTDATA_MCP_URL",
-                   file_fallback=os.path.join(workspace, "scripts", "brightdata-mcp-url.txt"),
-                   help_url="https://brightdata.com/products/web-scraper/mcp")
-
-
-def mcp_call(mcp_url, tool_name, arguments):
-    """Call MCP tool via mcp-client.py."""
-    scripts_dir = os.path.dirname(os.path.abspath(__file__))
-    mcp_client = os.path.join(scripts_dir, "mcp-client.py")
-    args_json = json.dumps(arguments)
-    result = subprocess.run(
-        [sys.executable, mcp_client, mcp_url, tool_name, args_json],
-        capture_output=True, text=True, timeout=120
-    )
-    if result.stdout:
-        print(result.stdout)
-    if result.stderr:
-        print(result.stderr, file=sys.stderr)
-    return result.returncode
-
-
-def list_tools(mcp_url):
-    """List available MCP tools."""
-    scripts_dir = os.path.dirname(os.path.abspath(__file__))
-    mcp_client = os.path.join(scripts_dir, "mcp-client.py")
-    result = subprocess.run(
-        [sys.executable, mcp_client, mcp_url, "--list-tools"],
-        capture_output=True, text=True, timeout=30
-    )
-    if result.stdout:
-        print(result.stdout)
-    if result.stderr:
-        print(result.stderr, file=sys.stderr)
-
-
-def main():
-    if len(sys.argv) < 2:
-        print("Usage: brightdata.py {tools|scrape|scrape-batch|search|search-geo|search-yandex} <args>")
-        print()
-        print("  tools                     - list available MCP tools")
-        print("  scrape <url>              - any URL → markdown (bypasses CAPTCHA)")
-        print("  scrape-batch <url1> <url2> - batch scrape up to 10 URLs")
-        print("  search <query>            - Google search via Bright Data")
-        print("  search-geo <cc> <query>   - geo-targeted search")
-        print("  search-yandex <query>     - Yandex search")
-        sys.exit(1)
-
-    mcp_url = init()
-    cmd = sys.argv[1]
-
-    if cmd == "tools":
-        list_tools(mcp_url)
-    elif cmd == "scrape":
-        url = sys.argv[2] if len(sys.argv) > 2 else ""
-        if not url:
-            print("Usage: brightdata.py scrape <url>", file=sys.stderr)
-            sys.exit(1)
-        mcp_call(mcp_url, "scrape_as_markdown", {"url": url})
-    elif cmd == "scrape-batch":
-        urls = sys.argv[2:]
-        if not urls:
-            print("Usage: brightdata.py scrape-batch <url1> <url2>...", file=sys.stderr)
-            sys.exit(1)
-        mcp_call(mcp_url, "scrape_as_markdown_batch", {"urls": urls})
-    elif cmd == "search":
-        query = " ".join(sys.argv[2:])
-        mcp_call(mcp_url, "web_data_search_engine", {"query": query})
-    elif cmd == "search-geo":
-        if len(sys.argv) < 4:
-            print("Usage: brightdata.py search-geo <country_code> <query>", file=sys.stderr)
-            sys.exit(1)
-        geo = sys.argv[2]
-        query = " ".join(sys.argv[3:])
-        mcp_call(mcp_url, "web_data_search_engine", {"query": query, "country": geo})
-    elif cmd == "search-yandex":
-        query = " ".join(sys.argv[2:])
-        mcp_call(mcp_url, "web_data_search_engine", {"query": query, "engine": "yandex"})
-    else:
-        print(f"Unknown: {cmd}", file=sys.stderr)
-        sys.exit(1)
-
-
-if __name__ == "__main__":
-    main()
+#!/usr/bin/env python3
+"""Bright Data MCP wrapper — scrape, search, search-geo, search-yandex. Stdlib only.
+
+Uses mcp-client.py for MCP JSON-RPC calls.
+"""
+
+import json
+import os
+import subprocess
+import sys
+
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+from _http import get_key, get_workspace
+
+
+def init():
+    workspace, _, _ = get_workspace()
+    return get_key("BRIGHTDATA_MCP_URL",
+                   file_fallback=os.path.join(workspace, "scripts", "brightdata-mcp-url.txt"),
+                   help_url="https://brightdata.com/products/web-scraper/mcp")
+
+
+def mcp_call(mcp_url, tool_name, arguments):
+    """Call MCP tool via mcp-client.py."""
+    scripts_dir = os.path.dirname(os.path.abspath(__file__))
+    mcp_client = os.path.join(scripts_dir, "mcp-client.py")
+    args_json = json.dumps(arguments)
+    result = subprocess.run(
+        [sys.executable, mcp_client, mcp_url, tool_name, args_json],
+        capture_output=True, text=True, timeout=120
+    )
+    if result.stdout:
+        print(result.stdout)
+    if result.stderr:
+        print(result.stderr, file=sys.stderr)
+    return result.returncode
+
+
+def list_tools(mcp_url):
+    """List available MCP tools."""
+    scripts_dir = os.path.dirname(os.path.abspath(__file__))
+    mcp_client = os.path.join(scripts_dir, "mcp-client.py")
+    result = subprocess.run(
+        [sys.executable, mcp_client, mcp_url, "--list-tools"],
+        capture_output=True, text=True, timeout=30
+    )
+    if result.stdout:
+        print(result.stdout)
+    if result.stderr:
+        print(result.stderr, file=sys.stderr)
+
+
+def main():
+    if len(sys.argv) < 2:
+        print("Usage: brightdata.py {tools|scrape|scrape-batch|search|search-geo|search-yandex} <args>")
+        print()
+        print("  tools                     - list available MCP tools")
+        print("  scrape <url>              - any URL → markdown (bypasses CAPTCHA)")
+        print("  scrape-batch <url1> <url2> - batch scrape up to 10 URLs")
+        print("  search <query>            - Google search via Bright Data")
+        print("  search-geo <cc> <query>   - geo-targeted search")
+        print("  search-yandex <query>     - Yandex search")
+        sys.exit(1)
+
+    mcp_url = init()
+    cmd = sys.argv[1]
+
+    if cmd == "tools":
+        list_tools(mcp_url)
+    elif cmd == "scrape":
+        url = sys.argv[2] if len(sys.argv) > 2 else ""
+        if not url:
+            print("Usage: brightdata.py scrape <url>", file=sys.stderr)
+            sys.exit(1)
+        mcp_call(mcp_url, "scrape_as_markdown", {"url": url})
+    elif cmd == "scrape-batch":
+        urls = sys.argv[2:]
+        if not urls:
+            print("Usage: brightdata.py scrape-batch <url1> <url2>...", file=sys.stderr)
+            sys.exit(1)
+        mcp_call(mcp_url, "scrape_as_markdown_batch", {"urls": urls})
+    elif cmd == "search":
+        query = " ".join(sys.argv[2:])
+        mcp_call(mcp_url, "web_data_search_engine", {"query": query})
+    elif cmd == "search-geo":
+        if len(sys.argv) < 4:
+            print("Usage: brightdata.py search-geo <country_code> <query>", file=sys.stderr)
+            sys.exit(1)
+        geo = sys.argv[2]
+        query = " ".join(sys.argv[3:])
+        mcp_call(mcp_url, "web_data_search_engine", {"query": query, "country": geo})
+    elif cmd == "search-yandex":
+        query = " ".join(sys.argv[2:])
+        mcp_call(mcp_url, "web_data_search_engine", {"query": query, "engine": "yandex"})
+    else:
+        print(f"Unknown: {cmd}", file=sys.stderr)
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/diagnose.py

@@ -1,141 +1,141 @@
-#!/usr/bin/env python3
-"""OSINT Toolkit Diagnostic — checks available API keys, CLI tools, and capabilities."""
-
-import os
-import shutil
-import sys
-
-sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
-from _http import get_workspace
-
-
-def check_key(env_var, file_path=None):
-    """Check if API key is available via env or file."""
-    if os.environ.get(env_var):
-        return True, f"(env)"
-    if file_path and os.path.isfile(file_path):
-        return True, f"(file: {os.path.basename(file_path)})"
-    return False, ""
-
-
-def main():
-    workspace, skill_dir, scripts_dir = get_workspace()
-
-    print("=== OSINT TOOLKIT DIAGNOSTIC ===")
-    print()
-
-    # 1. API Tokens
-    print("📡 API Tokens:")
-    keys = [
-        ("APIFY_API_TOKEN", os.path.join(workspace, "scripts", "apify-api-token.txt"),
-         "https://console.apify.com/account/integrations"),
-        ("JINA_API_KEY", os.path.join(workspace, "scripts", "jina-api-key.txt"),
-         "https://jina.ai/api-key"),
-        ("PERPLEXITY_API_KEY", None, "https://perplexity.ai/settings/api"),
-        ("PARALLEL_API_KEY", os.path.join(workspace, "scripts", "parallel-api-key.txt"),
-         "https://platform.parallel.ai"),
-        ("EXA_API_KEY", None, "https://dashboard.exa.ai"),
-        ("TAVILY_API_KEY", None, "https://app.tavily.com/home"),
-        ("BRIGHTDATA_MCP_URL", os.path.join(workspace, "scripts", "brightdata-mcp-url.txt"),
-         "https://brightdata.com/products/web-scraper/mcp"),
-    ]
-    for env_var, file_path, url in keys:
-        found, source = check_key(env_var, file_path)
-        if found:
-            print(f"  ✅ {env_var} {source}")
-        else:
-            print(f"  ❌ {env_var} — get one at {url}")
-    print()
-
-    # 2. CLI Tools
-    print("🔧 CLI Tools:")
-    tools = [
-        ("python3", "python"),
-        ("node", None),
-        ("jq", None),
-        ("curl", None),
-        ("git", None),
-    ]
-    for tool_name, alt_name in tools:
-        path = shutil.which(tool_name) or (shutil.which(alt_name) if alt_name else None)
-        if path:
-            print(f"  ✅ {tool_name}")
-        else:
-            print(f"  ❌ {tool_name}")
-
-    # Check run_actor.js
-    run_actor_js = os.path.join(scripts_dir, "run_actor.js")
-    if os.path.isfile(run_actor_js):
-        print(f"  ✅ run_actor.js (embedded, 55+ actors)")
-    else:
-        print(f"  ❌ run_actor.js (missing)")
-
-    # Check Python scripts
-    py_scripts = ["perplexity.py", "tavily.py", "exa.py", "jina.py",
-                  "parallel.py", "apify.py", "brightdata.py", "volley.py"]
-    for script in py_scripts:
-        path = os.path.join(scripts_dir, script)
-        if os.path.isfile(path):
-            print(f"  ✅ {script}")
-        else:
-            print(f"  ⚠️  {script} (not found)")
-    print()
-
-    # 3. Internal Intelligence
-    print("📱 Internal Intelligence:")
-    tg_path = os.path.join(workspace, "skills", "telegram", "scripts", "tg.py")
-    if os.path.isfile(tg_path):
-        print("  ✅ tg.py (Telegram history/search)")
-    else:
-        print("  ❌ tg.py (no Telegram access)")
-
-    himalaya = shutil.which("himalaya")
-    himalaya_local = os.path.expanduser("~/.local/bin/himalaya")
-    if himalaya or os.path.isfile(himalaya_local):
-        print("  ✅ himalaya (email search)")
-    else:
-        print("  ❌ himalaya (no email access)")
-
-    vault_crm = os.path.join(workspace, "vault", "crm")
-    if os.path.isdir(vault_crm):
-        count = sum(1 for f in os.listdir(vault_crm) if f.endswith(".md"))
-        print(f"  ✅ vault/crm ({count} cards)")
-    else:
-        print("  ❌ vault/crm (no CRM vault)")
-    print()
-
-    # 4. Capability Summary
-    print("📊 Capabilities:")
-    apify_ok = check_key("APIFY_API_TOKEN", os.path.join(workspace, "scripts", "apify-api-token.txt"))[0]
-    bright_ok = check_key("BRIGHTDATA_MCP_URL", os.path.join(workspace, "scripts", "brightdata-mcp-url.txt"))[0]
-    jina_ok = check_key("JINA_API_KEY", os.path.join(workspace, "scripts", "jina-api-key.txt"))[0]
-    perp_ok = check_key("PERPLEXITY_API_KEY")[0]
-    tavily_ok = check_key("TAVILY_API_KEY")[0]
-    exa_ok = check_key("EXA_API_KEY")[0]
-    parallel_ok = check_key("PARALLEL_API_KEY", os.path.join(workspace, "scripts", "parallel-api-key.txt"))[0]
-
-    caps = [
-        (apify_ok, "LinkedIn scraping (Apify)"),
-        (apify_ok, "Instagram scraping (Apify)"),
-        (apify_ok, "TikTok scraping (Apify)"),
-        (apify_ok, "YouTube scraping (Apify)"),
-        (apify_ok, "Contact enrichment (Apify)"),
-        (apify_ok, "Google Maps (Apify)"),
-        (bright_ok, "Facebook scraping (Bright Data)"),
-        (bright_ok, "CAPTCHA bypass (Bright Data)"),
-        (jina_ok, "Deep search (Jina)"),
-        (perp_ok, "Quick answers (Perplexity Sonar)"),
-        (perp_ok, "Deep research (Perplexity Deep)"),
-        (tavily_ok, "Agent search (Tavily)"),
-        (exa_ok, "Semantic search (Exa)"),
-        (exa_ok, "People/Company search (Exa)"),
-        (parallel_ok, "AI search (Parallel)"),
-    ]
-    for available, name in caps:
-        print(f"  {'✅' if available else '❌'} {name}")
-    print()
-    print("=== END DIAGNOSTIC ===")
-
-
-if __name__ == "__main__":
-    main()
+#!/usr/bin/env python3
+"""OSINT Toolkit Diagnostic — checks available API keys, CLI tools, and capabilities."""
+
+import os
+import shutil
+import sys
+
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+from _http import get_workspace
+
+
+def check_key(env_var, file_path=None):
+    """Check if API key is available via env or file."""
+    if os.environ.get(env_var):
+        return True, f"(env)"
+    if file_path and os.path.isfile(file_path):
+        return True, f"(file: {os.path.basename(file_path)})"
+    return False, ""
+
+
+def main():
+    workspace, skill_dir, scripts_dir = get_workspace()
+
+    print("=== OSINT TOOLKIT DIAGNOSTIC ===")
+    print()
+
+    # 1. API Tokens
+    print("📡 API Tokens:")
+    keys = [
+        ("APIFY_API_TOKEN", os.path.join(workspace, "scripts", "apify-api-token.txt"),
+         "https://console.apify.com/account/integrations"),
+        ("JINA_API_KEY", os.path.join(workspace, "scripts", "jina-api-key.txt"),
+         "https://jina.ai/api-key"),
+        ("PERPLEXITY_API_KEY", None, "https://perplexity.ai/settings/api"),
+        ("PARALLEL_API_KEY", os.path.join(workspace, "scripts", "parallel-api-key.txt"),
+         "https://platform.parallel.ai"),
+        ("EXA_API_KEY", None, "https://dashboard.exa.ai"),
+        ("TAVILY_API_KEY", None, "https://app.tavily.com/home"),
+        ("BRIGHTDATA_MCP_URL", os.path.join(workspace, "scripts", "brightdata-mcp-url.txt"),
+         "https://brightdata.com/products/web-scraper/mcp"),
+    ]
+    for env_var, file_path, url in keys:
+        found, source = check_key(env_var, file_path)
+        if found:
+            print(f"  ✅ {env_var} {source}")
+        else:
+            print(f"  ❌ {env_var} — get one at {url}")
+    print()
+
+    # 2. CLI Tools
+    print("🔧 CLI Tools:")
+    tools = [
+        ("python3", "python"),
+        ("node", None),
+        ("jq", None),
+        ("curl", None),
+        ("git", None),
+    ]
+    for tool_name, alt_name in tools:
+        path = shutil.which(tool_name) or (shutil.which(alt_name) if alt_name else None)
+        if path:
+            print(f"  ✅ {tool_name}")
+        else:
+            print(f"  ❌ {tool_name}")
+
+    # Check run_actor.js
+    run_actor_js = os.path.join(scripts_dir, "run_actor.js")
+    if os.path.isfile(run_actor_js):
+        print(f"  ✅ run_actor.js (embedded, 55+ actors)")
+    else:
+        print(f"  ❌ run_actor.js (missing)")
+
+    # Check Python scripts
+    py_scripts = ["perplexity.py", "tavily.py", "exa.py", "jina.py",
+                  "parallel.py", "apify.py", "brightdata.py", "volley.py"]
+    for script in py_scripts:
+        path = os.path.join(scripts_dir, script)
+        if os.path.isfile(path):
+            print(f"  ✅ {script}")
+        else:
+            print(f"  ⚠️  {script} (not found)")
+    print()
+
+    # 3. Internal Intelligence
+    print("📱 Internal Intelligence:")
+    tg_path = os.path.join(workspace, "skills", "telegram", "scripts", "tg.py")
+    if os.path.isfile(tg_path):
+        print("  ✅ tg.py (Telegram history/search)")
+    else:
+        print("  ❌ tg.py (no Telegram access)")
+
+    himalaya = shutil.which("himalaya")
+    himalaya_local = os.path.expanduser("~/.local/bin/himalaya")
+    if himalaya or os.path.isfile(himalaya_local):
+        print("  ✅ himalaya (email search)")
+    else:
+        print("  ❌ himalaya (no email access)")
+
+    vault_crm = os.path.join(workspace, "vault", "crm")
+    if os.path.isdir(vault_crm):
+        count = sum(1 for f in os.listdir(vault_crm) if f.endswith(".md"))
+        print(f"  ✅ vault/crm ({count} cards)")
+    else:
+        print("  ❌ vault/crm (no CRM vault)")
+    print()
+
+    # 4. Capability Summary
+    print("📊 Capabilities:")
+    apify_ok = check_key("APIFY_API_TOKEN", os.path.join(workspace, "scripts", "apify-api-token.txt"))[0]
+    bright_ok = check_key("BRIGHTDATA_MCP_URL", os.path.join(workspace, "scripts", "brightdata-mcp-url.txt"))[0]
+    jina_ok = check_key("JINA_API_KEY", os.path.join(workspace, "scripts", "jina-api-key.txt"))[0]
+    perp_ok = check_key("PERPLEXITY_API_KEY")[0]
+    tavily_ok = check_key("TAVILY_API_KEY")[0]
+    exa_ok = check_key("EXA_API_KEY")[0]
+    parallel_ok = check_key("PARALLEL_API_KEY", os.path.join(workspace, "scripts", "parallel-api-key.txt"))[0]
+
+    caps = [
+        (apify_ok, "LinkedIn scraping (Apify)"),
+        (apify_ok, "Instagram scraping (Apify)"),
+        (apify_ok, "TikTok scraping (Apify)"),
+        (apify_ok, "YouTube scraping (Apify)"),
+        (apify_ok, "Contact enrichment (Apify)"),
+        (apify_ok, "Google Maps (Apify)"),
+        (bright_ok, "Facebook scraping (Bright Data)"),
+        (bright_ok, "CAPTCHA bypass (Bright Data)"),
+        (jina_ok, "Deep search (Jina)"),
+        (perp_ok, "Quick answers (Perplexity Sonar)"),
+        (perp_ok, "Deep research (Perplexity Deep)"),
+        (tavily_ok, "Agent search (Tavily)"),
+        (exa_ok, "Semantic search (Exa)"),
+        (exa_ok, "People/Company search (Exa)"),
+        (parallel_ok, "AI search (Parallel)"),
+    ]
+    for available, name in caps:
+        print(f"  {'✅' if available else '❌'} {name}")
+    print()
+    print("=== END DIAGNOSTIC ===")
+
+
+if __name__ == "__main__":
+    main()

package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/exa.py

@@ -1,79 +1,79 @@
-#!/usr/bin/env python3
-"""Exa AI — semantic search, company research, people search, crawl. Stdlib only."""
-
-import json
-import os
-import sys
-
-sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
-from _http import api_post, get_key, truncate
-
-BASE = "https://api.exa.ai"
-
-
-def init():
-    return get_key("EXA_API_KEY", help_url="https://dashboard.exa.ai")
-
-
-def search(api_key, query, category=None, max_chars=500, icon="🔗"):
-    """Exa semantic search."""
-    payload = {
-        "query": query,
-        "type": "auto",
-        "numResults": 10,
-        "contents": {"text": {"maxCharacters": max_chars}},
-    }
-    if category:
-        payload["category"] = category
-    data = api_post(f"{BASE}/search", payload,
-                     headers={"x-api-key": api_key})
-    if not data:
-        return
-    for r in data.get("results", [])[:10]:
-        print(f'{icon} {r.get("title", "")}')
-        print(f'   {r.get("url", "")}')
-        txt = truncate(r.get("text", ""), max_chars)
-        if txt:
-            print(f"   {txt}")
-        print()
-
-
-def crawl(api_key, url):
-    """Crawl a URL and extract content."""
-    data = api_post(f"{BASE}/contents",
-                     {"urls": [url], "text": {"maxCharacters": 5000}},
-                     headers={"x-api-key": api_key})
-    if not data:
-        return
-    for r in data.get("results", []):
-        print(f'📄 {r.get("title", "")}')
-        print(f'   {r.get("url", "")}')
-        print(r.get("text", "")[:3000])
-
-
-def main():
-    if len(sys.argv) < 3:
-        print("Usage: exa.py search|company|people|crawl|deep <query>")
-        sys.exit(1)
-    api_key = init()
-    cmd = sys.argv[1]
-    query = " ".join(sys.argv[2:])
-    if cmd == "search":
-        search(api_key, query)
-    elif cmd == "company":
-        search(api_key, f"{query} company information about",
-               category="company", max_chars=1000, icon="🏢")
-    elif cmd == "people":
-        search(api_key, query, category="personal site", icon="👤")
-    elif cmd == "crawl":
-        crawl(api_key, query)
-    elif cmd == "deep":
-        print("🔬 Exa Deep Research — use MCP or dashboard")
-        print("   MCP: https://mcp.exa.ai/mcp?tools=deep_researcher_start,deep_researcher_check")
-    else:
-        print(f"Unknown: {cmd} (use search|company|people|crawl|deep)", file=sys.stderr)
-        sys.exit(1)
-
-
-if __name__ == "__main__":
-    main()
+#!/usr/bin/env python3
+"""Exa AI — semantic search, company research, people search, crawl. Stdlib only."""
+
+import json
+import os
+import sys
+
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+from _http import api_post, get_key, truncate
+
+BASE = "https://api.exa.ai"
+
+
+def init():
+    return get_key("EXA_API_KEY", help_url="https://dashboard.exa.ai")
+
+
+def search(api_key, query, category=None, max_chars=500, icon="🔗"):
+    """Exa semantic search."""
+    payload = {
+        "query": query,
+        "type": "auto",
+        "numResults": 10,
+        "contents": {"text": {"maxCharacters": max_chars}},
+    }
+    if category:
+        payload["category"] = category
+    data = api_post(f"{BASE}/search", payload,
+                     headers={"x-api-key": api_key})
+    if not data:
+        return
+    for r in data.get("results", [])[:10]:
+        print(f'{icon} {r.get("title", "")}')
+        print(f'   {r.get("url", "")}')
+        txt = truncate(r.get("text", ""), max_chars)
+        if txt:
+            print(f"   {txt}")
+        print()
+
+
+def crawl(api_key, url):
+    """Crawl a URL and extract content."""
+    data = api_post(f"{BASE}/contents",
+                     {"urls": [url], "text": {"maxCharacters": 5000}},
+                     headers={"x-api-key": api_key})
+    if not data:
+        return
+    for r in data.get("results", []):
+        print(f'📄 {r.get("title", "")}')
+        print(f'   {r.get("url", "")}')
+        print(r.get("text", "")[:3000])
+
+
+def main():
+    if len(sys.argv) < 3:
+        print("Usage: exa.py search|company|people|crawl|deep <query>")
+        sys.exit(1)
+    api_key = init()
+    cmd = sys.argv[1]
+    query = " ".join(sys.argv[2:])
+    if cmd == "search":
+        search(api_key, query)
+    elif cmd == "company":
+        search(api_key, f"{query} company information about",
+               category="company", max_chars=1000, icon="🏢")
+    elif cmd == "people":
+        search(api_key, query, category="personal site", icon="👤")
+    elif cmd == "crawl":
+        crawl(api_key, query)
+    elif cmd == "deep":
+        print("🔬 Exa Deep Research — use MCP or dashboard")
+        print("   MCP: https://mcp.exa.ai/mcp?tools=deep_researcher_start,deep_researcher_check")
+    else:
+        print(f"Unknown: {cmd} (use search|company|people|crawl|deep)", file=sys.stderr)
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()