{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_6w9e5umwta9y","handle":"searchlight-mcp","url":"https://wellknown.network/agents/searchlight-mcp","links":{"self":"https://wellknown.network/agents/searchlight-mcp/record.json","html":"https://wellknown.network/agents/searchlight-mcp","markdown":"https://wellknown.network/agents/searchlight-mcp/record.md","api":"https://wellknown.network/api/v1/agents/searchlight-mcp","status":"https://wellknown.network/api/v1/agents/searchlight-mcp/status","claim":"https://wellknown.network/agents/searchlight-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/searchlight-mcp/claim.json","badge":"https://wellknown.network/agents/searchlight-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:searchlight-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"searchlight-mcp","summary":"Free, open-source web search MCP server for AI coding tools","description":"# Searchlight\n\nFree, open-source web search MCP server for AI coding tools.\n\nWorks with **Claude Code**, **Cursor**, **Windsurf**, **VS Code Copilot**, and any MCP-compatible AI tool. Zero API keys required — install, add one line to your MCP config, and start searching.\n\n## Features\n\n- **Zero cost** — Free search via native HTTP scraping (Bing, Baidu, Yandex, Brave, DuckDuckGo)\n- **Zero config** — Works out of the box with `auto` backend and language-aware routing\n- **7 search engines** with automatic failover and reachability probing\n- **4 MCP tools** — `web_search`, `web_read`, `web_search_and_read`, `search_config`\n- **Quality Site Library** — Auto-enhances queries with authoritative sources (Anthropic, OpenAI, MCP docs, LangChain, etc.)\n- **Smart content extraction** — trafilatura → readability → BeautifulSoup fallback chain with quality scoring\n- **JS page rendering** — Automatic Jina AI proxy fallback for JavaScript-rendered pages\n- **Smart caching** — Async SQLite with dynamic TTL (time-sensitive queries cache shorter)\n- **Auto-learning** — Automatically discovers and adds high-quality websites from your reading patterns\n- **Security** — Automatic API key/secret detection and redaction in queries\n\n## Installation\n\n### Option 1: PyPI (Recommended)\n\n```bash\npip install searchlight-mcp\n```\n\nOr with uv:\n\n```bash\nuv pip install searchlight-mcp\n```\n\n### Option 2: Install from GitHub\n\n```bash\npip install git+https://github.com/McKenzieIT/smart-web-search.git\n```\n\n## Quick Start — One-Click MCP Setup\n\n### Claude Code\n\nAdd to `~/.claude.json` or project `.mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"searchlight\": {\n      \"command\": \"python\",\n      \"args\": [\"-m\", \"searchlight\"]\n    }\n  }\n}\n```\n\nOr use the CLI one-liner:\n\n```bash\nclaude mcp add searchlight -- python -m searchlight\n```\n\n### Cursor\n\nAdd to `.cursor/mcp.json` in your project root:\n\n```json\n{\n  \"mcpServers\": {\n    \"searchlight\": {\n      \"command\": \"python\",\n      \"args\": [\"-m\", \"searchlight\"]\n    }\n  }\n}\n…","publisher":{"name":"Searchlight Contributors","url":null},"homepage":null,"repository":null,"version":"4.1.0","license":null,"protocols":["mcp"],"tags":["ai","coding-tools","free","mcp","web-search"],"pricing":null,"endpoints":[{"url":"pypi:searchlight-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"data.web-search","name":"Web Search","confidence":1,"provenance":"declared"},{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["data","dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"searchlight-mcp","registry":"pypi","observedAt":"2026-09-10T12:23:14.931Z","publishedAt":"2026-04-30T18:07:43.732004Z","latestVersion":"4.1.0"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"searchlight-mcp","url":"https://pypi.org/project/searchlight-mcp/","firstSeenAt":"2026-09-10T12:21:11.750Z","fetchedAt":"2026-09-10T12:21:11.750Z","normalizedAt":"2026-09-10T12:21:11.750Z"}]},"firstSeenAt":"2026-09-10T12:21:11.750Z","updatedAt":"2026-09-10T12:23:14.931Z"}