leadpipe

Leadpipe MCP

Leadpipe のインテント API およびデータ API 用の公式 MCP サーバーです。

このサーバーを使用すると、エージェントが以下に直接アクセスできます。

• トピックの発見
• Web サイトのトピック分析
• オーディエンスのプレビューとアドホッククエリ
• 保存済みオーディエンスの管理
• オーディエンスのステータス、結果、実行履歴、統計、エクスポート
• 訪問者データの検索
• トラッキングピクセルの管理
• アカウントの健全性とクレジットのステータス

概要

Leadpipe MCP は、Leadpipe の公開インテント API およびデータ API を、エージェントが stdio 経由で使用できるローカル MCP サーバーとして提供します。

このサーバーはデフォルトで API キー認証を使用するため、オーディエンスのワークフロー全体、訪問者データへのアクセス、ピクセル管理のワークフローをエージェントで利用できます。

Claude、Cursor、Codex での使用

ほとんどのユーザーは、このリポジトリをクローンしたり、ソースからビルドしたりする必要はありません。公開済みパッケージは次のとおりです。

npx -y @leadpipe/mcp

必要なものは次のとおりです。

export LEADPIPE_API_KEY=sk_...

任意の上級者向けオーバーライド：

export LEADPIPE_BASE_URL=https://api.aws53.cloud

LEADPIPE_BASE_URL を変更する必要があるのは、デフォルト以外の環境を指定する場合のみです。

Claude Desktop

Claude Desktop の MCP 設定に以下を追加してください。

{
  "mcpServers": {
    "leadpipe": {
      "command": "npx",
      "args": ["-y", "@leadpipe/mcp"],
      "env": {
        "LEADPIPE_API_KEY": "sk_..."
      }
    }
  }
}

Cursor

~/.cursor/mcp.json に以下を追加してください。

{
  "mcpServers": {
    "leadpipe": {
      "command": "npx",
      "args": ["-y", "@leadpipe/mcp"],
      "env": {
        "LEADPIPE_API_KEY": "sk_..."
      }
    }
  }
}

Codex

Codex CLI でサーバーを追加してください。

codex mcp add leadpipe --env LEADPIPE_API_KEY=sk_... -- npx -y @leadpipe/mcp

続いて、設定されていることを確認してください。

codex mcp list

クイックスタート

パッケージが実行できることだけを確認する場合：

npx -y @leadpipe/mcp

ソースから実行

ローカル開発やリポジトリの編集を行う場合：

npm install
npm run build
node dist/index.js

ローカルで反復開発を行う場合：

npm run dev

ローカルソースビルド用の MCP 設定：

{
  "mcpServers": {
    "leadpipe": {
      "command": "node",
      "args": ["/absolute/path/to/mcp/dist/index.js"],
      "env": {
        "LEADPIPE_API_KEY": "sk_..."
      }
    }
  }
}

ツール一覧

トピックの発見

• list_topics
• get_topic_facets
• search_topics
• get_topic_trend
• compare_topics
• get_topic_movers
• analyze_website_topics

オーディエンスビルダー

• get_audience_filters
• preview_audience
• query_audience
• list_audiences
• get_audience
• create_audience
• update_audience
• delete_audience

オーディエンスの結果

• get_audience_status
• get_audience_results
• list_audience_runs
• get_audience_stats
• export_audience

訪問者データ

• query_visitor_data

ピクセル

• list_pixels
• create_pixel
• update_pixel

アカウント

• get_account_status

プロンプト

• discover-audience-topics
• operate-saved-audience
• investigate-visitor-data

プロンプトの例

この MCP サーバーで効果的に使える、コピーして貼り付けられるプロンプトについては、examples/prompt-examples.md をご覧ください。

おすすめのプロンプト：

• 「クラウドコスト最適化ソフトウェアに関する B2B トピックを 5～10 件見つけ、最近のトレンドを比較して、オーディエンスをプレビューしてください。」
• 「これらのトピックを対象に保存済みオーディエンスを作成して有効化し、準備が整うまで待ってから、最初のページの結果を要約してください。」
• 「オーディエンス <audience-id> のステータスを確認してください。準備が整っていたらエクスポートして、ダウンロード URL を教えてください。」
• 「過去 30 日間の example.com の訪問者アクティビティを調査し、トラッキングの設定が正常かどうか教えてください。」
• 「ピクセルを一覧表示し、一時停止中のものがあれば見つけて、対応が必要な点を説明してください。」

エージェント向けプレイブック

より体系的な運用フローについては、以下をご覧ください。

• オーディエンス調査プレイブック
• 訪問者診断プレイブック

リソース

• leadpipe://docs/auth
• leadpipe://docs/workflows
• leadpipe://docs/data-api

一般的なエージェントのワークフロー

1. トピックを検索または分析する
2. オーディエンスの規模をプレビューする
3. 保存済みオーディエンスを作成または更新する
4. オーディエンスの準備が整うまでステータスを確認する
5. 結果を取得するか、CSV をエクスポートする

一般的なデータのワークフロー

1. get_account_status を確認する
2. query_visitor_data で訪問者アクティビティをクエリする
3. list_pixels ／ create_pixel でピクセルを確認または作成する
4. update_pixel でトラッキングを一時停止または再開する

開発

npm run typecheck
npm run build

ライセンス

MIT