Competlab Mcp Server

CompetLab MCP サーバー

AI エージェント向けの競合インテリジェンス — AI があなたの顧客にどこを案内しているのか、そしてどう対応すべきかを把握できます。

B2B の購入者は、Google 検索をする前に AI に質問するようになっています。CompetLab は、AI Visibility（ChatGPT、Claude、Gemini、Perplexity、Google AI Overviews がどのブランドを推奨しているかを追跡）や、AI Sources（Perplexity と Google AI Overviews が購入者の質問に回答する際に参照するページ）を含む 6 つの側面から競合をモニタリングします。この MCP サーバーにより、AI エージェントはダッシュボード、過去のデータ、アラート、Strategic Briefing、プロジェクトの Strategic Tickets ボードなど、すべてにアクセスできます。

対応クライアント

MCP 対応のクライアントであれば、どれでも利用できます。

• Claude Desktop / Claude Web
• Claude Code
• Cursor
• VS Code (Copilot)
• Windsurf
• Cline

クイックスタート

接続方法は 2 つあります。環境に合った方法を選んでください。

	リモートサーバー	ローカルサーバー
トランスポート	Streamable HTTP	stdio
セットアップ	インストール不要 — URL を追加するだけ	npm install && npm run build
おすすめの用途	多くのユーザー — Claude Code、Cursor、VS Code、Windsurf、Cline	Claude Desktop、Glama、またはプロセスを自分で実行する場合

API キーを取得します：app.competlab.com > Organization Settings > API Keys

オプション 1：リモートサーバー（推奨）

サーバー URL： https://mcp.competlab.com/mcp 認証： CL-API-Key ヘッダー経由の API キー（または api_key クエリパラメーター）

Claude Code

claude mcp add --transport http \
  --header "CL-API-Key: YOUR_COMPETLAB_API_KEY" \
  competlab https://mcp.competlab.com/mcp

Cursor

.cursor/mcp.json に追加します。

{
  "mcpServers": {
    "competlab": {
      "url": "https://mcp.competlab.com/mcp",
      "headers": {
        "CL-API-Key": "YOUR_COMPETLAB_API_KEY"
      }
    }
  }
}

VS Code

.vscode/mcp.json に追加します。

{
  "inputs": [
    {
      "type": "promptString",
      "id": "competlab-api-key",
      "description": "CompetLab API Key (starts with cl_live_)",
      "password": true
    }
  ],
  "servers": {
    "competlab": {
      "type": "http",
      "url": "https://mcp.competlab.com/mcp",
      "headers": {
        "CL-API-Key": "${input:competlab-api-key}"
      }
    }
  }
}

注：VS Code では "mcpServers" ではなく "servers" を使用し、${input:id} による安全な入力プロンプトをサポートしています。

Windsurf

~/.codeium/windsurf/mcp_config.json に追加します。

{
  "mcpServers": {
    "competlab": {
      "serverUrl": "https://mcp.competlab.com/mcp",
      "headers": {
        "CL-API-Key": "YOUR_COMPETLAB_API_KEY"
      }
    }
  }
}

注：Windsurf では "url" ではなく "serverUrl" を使用します。

Cline

cline_mcp_settings.json に追加します（または Cline UI > Installed > Advanced MCP Settings から設定します）。

{
  "mcpServers": {
    "competlab": {
      "url": "https://mcp.competlab.com/mcp",
      "headers": {
        "CL-API-Key": "YOUR_COMPETLAB_API_KEY"
      },
      "disabled": false
    }
  }
}

Claude Desktop / Claude Web

Claude Desktop と Claude Web は URL ベースの認証のみをサポートしています（カスタムヘッダーは使用できません）。api_key クエリパラメーターを使用してください。

Settings > MCP に移動し、次の URL でサーバーを追加します。

https://mcp.competlab.com/mcp?api_key=YOUR_COMPETLAB_API_KEY

オプション 2：ローカルサーバー（stdio）

stdin/stdout 経由でサーバーをローカル実行します。Claude Desktop、Glama、または stdio トランスポートを優先する環境に適しています。

git clone https://github.com/competlab/competlab-mcp-server.git
cd competlab-mcp-server
npm install
npm run build

Claude Code

claude mcp add --transport stdio \
  --env COMPETLAB_API_KEY=YOUR_COMPETLAB_API_KEY \
  competlab node dist/index.js

Claude Desktop

Claude Desktop の設定ファイル（claude_desktop_config.json）に追加します。

{
  "mcpServers": {
    "competlab": {
      "command": "node",
      "args": ["dist/index.js"],
      "cwd": "/path/to/competlab-mcp-server",
      "env": {
        "COMPETLAB_API_KEY": "YOUR_COMPETLAB_API_KEY"
      }
    }
  }
}

汎用 stdio

COMPETLAB_API_KEY=YOUR_COMPETLAB_API_KEY node dist/index.js

サーバーは stdin から JSON-RPC を読み取り、stdout に応答を書き込みます。

各クライアント向けの、すぐに貼り付けて使える設定ファイルについては、examples/ を参照してください。

CompetLab とは？

AI 時代の競合インテリジェンス：14 のディメンションを対象とします。6 つを継続的にモニタリングし、さらに最先端の 8 つのディメンションを調査して、毎月、Process では 2 週間ごとに戦略ブリーフィングを作成します。継続的にモニタリングする 6 つのディメンション：

ディメンション	追跡する内容
AI Visibility	ChatGPT、Claude、Gemini、Perplexity、Google AI Overviews があなたのカテゴリーでどの企業を推奨するか、各社の名前が挙がる頻度、そしてあなたの立ち位置
AI Sources	Perplexity と Google AI Overviews が顧客の質問に回答する際に参照するページと、その中にあなたが掲載されているかどうか
Positioning	各社のホームページに実際に書かれている内容、他社にはないあなたの訴求内容、変更点、そして各ページであなたについて述べられている内容
Pricing	各社の料金ページに実際に掲載されている料金、一般的な構成の費用（安い順）とあなたの立ち位置、変更点、そして各ページであなたについて述べられている内容
Content	サイトマップ分析、コンテンツの分類（12 カテゴリー）、URL の変更履歴、コンテンツの不足箇所
Tech & Trust	技術スタック、セキュリティヘッダー（A～F 評価）、信頼性シグナル（5 カテゴリー、26 シグナル）、アシスタントごとの AI アクセス

AI Visibility は、AI が誰を推奨するかに答えます。つまり、顧客が質問したときに ChatGPT、Claude、Gemini、Perplexity、Google AI Overviews がどのブランドの名前を挙げ、推奨するのか、そしてあなたが主要な候補に入っているかを示します。AI Sources はその補完機能です。Perplexity と Google AI Overviews が回答に至るまでに取得するページと、そこであなたの名前を挙げているかどうかを示します。

無料トライアルを開始（14 日間、クレジットカード不要） | 詳細を見る

利用可能なツール

48 個のツール。 40 個は読み取り専用です。3 個は非同期スキャンを開始し、スキャンレコードを作成します（start_tech_stack_scan、start_trust_signals_scan、start_agent_adoption_scan）。5 個はプロジェクトの戦略チケットボードに書き込みます（create_ticket、update_ticket、move_ticket、delete_ticket、add_ticket_comment）。これらの利用には read_write API キーが必要です。

プロジェクトと競合他社

ツール	説明
list_projects	ステータス、競合他社の数、最終モニタリング日時を含むすべてのプロジェクトを一覧表示します
get_project	ディメンションごとのモニタリングの最新状況を含むプロジェクトの詳細を取得します
list_competitors	モニタリング対象の競合他社をすべて一覧表示します（比較用に自社ドメインも含みます）
get_competitor	モニタリング対象のページ URL を含む競合他社の詳細を取得します

AI の可視性

ツール	説明
get_ai_visibility_dashboard	市場マップです。AI モデルがあなたのカテゴリでどの企業を推奨しているか、そしてあなたがその中に含まれているかを、モデルごとの内訳とともに確認できます。任意でモデルの生の回答も表示できます
get_ai_visibility_history	AI の可視性チェック履歴をページ分割して取得します
get_ai_visibility_check_detail	1 回分のチェックの詳細を取得します。任意で各モデルの実際の回答も取得できます。競合他社、モデル、プロンプトで絞り込めます。回答を取得した場合、includeSummary を指定しない限り、要約は含まれません

AI ソース

ツール	説明
get_ai_sources_dashboard	Perplexity と Google AI Overviews が、プロジェクトの購買に関する質問に回答する際に参照するページを、エンジンごとに確認できます。各エンジンが挙げた企業、取得したページ、他社について言及していてあなたについては言及していないページを表示します
get_ai_sources_history	AI ソースのチェック履歴をページ分割して取得します
get_ai_sources_check_detail	1 回分の AI ソースチェックの詳細を取得します。任意で各回答と取得したページも取得できます。エンジンまたは質問で絞り込めます。回答を取得した場合、includeSummary を指定しない限り、要約は含まれません

ポジショニング

ツール	説明
get_positioning_dashboard	各社のホームページに記載されている内容、他社にはないあなた独自の訴求内容、変更点、あなたについて記載しているページを確認できます
get_positioning_history	ポジショニングチェックごとに 1 行で、検出された変更の詳細を取得します。since で絞り込めます
get_positioning_run_detail	過去のポジショニングチェック 1 回分の詳細を、ダッシュボードと同じ形式で取得します

価格インテリジェンス

ツール	説明
get_pricing_dashboard	各社の料金ページに記載されている料金、一般的な構成の最安価格とあなたの立ち位置、変更点、あなたについて記載しているページを確認できます
get_pricing_history	価格チェックごとに 1 行で、検出された変更の詳細を取得します。since で絞り込めます
get_pricing_run_detail	過去の価格チェック 1 回分の詳細を、ダッシュボードと同じ形式で取得します

コンテンツインテリジェンス

ツール	説明
get_content_dashboard	最新のサイトマップ分析、コンテンツの分類、戦略的 URL、ギャップ分析
get_content_history	モニタリング実行履歴（ページネーション対応）
get_content_run_detail	特定のコンテンツ実行に関する全データ
get_content_changelog	時間の経過に伴う URL の変更（追加、削除）— 競合他社やカテゴリでフィルタリング可能

技術・信頼性プロファイル

ツール	説明
get_tech_trust_dashboard	最新のセキュリティヘッダー、信頼性シグナル、技術スタック、DNS、アシスタントごとの AI アクセス
get_tech_trust_history	モニタリング実行履歴（ページネーション対応）
get_tech_trust_run_detail	特定の実行に関する競合他社ごとの全データ

戦略ブリーフィング

ツール	説明
get_briefing	プロジェクトの戦略ブリーフィングの現在の状態 — 何が変わり、それが何を意味するのか、また今回の版がボード上で行ったこと。作成したチケット、既存のチケットにコメントした内容、重複して作成せずに既存のものと照合したチケットが含まれます。デフォルトでは hub ダイジェストを表示します。sections を渡すと、14 個の deep-<dimension> セクションのいずれかを表示できます
get_briefing_history	過去のブリーフィング版を新しい順に表示 — 各版の公開日、ステータス、見出しの評価
get_briefing_edition	run ID を指定して、過去のブリーフィング版を 1 件、全文表示

戦略チケット

プロジェクトのボードです。チームが実施すると決めた作業を、担当者、列、スレッドとともに管理します。アプリでチームが見るものと同じチケットが、triage、todo、in_progress、done、dismissed の5つの固定列に並びます。戦略ブリーフィングで行った変更はすべてここに反映されます。最も重要なものから順に triage に新しいチケットとして追加するか、その作業のチケットがすでにある場合はそこに反映します。また、後続のエディションでは、何かを測定した際に、すでにあるチケットにコメントします。チケット ID を受け取るツールはすべて、#14 のように人が入力する番号も受け取ります。read キーではチケットの一覧表示と読み取りができます。書き込みを行うツールには read_write キーが必要です。キーを使うと、組織内のすべての情報を読み取り、どのプランでも、またプラン終了後も、組織の戦略チケットボードを操作できます。CompetLab 側でサイトを取得またはスキャンする呼び出しにはプランが必要です（そうでない場合は 402 subscription_required になります）。

ツール	説明
list_tickets	プロジェクトの戦略チケットをページごとに表示します。ボード順、優先度順、期限順、最近のアクティビティ順に並べ替えられます。列、担当者、ラベル、影響度、作業量、期限、チケットを作成したエディションで絞り込めます。各ページには合計数と列ごとの件数が表示されます
get_ticket	1件のチケットの全情報を表示します。説明、ラベル、担当者、期限、作業量、影響度、スレッドの長さを確認できます
create_ticket	プロジェクトのボードにチケットを作成します。read_write API キーが必要です
update_ticket	チケットのタイトル、説明、ラベル、担当者、期限、作業量、影響度を変更します。read_write API キーが必要です
move_ticket	チケットを別の列に移動するか、並べ替えます。先頭、末尾、または指定した2件のチケットの間に移動できます。結果には移動先が表示されます。read_write API キーが必要です
delete_ticket	チケットとそのスレッドを削除します。read_write API キーが必要です
list_ticket_comments	チケットのコメントスレッドを古い順に表示します。各項目には、投稿者がユーザー、API キー、戦略ブリーフィングのいずれかが表示されます
add_ticket_comment	チケットのスレッドに Markdown コメントを追加します。read_write API キーが必要です
list_ticket_labels	プロジェクトのチケットラベルを表示します。それぞれの名前と色を確認できます
list_ticket_assignees	チケットの担当者に指定できるユーザーを表示します。組織の現在のメンバーが名前と ID とともに表示されます

アラートとスケジュール

ツール	説明
list_alerts	競合に関する変化のアラートです。指標、重大度、レベル、競合相手で絞り込めます
list_schedules	監視対象の6つの指標すべてについて、ステータスと間隔を含む監視スケジュールを表示します

無料ツール（プロジェクトのセットアップは不要）

公開ドメインならどこでも実行できます。projectId は不要です。同期ツールはすぐに結果を返します。非同期スキャンは scanId を返すので、5〜10 秒ごとにポーリングしてください。

ツール	説明
check_sitemap	サイトマップのライブ分析 — URL を検出し、セクションごとに分類して、階層の深さ、新しさ、カテゴリごとの件数を報告します
check_ai_crawlers	サイトの robots.txt を読み取り、どの AI アシスタント（ChatGPT、Claude、Perplexity、Microsoft Copilot、Google AI Overviews、Gemini Apps）がサイトのページを取得できるかをライブで確認します
start_tech_stack_scan	技術スタック検出の非同期スキャンを開始します（117 のルール：技術、成長、エンゲージメント）。scanId を返します
get_tech_stack_scan	scanId を指定して技術スタックスキャンをポーリングします — 完了すると、信頼度スコアとともに検出されたテクノロジーを返します
start_trust_signals_scan	信頼性シグナル分析の非同期スキャンを開始します（企業対応状況、検証、ソーシャルプルーフ、権威性、リスクに関する34のシグナル）。scanId を返します
get_trust_signals_scan	scanId を指定して信頼性シグナルスキャンをポーリングします — 完了すると、シグナルごとの判定とティア判定を返します
start_agent_adoption_scan	Agent Adoption Check の非同期スキャンを開始します（発見可能性、アクセス、可読性、エージェント用エンドポイントに関する25のチェック）。scanId を返します
get_agent_adoption_scan	scanId を指定して Agent Adoption Check をポーリングします — 完了すると結果全体を返します
fetch_url	JavaScript のレンダリングとボット対策への対応を行い、任意の URL を取得します。本文、ヘッダー、cleanStats を返します。オプションの cleanHtml はノイズを除去し、LLM のトークンコストを削減します。API キーごとに毎分60リクエスト

ページネーション対応のツールはすべて、page と limit パラメーターを受け付けます。レスポンスの pagination.hasMore を確認して、次のページを取得してください。

AI Visibility と AI Sources のダッシュボードおよびチェックの詳細、AI Visibility の履歴、Tech & Trust のダッシュボードは、デフォルトでコンパクトなビューで回答します。マーケットマップ、ページ一覧、ブランド一覧は1ページずつ返されます。自社の行は常に表示され、マーケットマップでは追跡対象の競合他社すべての行も常に表示されます。また、行数を示す *Page オブジェクト（offset、limit、total、hasMore）も含まれます。すべての行を1つのレスポンスで取得するには、view=full を指定してください。これらのレスポンスはいずれも冒頭に readingGuide があり、各フィールドの読み取り方が記載されています。

レスポンスは CompetLab API から変更されずに渡され、サーバーの指示によってエージェントが内容を読み取れるようになっています。特に、null は CompetLab が値を測定していないことを意味し、ゼロや「なし」を意味するものではありません。

プロンプトの例

接続したら、AI エージェントに次のように尋ねてみてください。

• 「AI モデルは私のカテゴリでどの企業を推奨していますか？　その中に私も含まれていますか？」
• 「競合他社の名前は挙がっているのに私の名前は挙がっていない、購入検討者の質問に対して、Perplexity と Google AI Overviews はどのページを読んでいますか？」
• 「今週、競合他社の料金ページで何が変わりましたか？」
• 「戦略ブリーフィングを表示してください。最初に何を修正すべきですか？」
• 「最新のブリーフィングで起票されたチケットはどれですか？　ボード上での状況も教えてください。」
• 「過去3か月で AI マーケットマップはどう変化しましたか？」
• 「追跡対象の競合他社すべてのコンテンツ戦略を比較してください」
• 「過去7日間に発生した重大なアラートは何ですか？」
• 「私たちよりセキュリティヘッダーが優れている競合他社はどこですか？」
• 「stripe.com の技術スタックスキャンを実行してください。どのような技術を使っていますか？」
• 「その robots.txt によると、どの AI アシスタントが openai.com にアクセスできますか？」
• 「cleanHtml を指定して g2.com/some-listing を取得し、ページを要約してください」

ユースケース別にまとめたプロンプトについては、examples/prompts.md をご覧ください。

認証

API キーの取得

1. app.competlab.com/register で登録します（14 日間の無料トライアル、クレジットカード不要）
2. Organization Settings > API Keys に移動します
3. 新しいキーを作成します。キーは cl_live_ で始まります

2 つの認証方法

方法	使用する場面	例
CL-API-Key ヘッダー	Claude Code、Cursor、VS Code、Windsurf、Cline	CL-API-Key: cl_live_...
api_key クエリパラメーター	Claude Desktop、Claude Web、カスタムヘッダーに対応していないクライアント	?api_key=cl_live_...

API キー 1 つで組織全体をカバーします。ほとんどのツールは読み取り専用です。3 つの start_*_scan ツールはアカウント内にスキャンレコードを作成します（既存データは編集しません）。5 つの Strategic Tickets 書き込みツールはプロジェクトのボードを変更するため、read_write キーが必要です。read キーでは使用できません。fetch_url ツールは API キーごとに 60 req/min にレート制限されています（ほかの無料ツールのデフォルトである 1000/min より厳しい制限です）。

料金

MCP の利用は、CompetLab のすべてのプランと 14 日間の無料トライアルに含まれています。

トラブルシューティング

問題	対処方法
接続拒否／タイムアウト	URL が末尾のスラッシュなしの https://mcp.competlab.com/mcp であることを確認してください
api_key_missing エラー	キーを CL-API-Key ヘッダー（リモート）または COMPETLAB_API_KEY 環境変数（stdio）で渡していることを確認してください
api_key_invalid エラー	キーは cl_live_ で始まり、ちょうど 40 文字である必要があります
トランスポートがサポートされていない	リモート HTTP サーバーを使用するか、ローカルの stdio サーバーに切り替えてください

リンク

• MCP サーバーのドキュメント
• REST API リファレンス
• TypeScript SDK（npm install @competlab/sdk）
• プライバシーポリシー
• 無料トライアルを開始

サポート

• バグ報告：GitHub Issues
• メール：[email protected]
• ドキュメント：competlab.com/developers

ライセンス

MIT（このリポジトリ内のドキュメントと設定を対象とします）— LICENSE を参照してください

CompetLab MCP サーバーとプラットフォームは商用ソフトウェアです。competlab.com/terms-and-conditions をご覧ください。

---

CompetLab チームが開発しました。AI 時代の競合インテリジェンスです。