PulpMiner

PulpMiner MCP サーバー

ソース：github.com/pulpminercom/pulpminer-mcp · 問題：github.com/pulpminercom/pulpminer-mcp/issues

PulpMiner 用の MCP サーバーです。AI アシスタント（Cursor、Claude Desktop、その他の MCP クライアント）から、次のことができます。

• AI を使って、あらゆる Web ページから JSON を生成します。 PulpMiner がページをスクレイピングし、LLM が構造化 JSON に変換します。指定した形式に正確に合わせることもできます。
• ページから JSON を生成する設定を、再利用可能な REST API として保存します（静的、または URL 内の {{ variables }} を使った動的な設定）。
• 保存済み API からデータを取得し、API の一覧を表示します。

ツール

ツール	内容	バックエンドのエンドポイント	クレジット
pulpminer_generate_json	URL をスクレイピングし、AI で JSON に変換します（任意で jsonFormat のサンプル、CSS の selector、追加の指示を指定できます）	POST /external/ai/json	0.25（renderJs の場合は +0.1）
pulpminer_save_as_api	URL と JSON 形式（任意で動的 URL テンプレート、キャッシュも指定可能）を API として保存し、API ID とエンドポイントを返します	POST /external/ai/json/save	無料
pulpminer_fetch_api_data	保存済み API を呼び出します（GET、または動的 API の場合は variables を指定して POST）	GET/POST /external/{apiId}	0.4（renderJs の場合は +0.1）
pulpminer_list_saved_apis	保存済み API の一覧を表示します（ID、URL、動的 URL テンプレートとその変数）	GET /external/api/url	無料
pulpminer_check_api_key	API キーを検証し、設定済みの認証情報を表示します	GET /external/n8n/auth	無料

オプション値はバックエンドと同じです。scraper は scraper_1（デフォルト）または scraper_2 です。llm は llm_2（OpenAI GPT、デフォルト）、llm_1（Google Gemini）、または llm_3（アカウントで有効になっている場合のみ Groq）です。

設定

環境変数	必須	説明
PULPMINER_API_KEY	はい	PulpMiner ダッシュボードの「API Keys」から取得した API キーです。apikey ヘッダーとして送信されます。すべてのツールで必要な認証情報はこれだけです。
PULPMINER_BASE_URL	いいえ	デフォルトは https://api.pulpminer.com です
PULPMINER_TIMEOUT_MS	いいえ	デフォルトは 300000 です（スクレイピングと LLM の処理には時間がかかる場合があります）

インストールとビルド

git clone https://github.com/pulpminercom/pulpminer-mcp.git
cd pulpminer-mcp
npm install
npm run build

実行します。

PULPMINER_API_KEY=... node dist/index.js          # stdio
PULPMINER_API_KEY=... node dist/index.js --http   # Streamable HTTP on http://127.0.0.1:3333/mcp

npm への公開後は、npx -y pulpminer-mcp で実行できます。

クライアントの設定

Cursor（~/.cursor/mcp.json または .cursor/mcp.json）

{
  "mcpServers": {
    "pulpminer": {
      "command": "npx",
      "args": ["-y", "pulpminer-mcp"],
      "env": { "PULPMINER_API_KEY": "your-api-key" }
    }
  }
}

Claude Desktop（claude_desktop_config.json）

{
  "mcpServers": {
    "pulpminer": {
      "command": "npx",
      "args": ["-y", "pulpminer-mcp"],
      "env": { "PULPMINER_API_KEY": "your-api-key" }
    }
  }
}

公開前は、ローカルビルドを使用してください："command": "node", "args": ["/absolute/path/to/pulpminer-mcp/dist/index.js"]。

Streamable HTTP クライアント

--http を指定して起動し（環境変数 PORT、HOST を使用。デフォルトでは 127.0.0.1:3333 にバインド）、クライアントから http://127.0.0.1:3333/mcp に接続します。サーバーはステートレスです。各リクエストでは、独自の API キーを x-pulpminer-api-key ヘッダーで送信できます。このキーは PULPMINER_API_KEY より優先されます。これにより、ホスト型のマルチユーザーエンドポイントとして利用できます（HTTPS の背後に配置してください）。

{
  "mcpServers": {
    "pulpminer": {
      "url": "http://127.0.0.1:3333/mcp",
      "headers": { "x-pulpminer-api-key": "your-api-key" }
    }
  }
}

一般的な流れ

1. pulpminer_generate_json { url, jsonFormat? }：JSON をプレビューします。
2. pulpminer_save_as_api { url, jsonFormat, cache?, dynamicUrl? }：apiId と endpoint を返します。
3. pulpminer_fetch_api_data { apiId, variables? }

動的 API の例：dynamicUrl: "https://example.com/search?q={{ query }}" を指定し、variables: { "query": "laptops" } を使って取得します。

開発

npm test        # builds, then runs scripts/smoke-test.mjs against a local mock API (no real calls)
npm run inspect # opens the MCP Inspector UI
npx @modelcontextprotocol/inspector --cli node dist/index.js --method tools/list

ホスト型サーバー（リモート）

remote/ は Cloudflare Worker で、Streamable HTTP（ステートレス）を介して同じツールを https://mcp.pulpminer.com/mcp で提供します。PulpMiner API キーを Authorization: Bearer <key>（または x-pulpminer-api-key）として送信してください。キーは PulpMiner API に転送されるだけで、保存されることはありません。

{ "mcpServers": { "pulpminer": { "url": "https://mcp.pulpminer.com/mcp", "headers": { "Authorization": "Bearer YOUR_API_KEY" } } } }

ローカル開発：cd remote && npm install && npm run dev（Node 22 以上）。