内容
# Crawlora MCP
[](https://crawlora.net/mcp)
[](https://crawlora.net/docs)
[](https://modelcontextprotocol.io)
[](https://smithery.ai/servers/crawlora/crawlora)
[](https://glama.ai/mcp/servers/Crawlora-org/crawlora-mcp)
**Crawlora MCP** 是一个托管的模型上下文协议服务器，为 AI 客户端和代理提供 **478 个结构化的公共网络数据工具**，涵盖 30 多个类别 — 搜索、地图、电子商务、社交、金融、旅行、应用商店、媒体和评论 — 每个工具返回干净、规范的 **JSON** 而不是 HTML 进行解析。
> **使用它的两种方式：** 将任何 MCP 客户端连接到托管的端点 (`https://mcp.crawlora.net/mcp`)，或在此仓库中运行小型开源本地服务器 (`npx` / Docker，stdio) — 两者都暴露相同的工具，并使用您的 Crawlora API 密钥进行身份验证。 在 **[crawlora.net](https://crawlora.net)** 上免费开始使用 **每月 2,000 积分**（无需信用卡）。
## 连接
| | |
|---|---|
| **端点** | `https://mcp.crawlora.net/mcp` |
| **传输** | 流式 HTTP |
| **身份验证** | `Authorization: Bearer <CRAWLORA_API_KEY>`（推荐）— `x-api-key: <key>` 也被接受 |
| **获取密钥** | https://crawlora.net（免费 2,000 积分/月） |
| **服务器卡** | https://crawlora.net/.well-known/mcp/server-card.json |
缺少或无效的 API 密钥将返回 `401`。
## 连接您的客户端
Crawlora MCP 与任何支持 MCP 的客户端配合使用。 在下面选择您的客户端 — 它们都指向同一个托管端点 (`https://mcp.crawlora.net/mcp`，流式 HTTP）并使用您的 `CRAWLORA_API_KEY` 进行身份验证。 优先将密钥存储在环境变量中，而不是直接粘贴，并且永远不要提交它。 每个客户端的即用文件都位于 [`examples/`](examples/) 中。
### Claude Code（CLI）
```bash
claude mcp add --transport http crawlora https://mcp.crawlora.net/mcp \
--header "Authorization: Bearer ${CRAWLORA_API_KEY}"
```
默认情况下添加到 `local` 作用域。 使用 `--scope user` 使其在每个项目中可用，或使用 `--scope project` 编写共享的 `.mcp.json`。 使用 `claude mcp list` 进行确认。
### Claude Desktop
设置 → 开发者 → **编辑配置**，然后添加到 `claude_desktop_config.json`:
```json
{
"mcpServers": {
"crawlora": {
"url": "https://mcp.crawlora.net/mcp",
"transport": "streamable-http",
"headers": { "Authorization": "Bearer YOUR_CRAWLORA_API_KEY" }
}
}
}
```
### Cursor
项目本地 `.cursor/mcp.json`（或所有项目的 `~/.cursor/mcp.json`）：
```json
{
"mcpServers": {
"crawlora": {
"url": "https://mcp.crawlora.net/mcp",
"headers": { "Authorization": "Bearer ${CRAWLORA_API_KEY}" }
}
}
}
```
### Codex CLI
```bash
codex mcp add crawlora \
--url https://mcp.crawlora.net/mcp \
--bearer-token-env-var CRAWLORA_API_KEY
```
### VS Code（GitHub Copilot）
`.vscode/mcp.json`（项目）或用户 `mcp.json`:
```json
{
"servers": {
"crawlora": {
"type": "http",
"url": "https://mcp.crawlora.net/mcp",
"headers": { "Authorization": "Bearer ${env:CRAWLORA_API_KEY}" }
}
}
}
```
### Windsurf
`~/.codeium/windsurf/mcp_config.json`（注意 `serverUrl` 键）：
```json
{
"mcpServers": {
"crawlora": {
"serverUrl": "https://mcp.crawlora.net/mcp",
"headers": { "Authorization": "Bearer ${env:CRAWLORA_API_KEY}" }
}
}
}
```
### Gemini CLI
`~/.gemini/settings.json`（注意 `httpUrl` 键）：
```json
{
"mcpServers": {
"crawlora": {
"httpUrl": "https://mcp.crawlora.net/mcp",
"headers": { "Authorization": "Bearer YOUR_CRAWLORA_API_KEY" }
}
}
}
```
### Cline / Roo Code
将通用远程形状添加到 `cline_mcp_settings.json` — 在 [`llms-install.md`](llms-install.md) 中有完整的演练：
```json
{
"mcpServers": {
"crawlora": {
"url": "https://mcp.crawlora.net/mcp",
"transport": "streamable-http",
"headers": { "Authorization": "Bearer ${CRAWLORA_API_KEY}" }
}
}
}
```
### 其他客户端
任何支持 **流式 HTTP** 的客户端都可以使用 [`examples/mcp.json`](examples/mcp.json) 中的通用配置。 **仅支持stdio** 的客户端（例如 Zed）应运行下面的本地服务器并指向其 `npx` 命令。
## 本地运行（开源服务器）
此仓库还附带一个小型 **stdio** MCP 服务器 (`index.mjs`)，它公开了相同的 **478 个工具**，每个工具都包装了 Crawlora REST API (`https://api.crawlora.net/api/v1`) 以及您的 `CRAWLORA_API_KEY`。 如果您更愿意自己运行服务器而不是使用托管端点，则此服务器非常有用。
```bash
# Node 20+（无需安装）
CRAWLORA_API_KEY=your-key npx -y crawlora-mcp
# 或从克隆仓库
npm install && CRAWLORA_API_KEY=your-key node index.mjs
# 或 Docker
docker build -t crawlora-mcp . && docker run -i -e CRAWLORA_API_KEY=your-key crawlora-mcp
```
客户端配置（stdio）：
```json
{
"mcpServers": {
"crawlora": {
"command": "npx",
"args": ["-y", "crawlora-mcp"],
"env": { "CRAWLORA_API_KEY": "your-key" }
}
}
}
```
[`tools.json`](tools.json) 中的工具定义是从 Crawlora 公开的 API 目录生成的；每个工具都带有其真实的输入模式，并映射到单个 REST 端点。
## 您可以使用哪些工具（478 个工具 / 30 多个类别）
| 类别 | 工具 | 示例 |
|---|---|---|
| **金融和加密货币** | 142 | 雅虎财经、谷歌财经、CoinGecko、Polymarket、Kalshi、Metaculus — 报价、财务数据、筛选器、市场、趋势、硬币、预测市场 |
| **媒体和娱乐** | 113 | Spotify、Spotify Podcasts、Apple Podcasts、JustWatch、IMDb、Rotten Tomatoes、Box Office Mojo — 曲目、艺术家、图表、剧集、观看地点、标题、评分、票房 |
| **社交和视频** | 54 | YouTube、TikTok、Instagram、Reddit、LinkedIn — 搜索、个人资料、帖子、评论、转录、趋势 |
| **电子商务** | 36 | Amazon、eBay、Shopify、Shop.app — 产品、搜索、卖家、收藏、评论 |
| **搜索和网络** | 27 | Google、Bing、Brave、Google Trends、Web Scrape — SERPs、建议、新闻、视频、图像、兴趣随时间变化、URL 转 Markdown |
| **应用商店** | 20 | App Store、Google Play — 应用详情、评论、排名、类似应用 |
| **评论和公司** | 18 | Trustpilot、Product Hunt — 商业评论、发布、制造商、排行榜 |
| **旅行和房地产** | 21 | Airbnb、TripAdvisor、Zillow、Redfin — 房源、日历、酒店、房产数据、估值、地区趋势 |
| **数据和实用工具** | 12 | 数据集、SimilarWeb、使用情况 — 整理的数据集、网站智能、账户使用情况 |
| **地图和地点** | 5 | Google Maps、Geocoding — 地点搜索、详情、正/反地理编码 |
完整的、始终更新的工具列表，包含参数、响应示例和实时 Playground：**https://crawlora.net/docs**。
## 为什么选择 Crawlora
- **每个工具都提供规范的 JSON** — 提供数据功能，而不是爬虫基础设施。
- **无需维护代理、浏览器或解析器**。
- **按成功付费** — 基于积分，按 `2xx` 响应计费。
- **一个密钥，478 个工具** — 搜索、商业、社交、金融等都通过一个 MCP 端点提供。
一种替代缝合 SerpApi、Firecrawl、ScraperAPI 或 ScrapingBee 的好方法。
## 链接
- 网站：https://crawlora.net/mcp
- 文档和 Playground：https://crawlora.net/docs · https://crawlora.net/playground
- 定价：https://crawlora.net/pricing
- 服务器卡：https://crawlora.net/.well-known/mcp/server-card.json
- 官方 MCP 注册表清单：[`server.json`](server.json)
## 许可证
参见 [`LICENSE`](LICENSE)。 Crawlora MCP 服务本身是一个托管的 SaaS，由 [Crawlora 条款](https://crawlora.net) 管辖；此仓库包含连接文档和清单。
