Competiflow

Competiflow MCP サーバー

Competiflow 用の MCP（Model Context Protocol） サーバーです。Cursor、Claude Desktop、Windsurf、その他の MCP 互換クライアントで、競合他社のモニタリングをツールとして利用できます。

AI クライアントを離れることなく、競合他社の追跡、調査の実行、解釈済み変更フィードの確認、項目のトリアージ、ワークスペースダイジェストの取得ができます。

セットアップ

Competiflow ダッシュボードの API keys から API キーを作成し、クライアント設定にサーバーを追加します。必要な変数は COMPETIFLOW_API_KEY のみです。

Cursor

~/.cursor/mcp.json に追加します：

{
  "mcpServers": {
    "competiflow": {
      "command": "npx",
      "args": ["-y", "@competiflow/mcp-server"],
      "env": {
        "COMPETIFLOW_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）に追加します：

{
  "mcpServers": {
    "competiflow": {
      "command": "npx",
      "args": ["-y", "@competiflow/mcp-server"],
      "env": {
        "COMPETIFLOW_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

Windsurf

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

{
  "mcpServers": {
    "competiflow": {
      "command": "npx",
      "args": ["-y", "@competiflow/mcp-server"],
      "env": {
        "COMPETIFLOW_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

利用可能なツール

ツール	API	説明
list_workspaces	GET /v1/workspaces	レビュー件数とともにワークスペースを一覧表示します
create_workspace	POST /v1/workspaces	ワークスペースを作成します（product_url は任意）
add_competitor	POST /v1/workspaces/:id/competitors	ホームページ URL を指定して競合他社を追加します。非同期で調査し、重複 URL の場合は冪等です
list_competitors	GET /v1/workspaces/:id/competitors	モニターと last_run を含めて競合他社を一覧表示します
get_competitor	GET /v1/competitors/:id	競合他社の情報を取得します
update_competitor	PATCH /v1/competitors/:id	すべてのモニターの実行頻度またはステータスを設定します
delete_competitor	DELETE /v1/competitors/:id	競合他社とその履歴をすべて削除します
list_monitors	GET /v1/monitors	ステータス、実行頻度、last_run を含めてモニターを一覧表示します
get_monitor	GET /v1/monitors/:id	モニターの情報を取得します。キャプチャの証拠を含めるには include を指定します
create_monitor	POST /v1/monitors	特定の URL に手動でモニターを追加します
update_monitor	PATCH /v1/monitors/:id	URL、実行頻度、ステータス、または min_severity を更新します
delete_monitor	DELETE /v1/monitors/:id	モニターとその履歴をすべて削除します
check_monitor	POST /v1/monitors/:id/check	オンデマンドチェックをキューに追加します
refresh_workspace	POST /v1/workspaces/:id/refresh	アクティブなモニターのチェックをキューに追加します
list_changes	GET /v1/changes	since、フィルター、meta 件数を指定できる変更フィードです
get_change	GET /v1/changes/:id	変更の全情報を取得します。キャプチャまたは未加工の差分を含めるには include を指定します
update_change	PATCH /v1/changes/:id	review_status を設定します
get_digest	GET /v1/workspaces/:id/digest	ワークスペースの週次サマリーを取得します

一般的な流れ

1. list_workspaces または create_workspace を実行します（product_url を指定すると、変更に関する競合状況の把握に役立ちます）。
2. ホームページ URL を指定して add_competitor を実行します。
3. discovery_status が completed になるまで get_competitor を実行します。
4. refresh_workspace または check_monitor を実行して最新データを取得します。
5. since=7d と min_severity を指定して list_changes を実行するか、サマリーを取得するには get_digest を実行します。
6. 証拠が必要な場合は、include を指定して get_change を実行します。
7. 項目を確認済みまたは却下済みにするには update_change を実行します。

調査と冪等性

add_competitor はバックグラウンドで調査を開始し、完了結果ではなく受付確認を返します。discovery_status が completed になるまで get_competitor をポーリングしてください。

1 つのワークスペースで同時に実行できる調査は 1 件です。同じホームページ URL を再度送信すると、2 回目の実行は開始されず、既存の競合他社が返されます。別の競合他社がまだ調査中の場合、呼び出しは 409 discovery_in_progress と active_competitor_id を返すため、ポーリング対象を確認できます。

include を使ったエビデンス

get_change と get_monitor は、1 回の呼び出しで元のキャプチャを添付するための include 配列を受け取ります。

トークン	使用可能な対象	返される内容
capture	get_change、get_monitor	スナップショットから抽出されたフィールド
capture_markdown	get_change、get_monitor	スナップショットのページの Markdown
raw_diff	get_change	変更前後の差分

変更の場合、キャプチャは変更後のページです。モニターの場合、直近の成功したチェックがキャプチャされ、現在のベースラインとなります。

削除と一時停止の違い

delete_monitor と delete_competitor は完全に削除します。モニターまたは競合他社とともに、そのチェック実行、スナップショット、変更も削除されます。インテリジェンスの履歴を保持したままチェックを停止するには、代わりに update_monitor または update_competitor を status: paused にして呼び出してください。

エージェント向けガイドライン（AI クライアント向け）

• 検出状況をポーリングし、推測しないでください： add_competitor の後、変更を読み取る前に、discovery_status が completed になるまで get_competitor をポーリングしてください。409 が返された場合は、エラーの active_competitor_id をポーリングしてください。
• フィードを絞り込んでください： すべてを取得するのではなく、list_changes に since（1d、7d、30d、または ISO8601）、min_severity、monitor_type（homepage、blog、docs、changelog、pricing）、review_status を渡してください。受信トレイの件数には meta.counts を、ページ切り替えには next_cursor を使用してください。
• 解釈用フィールド： 変更とダイジェスト項目には、競争環境に関する情報を示す why_it_matters が含まれています。recommended_action は API から削除されました。
• 必要に応じてエビデンスを取得してください： 元のキャプチャが必要な場合に限り、get_change または get_monitor に include を追加してください。ペイロードが増加します。
• 削除より一時停止を優先してください： ユーザーがモニターの停止を希望する場合は、デフォルトで status: paused にしてください。履歴も削除されるため、delete_* は完全な削除が必要な場合に限って使用してください。

仕組み

サーバーは各ツール呼び出しを Competiflow v1 API リクエストに変換し、構造化された JSON を返します。エージェントには生のページスクレイピング結果ではなく、解釈された変更、重大度、重要な理由が表示されます。

AI Agent → MCP Tool Call → Competiflow API → Interpreted Change Feed → Structured Response → AI Agent

環境変数

変数	必須	説明
COMPETIFLOW_API_KEY	はい	Competiflow API キー（sk_live_...）

API キーの取得

competiflow.com で登録し、API keys からキーを作成してください。

開発

npm install
npm run build
COMPETIFLOW_API_KEY=sk_live_... node dist/index.js

ライセンス

MIT