Litescrape

Litescrape MCP 服务

为任何 MCP 客户端提供 Google Search、Bing、DuckDuckGo 和 Google Maps 结果，免费且无需 API 密钥。添加密钥即可使用 Litescrape 目录中的其余工具（Google AI Mode、AI Overview、Shopping 和 Reviews，以及 Brave、Yandex、Baidu、Naver、Yahoo、YouTube、应用商店、Amazon、eBay 和其他零售商、Zillow 和其他房地产网站、招聘网站、TikTok、Instagram、X、Facebook 以及网页抓取），并取消所有限制。

结果直接来自各网站的页面，并以结构化 JSON 格式返回，使用的是 Litescrape API。链接指向真实目标，绝非重定向，并且不会缓存：每次调用都会实时执行。

快速开始

无需账号、无需密钥，只需一行。

Claude Code

claude mcp add litescrape -- npx -y litescrape-mcp-server

Cursor、Windsurf、Claude Desktop、Codex、Gemini CLI 和大多数其他客户端（mcp.json、claude_desktop_config.json 或客户端的 MCP 设置）

{
	"mcpServers": {
		"litescrape": {
			"command": "npx",
			"args": ["-y", "litescrape-mcp-server"]
		}
	}
}

VS Code

code --add-mcp '{"name":"litescrape","command":"npx","args":["-y","litescrape-mcp-server"]}'

Codex CLI

codex mcp add litescrape -- npx -y litescrape-mcp-server

Gemini CLI

gemini mcp add litescrape npx -y litescrape-mcp-server

需要 Node.js 20 或更高版本。

托管服务，无需安装：可连接远程服务的客户端可以改用 https://mcp.litescrape.com/mcp。工具相同，免费额度相同；发送 API 密钥 Authorization: Bearer ls_live_... 即可解锁其余功能。

claude mcp add --transport http litescrape https://mcp.litescrape.com/mcp

无需密钥即可使用的内容

工具	返回内容	每个网络每天（UTC）的免费调用次数
google_search	完整的 Google 结果页面：自然搜索结果、Knowledge Graph、AI Overview、广告、相关问题以及 Google 提供的其他所有模块	25
bing_search	Bing 自然搜索结果、答案框、Knowledge Graph、Copilot 回答等	50
duckduckgo_search	DuckDuckGo 自然搜索结果，支持地区、安全和日期筛选	50
google_maps	Google Maps 地点（名称、地址、评分、营业时间、电话、网站、坐标）或某个确切地点	50

每个网络一次只运行一个调用，失败的调用不会计入额度。达到限制时，工具结果会说明情况，并准确告知模型如何添加密钥，以便 Agent 转告你。

添加 API 密钥

密钥可解锁所有其他工具（google_ai_mode、google_ai_overview、google_shopping、google_reviews、web_fetch 和目录中的其余工具），移除每日限制并允许并发调用。前往 litescrape.com 获取密钥，然后在服务的环境中设置 LITESCRAPE_API_KEY：

{
	"mcpServers": {
		"litescrape": {
			"command": "npx",
			"args": ["-y", "litescrape-mcp-server"],
			"env": {
				"LITESCRAPE_API_KEY": "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_..."

工具

服务仅列出免费工具，以及两个可访问其余工具目录的工具，因此无论是否提供密钥，每个会话开始时的工具列表都很短（约 5K 个 token）：

工具	是否需要密钥	功能
google_search	否	完整的 Google Search 页面；fast_mode 仅返回自然搜索结果，速度更快
bing_search	否	Bing 网页搜索
duckduckgo_search	否	DuckDuckGo 网页搜索
google_maps	否	Google Maps 地点，或某个精确地点
find_tools	否	根据使用自然语言描述的任务（q）查找 Litescrape 工具，按匹配度从高到低列出并提供其输入架构；也可以通过 names 获取工具
call_tool	视情况而定	根据 name 运行 find_tools 返回的工具，并传入其 arguments；仅免费工具可在不提供密钥的情况下使用

工具名称、描述和输入架构直接来自 Litescrape API（/api/tools），因此始终与端点相符。

使用密钥可访问更多工具

所有其他 Litescrape 端点都可通过 find_tools 和 call_tool 访问，工具名称与其路由对应（/api/amazon/product 对应 amazon_product），并接受该端点的参数。某个结果中的标识符（地点、产品、视频或用户 ID）就是对应详情工具的输入。find_tools 无需密钥也能使用，因此 Agent 可以查看密钥能够解锁哪些功能。

领域	工具
搜索引擎	google_images、google_local、google_ads、bing_images、brave_search、baidu_search、yandex_search、yandex_images、naver_search、yahoo_search、yahoo_images、youtube_search、youtube_channel
AI 答案	google_ai_mode、google_ai_overview、google_gemini、brave_ai_mode、naver_ai_overview、copilot_chat_completions
地图、地点与旅行	google_reviews、google_maps_posts、google_maps_photo_meta、google_maps_popular_times、google_contributor_reviews、apple_maps_places、apple_maps_reviews、bing_maps、duckduckgo_maps、tripadvisor_search、tripadvisor_place、tripadvisor_reviews、yelp_search、yelp_place、yelp_reviews、airbnb_search、eventbrite_search
购物	google_shopping、google_shopping_product、google_shopping_merchant_urls、bing_shopping、bing_product、ebay_search、ebay_product、ebay_seller、amazon_search、amazon_product、amazon_autocomplete、amazon_featured_reviews、amazon_media_reviews，以及适用于 walmart、homedepot、target、etsy、bestbuy、wayfair、aliexpress、kroger、sprouts、wholefoods 和 ikea 的 _search 与 _product
应用商店	google_play_apps、google_play_games、google_play_books、google_play_movies、google_play_product、google_play_reviews、apple_app_store_search、apple_app_store_product、apple_app_store_reviews
工作	google_jobs、indeed_search、glassdoor_search、ashby_search、ziprecruiter_search、levels_search
房地产	zillow_search、zillow_property、zillow_locations、redfin_search、redfin_property、realtor_search、realtor_property、apartments_search、apartments_property、homes_search、homes_property
社交媒体	TikTok：tiktok_profile、tiktok_video、tiktok_transcript、tiktok_search_suggestions、tiktok_user_live、tiktok_live、tiktok_song、tiktok_profile_videos、tiktok_comments、tiktok_comment_replies、tiktok_following、tiktok_followers、tiktok_search_keyword、tiktok_search_top、tiktok_search_hashtag、tiktok_song_videos、tiktok_trending_feed、tiktok_collection_videos。Instagram：instagram_profile、instagram_posts、instagram_post、instagram_profile_post_count、instagram_embed、instagram_search_popular。X：x_profile、x_post、x_user_posts、x_community、x_community_posts。Facebook：facebook_search_pages、facebook_search_profiles、facebook_hashtag_posts、facebook_post、facebook_page_posts、facebook_marketplace_browse、facebook_reel
Web	web_fetch（以 Markdown、HTML 或文本格式获取单个页面），web_screenshot：单个页面的 base64 PNG，可选获取完整页面
参数名称和可接受的值遵循 Litescrape API 参考。

每个工具都接受 result_groups（对于找到的工具，位于 call_tool 的 arguments 中），这是一个要保留的顶层分组列表（例如 ["organic_results", "knowledge_graph"]），可缩小模型的上下文。search_metadata 始终会包含在内。

结果

工具结果是一个文本块：一行摘要、一个空行，然后是未经修改的 API JSON 响应。

Google Search for "espresso machine": 10 organic results; also knowledge_graph, related_questions, ai_overview. Free allowance: 24 of 25 google_search calls left today (no API key set).

{"search_metadata":{...},"search_parameters":{...},"organic_results":[...],...}

对于会读取该内容的客户端，同一份 JSON 也会作为 structuredContent 返回。

限制和错误

发生的情况	工具结果
该工具的每日限额已用完	错误文本会指出工具名称、限额重置时间（00:00 UTC）以及如何添加密钥
无密钥调用已在处理中	服务会等待 API 返回的 Retry-After（几秒），最多重试两次，然后报告限额已用完
未提供密钥就调用了仅限密钥的工具	错误文本会指出工具名称、可免费使用的替代方案以及如何添加密钥；只会调用免费的工具查询
无法获取上游页面	错误文本会包含 API 的 error_code、HTTP 状态码和 request_id；可重试的失败会重试两次，失败的调用不计费
参数无效	API 会通过 error_code 和指出参数名称的消息拒绝请求；不计费

请求默认在 120 秒后超时（API 自身的截止时间为 90 秒）。AI Mode 是最慢的工具。

配置

环境变量	默认值	含义
LITESCRAPE_API_KEY	未设置	Bearer 密钥；未设置时使用免费的无密钥限额
LITESCRAPE_API_URL	https://api.litescrape.com	API 源站，用于可自托管或预发布部署
LITESCRAPE_TIMEOUT_MS	120000	每个请求的超时时间，单位为毫秒

Streamable 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 读取调用方地址。私有部署不需要这两者，因为会按服务自身的地址计量。

docker build -t litescrape-mcp-server . && docker run -p 8080:8080 litescrape-mcp-server --http

每个请求都使用 X-Litescrape-Client: mcp/<version> 标识自身，并带有 litescrape-mcp-server/<version> 用户代理。参数通过 GET 查询字符串传递，但仅接受 JSON 请求体的端点，以及包含数组或对象参数或值超过 2,048 个字符的调用除外；这些调用会以 JSON POST 发送。服务会将协议消息写入 stdout，将日志写入 stderr。

开发

npm install
npm run lint       # prettier + tsc
npm test           # vitest, including real stdio and HTTP round trips
npm run build      # tsc -> dist/
npm run inspector  # MCP Inspector against dist/index.js

npm run dev 使用 tsx 从源代码运行服务。发布版本使用软件包版本号作为标签（例如 0.1.0）；发布工作流会构建并发布到 npm，同时提供来源证明。

许可证

MIT