Piloterr

Piloterr MCP サーバー

Piloterr のウェブスクレイピング API 用の公式 Model Context Protocol サーバーです。

1 つの 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 を使いたい場合、独自のネットワーク egress を使用したい場合、またはセルフホストしたい場合は、パッケージをローカルで実行してください。

ローカルで実行する

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	391 個の Piloterr エンドポイントを検索します。
get_endpoint	1 つのエンドポイントのパラメーターを説明します。
call_endpoint	1 つの 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 の背後に配置してください。

createHttpHandler() は Fetch 互換ランタイム（Cloudflare Workers、Deno、Bun）向けにエクスポートされています。

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	パッケージ	インストール
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 を参照してください。