Litescrape MCP Server 是一个面向 MCP（Model Context Protocol）客户端的服务器，用于将多个搜索与地图服务的结果以结构化 JSON 形式提供给 AI 客户端。
用途
该服务器让任意 MCP 客户端能够获取 Google Search、Bing、DuckDuckGo 和 Google Maps 的查询结果。无需 API 密钥即可免费使用。结果直接来自搜索引擎自身的页面，经过 Litescrape API 以结构化 JSON 返回。链接是真实目标地址，不是重定向；不缓存，每次调用都实时获取。
主要能力
- 无需密钥即可使用：Google Search、Bing、DuckDuckGo、Google Maps 结果。
- 添加 API 密钥后解锁：google_ai_mode、google_ai_overview、google_shopping、google_reviews 以及 web_fetch；移除每日限制并允许并发调用。
- 每次调用可传 result_groups 参数，指定要保留的顶层结果组（例如 ["organic_results", "knowledge_graph"]），便于控制模型上下文大小；search_metadata 始终包含。
- 工具结果为一个文本块：一行摘要、空行、然后原样返回 API 的 JSON 响应。同一 JSON 也会以 structuredContent 返回，供读取该字段的客户端使用。
使用方式
- 要求 Node.js 20 或更高版本。
- 无需账户、无需密钥，一行配置即可用于 Cursor、Windsurf、Claude Desktop、Codex、Gemini CLI 及大多数其他客户端（mcp.json、claude_desktop_config.json 或客户端 MCP 设置）。
- 托管端点：支持连接远程服务器的客户端可使用 https://mcp.litescrape.com/mcp，工具与免费额度相同；发送 Authorization: Bearer ls_live_... 可解锁其余功能。
- 使用 Claude Code 添加：claude mcp add litescrape -e LITESCRAPE_API_KEY=ls_live_... -- npx -y litescrape-mcp-server
- 使用托管端点添加：claude mcp add --transport http litescrape https://mcp.litescrape.com/mcp --header "Authorization: Bearer ls_live_..."
- 参数名称与可接受值遵循 Litescrape API 参考文档。
- 流式 HTTP 模式：litescrape-mcp-server --http（或 LITESCRAPE_MCP_TRANSPORT=http）通过 HTTP 而非 stdio 提供 MCP 服务：无状态 POST /mcp、GET /healthz，监听 PORT（默认 8080）和 HOST（默认 0.0.0.0），或使用 --port 和 --host。每个请求的 API 密钥来自其 Authorization: Bearer 头或 ?api_key= 查询参数，因此一个进程可同时服务带密钥和无密钥调用者；该模式下 LITESCRAPE_API_KEY 被忽略。这正是 https://mcp.litescrape.com/mcp 所运行的模式。
- 共享地址场景：无密钥调用者会共同计入一个额度。LITESCRAPE_KEYLESS_PROXY_SECRET 是 Litescrape API 与其自有托管端点共享的密钥，用于转发每个调用者的地址；LITESCRAPE_EDGE_SECRET 是 Cloudflare 在该端点前添加的值，以便从 CF-Connecting-IP 读取调用者。私有部署无需这两项，此时服务器自身地址会被计量。
- 每个请求通过 X-Litescrape-Client: mcp/<version> 和 litescrape-mcp-server/<version> user agent 标识自身。服务器将协议消息写入 stdout，日志写入 stderr。
- 开发：npm run dev 从源码以 tsx 运行服务器。发布以包版本标记（例如 0.1.0）；发布工作流构建并以 provenance 发布到 npm。
免费额度与限制
- 无密钥时，每个网络一次只运行一个调用，失败的调用不计入。达到限制时，工具结果会说明，并告知模型如何添加密钥，便于代理转达给用户。
- 请求默认 120 秒超时（API 自身截止时间为 90 秒）。AI Mode 是最慢的工具。
适用场景
适用于需要让 AI 客户端实时获取搜索引擎与地图结构化数据的场景，包括搜索、地图查询、购物与评论信息，以及通过密钥使用 AI 模式、AI 概览和网页抓取。
限制
未提供除上述之外的功能、收费、价格或其他平台支持信息。
