Crawlora MCP

Crawlora MCP

Crawlora MCP is a hosted Model Context Protocol server that gives AI clients and agents 4186 structured public‑web‑data tools across 500 platform groups — search, maps, e‑commerce, social, finance, travel, app stores, media, and reviews — each returning clean, normalized JSON instead of HTML to parse.

Two ways to use it: connect any MCP client to the hosted endpoint

(https://mcp.crawlora.net/mcp), or run the small open‑source local server in this repo

(npx / Docker, stdio) — both expose the same tools and authenticate with your Crawlora API

key. Start free with 2,000 credits/month (no card) at [crawlora.net](https://crawlora.net?utm_source=github&utm_medium=referral&utm_campaign=crawlora-mcp).

Connection

A missing or invalid API key returns 401.

Connect your client

Crawlora MCP works with any MCP‑capable client. Pick yours below — they all point at the same hosted endpoint (https://mcp.crawlora.net/mcp, Streamable HTTP) and authenticate with your CRAWLORA_API_KEY. Prefer keeping the key in an environment variable over pasting it literally, and never commit it. Ready‑to‑paste files for each client live in examples/.

Claude Code (CLI)

claude mcp add --transport http crawlora https://mcp.crawlora.net/mcp \

--header "Authorization: Bearer ${CRAWLORA_API_KEY}"

Adds at local scope by default. Use --scope user to make it available in every project, or --scope project to write a shared .mcp.json. Confirm with claude mcp list.

Claude Desktop

Settings → Developer → Edit Config, then add to claude_desktop_config.json:

{

"mcpServers": { "crawlora": { "url": "https://mcp.crawlora.net/mcp", "transport": "streamable-http", "headers": { "Authorization": "Bearer YOUR_CRAWLORA_API_KEY" } } } }

Cursor

Project‑local .cursor/mcp.json (or ~/.cursor/mcp.json for all projects):

{

"mcpServers": { "crawlora": { "url": "https://mcp.crawlora.net/mcp", "headers": { "Authorization": "Bearer ${CRAWLORA_API_KEY}" } } } }

Codex CLI

codex mcp add crawlora \

--url https://mcp.crawlora.net/mcp \ --bearer-token-env-var CRAWLORA_API_KEY

VS Code (GitHub Copilot)

.vscode/mcp.json (project) or your user mcp.json:

{

"servers": { "crawlora": { "type": "http", "url": "https://mcp.crawlora.net/mcp", "headers": { "Authorization": "Bearer ${env:CRAWLORA_API_KEY}" } } } }

Windsurf

~/.codeium/windsurf/mcp_config.json (note the serverUrl key):

{

"mcpServers": { "crawlora": { "serverUrl": "https://mcp.crawlora.net/mcp", "headers": { "Authorization": "Bearer ${env:CRAWLORA_API_KEY}" } } } }

Gemini CLI

~/.gemini/settings.json (note the httpUrl key):

{

"mcpServers": { "crawlora": { "httpUrl": "https://mcp.crawlora.net/mcp", "headers": { "Authorization": "Bearer YOUR_CRAWLORA_API_KEY" } } } }

Cline / Roo Code

Add to cline_mcp_settings.json using the generic remote shape — full walkthrough in llms-install.md:

{

"mcpServers": { "crawlora": { "url": "https://mcp.crawlora.net/mcp", "transport": "streamable-http", "headers": { "Authorization": "Bearer ${CRAWLORA_API_KEY}" } } } }

Other clients

Any client that speaks Streamable HTTP can use the generic config in examples/mcp.json. stdio‑only clients (e.g. Zed) should run the local server below and point at its npx command.

Run it locally (open‑source server)

This repo also ships a small stdio MCP server (index.mjs) that exposes the same 4186 tools, each wrapping the Crawlora REST API (https://api.crawlora.net/api/v1) with your CRAWLORA_API_KEY. Useful if you'd rather run the server yourself than use the hosted endpoint.

The counts above describe this repository’s current source catalog. The npm package used by npx crawlora-mcp may contain the previous catalog until a tagged release is published. To use this source snapshot, clone the repository and follow the local setup instructions below.

# Node 20+ (no install)

CRAWLORA_API_KEY=your-key npx -y crawlora-mcp

or from a clone

npm install && CRAWLORA_API_KEY=your-key node index.mjs

or Docker

docker build -t crawlora-mcp . && docker run -i -e CRAWLORA_API_KEY=your-key crawlora-mcp

Client config (stdio):

{

"mcpServers": { "crawlora": { "command": "npx", "args": ["-y", "crawlora-mcp"], "env": { "CRAWLORA_API_KEY": "your-key" } } } }

The tool definitions in tools.json are generated from Crawlora's published API catalog; each carries its real input schema and maps to a single REST endpoint.

Hosted MCP (recommended)

Just paste the URL into your client settings. No Node.js required.

https://mcp.crawlora.net/mcp

Header: x-api-key:

Get a key at crawlora.net. Every account includes 2,000 free credits / month with no credit card required.

What you can call (4186 tools / 500 platform groups)

See tools.json or your MCP client UI for exact schemas, the index of every tool by platform at the end of this README, and TOOLS.md for each tool's description. Below is an overview by category:

Why Crawlora MCP?

• One key, 4186 tools — search, commerce, social, gaming, finance, and more behind a single MCP endpoint.
• Structured JSON, not HTML — every tool returns normalized fields, so an agent can use the result without writing a parser.
• Hosted or local — connect to the hosted Streamable HTTP endpoint with no install, or run the open-source stdio server from this repo with npx or Docker.
• Free to start — 2,000 credits per month with no credit card.

A good alternative to stitching together SerpApi, Firecrawl, ScraperAPI, or ScrapingBee.

Links

• Website: https://crawlora.net/mcp
• Docs & Playground: https://crawlora.net/docs · https://crawlora.net/playground
• Pricing: https://crawlora.net/pricing
• Server card: https://crawlora.net/.well-known/mcp/server-card.json
• Official MCP registry manifest: server.json

License

See LICENSE. The Crawlora MCP service itself is a hosted SaaS governed by the Crawlora terms; this repository contains connection docs and manifests.

Tools

All 4186 tools by platform, generated from tools.json. TOOLS.md has the description of every tool.

• 1stdibs (4): firstdibs_categories, firstdibs_designers, firstdibs_product, firstdibs_search
• 7now (13): sevennow_catalog, sevennow_categories, sevennow_category, sevennow_combo, sevennow_combos, sevennow_deals, sevennow_offers, sevennow_popular, sevennow_product, sevennow_promotion, sevennow_search, sevennow_stores, sevennow_suggest
• abcau (5): abcau_article, abcau_author, abcau_headlines, abcau_news, abcau_sections
• abcnews (5): abcnews_article, abcnews_author, abcnews_headlines, abcnews_news, abcnews_sections
• accor (8): accor_amenities, accor_brands, accor_catalog_hotels, accor_destination_hotels, accor_property, accor_search, accor_search_details, accor_search_suggest
• adidas (7): adidas_product, adidas_product_review_topics, adidas_product_reviews, adidas_search, adidas_store, adidas_stores, adidas_suggest
• agoda (8): agoda_activities_search, agoda_activity_detail, agoda_flights_itinerary_amenities, agoda_flights_search, agoda_flights_search_locations, agoda_homes_search, agoda_hotel_detail, agoda_hotels_search
• airbnb (7): airbnb_host, airbnb_host_listings, airbnb_host_reviews, airbnb_room, airbnb_room_calendar, airbnb_room_reviews, airbnb_search
• alcom (3): alcom_headlines, alcom_news, alcom_sections
• aliexpress (8): aliexpress_categories, aliexpress_category_ids, aliexpress_category_products, `al