Litescrape

Litescrape MCP Server

どの 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、ウェブページのキャプチャ）も利用でき、すべての制限が解除されます。

結果は Litescrape API を通じて、各サイト独自のページから構造化 JSON として直接取得されます。リンクは実際の遷移先を示し、リダイレクトはありません。また、キャッシュは行われず、呼び出しのたびに最新の結果を取得します。

クイックスタート

アカウントもキーも不要です。1 行で設定できます。

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 の検索結果ページ全体：オーガニック検索結果、ナレッジグラフ、AI Overview、広告、関連する質問、その他 Google が表示するすべてのモジュール	25
bing_search	Bing のオーガニック検索結果、回答ボックス、ナレッジグラフ、Copilot の回答など	50
duckduckgo_search	地域、安全性、日付のフィルターを指定した DuckDuckGo のオーガニック検索結果	50
google_maps	Google Maps の場所（名称、住所、評価、営業時間、電話番号、ウェブサイト、座標）、または特定の場所	50

ネットワークごとに一度に実行できる呼び出しは 1 件です。失敗した呼び出しはカウントされません。上限に達すると、ツールの結果にその旨とキーの追加方法が正確に表示されるため、エージェントがその情報をあなたに伝えられます。

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_..."

ツール

サーバーが一覧表示するのは無料のツールと、カタログの残りの部分にアクセスする2つのツールのみなので、キーの有無にかかわらず、各セッションのツール一覧は少数（約5Kトークン）で始まります。

ツール	キーが必要	機能
google_search	いいえ	Google 検索ページ全体を返します。fast_mode を指定すると、オーガニック検索結果のみをより高速に返します
bing_search	いいえ	Bing のウェブ検索
duckduckgo_search	いいえ	DuckDuckGo のウェブ検索
google_maps	いいえ	Google Maps の場所、または特定の場所1件
find_tools	いいえ	平易な言葉で説明したタスク（q）に合う Litescrape のツールを、最適なものから順に入力スキーマとともに検索するか、names でツールを取得します
call_tool	場合による	find_tools のツールを name と arguments で実行します。キーなしで使えるのは無料のツールのみです

ツール名、説明、入力スキーマは Litescrape API 自体（/api/tools）から取得されるため、常にエンドポイントと一致します。

キーを使って利用できるその他のツール

その他の Litescrape エンドポイントはすべて、find_tools と call_tool から利用でき、ルート名に基づいた名前（/api/amazon/product は amazon_product）が付いており、そのエンドポイントのパラメーターを受け取ります。結果に含まれる識別子（場所、商品、動画、ユーザーの ID）は、対応する詳細ツールへの入力として使用します。find_tools はキーなしでも使えるため、エージェントはキーで何が利用可能になるかを確認できます。

分野	ツール
検索エンジン	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_fetch（1 ページを Markdown、HTML、またはテキストとして取得）、web_screenshot：1 ページの base64 PNG。ページ全体も指定可能です
パラメーター名と受け付ける値については、Litescrape API referenceを参照してください。

すべてのツールで result_groups を受け付けます（ツールが見つかった場合は、call_tool の arguments 内で指定します）。これは、保持するトップレベルのグループのリストです（例：["organic_results", "knowledge_graph"]）。これにより、モデルのコンテキストを小さく保てます。search_metadata は常に含まれます。

結果

ツールの結果は1つのテキストブロックで、1行の要約、空行、その後に変更されていない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（数秒）だけ待機し、上限を報告する前に最大2回再試行します
キー必須のツールがキーなしで呼び出された	ツール名と無料の代替手段、キーの追加方法を示すエラーテキスト。無料のツール検索のみ実行されます
上流のページを取得できなかった	APIの error_code、HTTPステータス、request_id を含むエラーテキスト。再試行可能な失敗は2回再試行され、失敗した呼び出しは課金されません
引数が無効	APIが error_code と、引数名を示すメッセージを返して拒否します。課金されません

デフォルトではリクエストは120秒後にタイムアウトします（API自体の期限は90秒です）。AI Modeは最も遅いツールです。

設定

環境変数	デフォルト	意味
LITESCRAPE_API_KEY	未設定	ベアラーキー。未設定の場合は無料のキーなし利用枠を使用します
LITESCRAPE_API_URL	https://api.litescrape.com	APIのオリジン。セルフホストまたはステージング環境向けです
LITESCRAPE_TIMEOUT_MS	120000	リクエストごとのタイムアウト（ミリ秒）

Streamable HTTP モード

litescrape-mcp-server --http（または LITESCRAPE_MCP_TRANSPORT=http）を指定すると、stdio の代わりにHTTP経由でMCPを提供します。ステートレスな POST /mcp と GET /healthz を、PORT（デフォルトは8080）および HOST（デフォルトは 0.0.0.0）、または --port と --host で指定して待ち受けます。各リクエストのAPIキーは Authorization: Bearer ヘッダーまたは ?api_key= クエリパラメーターから取得するため、1つのプロセスでキーありとキーなしの呼び出しを処理できます。このモードでは LITESCRAPE_API_KEY は無視されます。https://mcp.litescrape.com/mcp で稼働しているのはこのモードです。

共有アドレスの背後では、キーなしの呼び出しはすべて1つの利用枠に加算されます。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）のタグが付けられ、公開ワークフローによって provenance 付きで npm にビルド・公開されます。

ライセンス

MIT