Crawlora-org/crawlora-mcp

**Crawlora MCP** is a **hosted** Model Context Protocol server that gives AI clients and
agents **3631 structured public‑web‑data tools** across 471 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**.
Connection
| | |
|---|---|
| **Endpoint** | https://mcp.crawlora.net/mcp |
| **Transport** | Streamable HTTP |
| **Auth** | Authorization: Bearer (preferred) — x-api-key: also accepted |
| **Get a key** | https://crawlora.net (free 2,000 credits/mo) |
| **Server card** | https://crawlora.net/.well-known/mcp/server-card.json |
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)
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:
Cursor
Project‑local .cursor/mcp.json (or ~/.cursor/mcp.json for all projects):
Codex CLI
VS Code (GitHub Copilot)
.vscode/mcp.json (project) or your user mcp.json:
Windsurf
~/.codeium/windsurf/mcp_config.json (note the serverUrl key):
Gemini CLI
~/.gemini/settings.json (note the httpUrl key):
Cline / Roo Code
Add to cline_mcp_settings.json using the generic remote shape — full walkthrough in
llms-install.md:
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 **3631
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.
Client config (stdio):
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.
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 (3631 tools / 471 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:
| Category | Highlights |
|---|---|
| **Search & Web** | google_search, google_news, bing_search, duckduckgo_search, baidu_search, brave_search, startpage_search, yandex_search, kagi_search, web_scrape, web_parse, bbb_search, bbb_search_filters |
| **Maps & Places** | google_maps_search, google_maps_place, google_maps_reviews, google_maps_photos, bbb_regions, bbb_local_bbbs, bbb_local_bbb |
| **Marketplace & Products** | amazon_search, amazon_product, amazon_reviews, walmart_search, ebay_search, etsy_search, shopify_store, target_search, doordash_store, doordash_feed, ubereats_store |
| **Social & Profiles** | twitter_user, twitter_tweet, instagram_user, reddit_post, reddit_comments, threads_user, tiktok_user |
| **Finance & Markets** | google_finance_search, google_finance_quote, yahoo_finance_quote, polymarket_events, kalshi_markets |
| **Research & Papers** | research_search_papers, research_inspect_paper, research_read_paper, research_related_papers, research_sources |
| **Travel & Lodging** | airbnb_search, airbnb_room, tripadvisor_search, booking_search |
| **Jobs & Companies** | linkedin_jobs, indeed_jobs, glassdoor_company, pitchbook_company |