Piloterr

Piloterr MCP 服务

Model Context Protocol 官方服务，适用于 Piloterr 网页抓取 API。

使用一个 API，即可将 300 多个网站（Amazon、LinkedIn、Google、Zillow、Crunchbase……）抓取为结构化 JSON。

它可让 Claude、Cursor、VS Code、Windsurf 及任何 MCP 客户端将 API 作为工具调用。支持通过 stdio（本地）或 Streamable HTTP（可自托管）运行。

要求

• Node.js 20 或更高版本
• Piloterr API 密钥 — 注册，然后从控制面板复制密钥

托管服务（推荐）

Piloterr 会在 https://mcp.piloterr.com/（Streamable HTTP）为你运行此服务。只需在 x-api-key 标头中发送 API 密钥；无需安装。

claude mcp add --transport http piloterr https://mcp.piloterr.com/ --header "x-api-key: YOUR_API_KEY"

{
  "mcpServers": {
    "piloterr": {
      "url": "https://mcp.piloterr.com/",
      "headers": {
        "x-api-key": "YOUR_API_KEY"
      }
    }
  }
}

托管服务与此软件包提供相同的 API；如果你需要使用 stdio、自己的网络出口或自行托管，可在本地运行此软件包。

本地运行

Claude Code

claude mcp add piloterr --env PILOTERR_API_KEY=YOUR_API_KEY -- npx -y @piloterr/mcp

Claude Desktop、Cursor、Windsurf 及其他客户端

将服务添加到客户端的 MCP 配置（claude_desktop_config.json、.cursor/mcp.json……）：

{
  "mcpServers": {
    "piloterr": {
      "command": "npx",
      "args": ["-y", "@piloterr/mcp"],
      "env": {
        "PILOTERR_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

VS Code

{
  "servers": {
    "piloterr": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@piloterr/mcp"],
      "env": {
        "PILOTERR_API_KEY": "${input:piloterr-api-key}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "piloterr-api-key",
      "description": "Piloterr API key",
      "password": true
    }
  ]
}

Claude Desktop 扩展

从发布页面下载 .mcpb 安装包并打开；Claude Desktop 会提示你输入 API 密钥。

Docker

docker build -t piloterr-mcp .
docker run -i --rm -e PILOTERR_API_KEY=YOUR_API_KEY piloterr-mcp

工具

Piloterr 有 391 个端点，若将它们分别作为工具加载，数量就超过了客户端的承载能力。因此，此服务提供了一个小型目录：模型可先搜索目录，再查看某个端点的参数，然后调用该端点。

工具	说明
search_endpoints	搜索 Piloterr 的 391 个端点。
get_endpoint	描述某个端点的参数。
call_endpoint	调用一个 Piloterr 端点并返回结果。
usage	显示 API 用量和剩余额度。

每个调用 API 的工具都会消耗额度。JSON 结果以文本形式返回；图像会以内嵌形式返回，其他文件（PDF……）则作为嵌入式资源返回，大小上限为 4 MB。

Streamable HTTP

npx @piloterr/mcp --http --port 3000

端点为 POST /mcp（无状态，返回 JSON）。每个客户端都在 x-api-key 标头中发送自己的密钥（或使用 Authorization: Bearer <key>）；服务本身不会使用自己的密钥。默认绑定到 127.0.0.1，并会拒绝浏览器来源，除非你允许这些来源——对外开放前，请将其置于 TLS 后。

为兼容 Fetch 的运行时（Cloudflare Workers、Deno、Bun）导出了 createHttpHandler()：

import { createHttpHandler } from "@piloterr/mcp";

export default { fetch: createHttpHandler({ allowedOrigins: [] }) };

安全

• API 密钥从 PILOTERR_API_KEY（stdio）或请求标头（HTTP）中读取，并会从错误消息中移除。
• 从网站获取的内容不可信：服务说明会告知模型将其视为数据，而非指令。
• 请参阅 SECURITY.md 报告漏洞。

开发

npm install
npm test
npm run build
npx @modelcontextprotocol/inspector node dist/stdio.js

基于 SDK 构建

此服务使用官方 Node.js SDK（@piloterr/sdk）。

所有 Piloterr SDK

SDK	Package	安装
Node.js	@piloterr/sdk	npm install @piloterr/sdk
Python	piloterr	pip install piloterr
Go	piloterr-go	go get github.com/piloterr/piloterr-go
.NET	Piloterr	dotnet add package Piloterr
Ruby	piloterr	gem install piloterr
PHP	piloterr/sdk	composer require piloterr/sdk
Java	piloterr-java	从源代码构建，详见其 README
CLI	@piloterr/cli	npm install -g @piloterr/cli
MCP 服务	@piloterr/mcp	npx -y @piloterr/mcp

许可证

MIT — 详见 LICENSE。