mcp-ai-answer-visibility-tracker

AI Answer Visibility Tracker MCP サーバー

Apify 上の Mamba Labs AI Answer Visibility Tracker アクター用 MCP サーバーです。ブランドと、その購入者が尋ねる質問を入力します。各質問は Google AI Overviews で複数回尋ねられます。また、ご自身の API キーを使って、ChatGPT、Claude、Perplexity、Gemini でも尋ねられ、すべての回答でブランドの有無が確認されます。

内容

• できること
• クイックスタート
• 前提条件
• プロンプトの例
• ツール
• 入力
• 料金
• ご自身のキー
• アクターの詳細なドキュメント
• ライセンス

できること

• サンプル行：回答ごとに 1 行を返し、brand_named、brand_cited、first_mention_rank、competitors_named、competitors_cited、cited_domains、回答の抜粋が含まれます。
• 割合の行：質問とエンジンごとに question_summary 行を 1 つ返し、brand_named_rate、brand_cited_rate、ブランド名が挙がった割合の 95 パーセント範囲、引用されたドメインの上位一覧、各競合の割合が含まれます。すべての質問を対象とする、エンジンごとの無料の brand_summary 行も 1 つ返されます。
• キー不要の Google AI Overviews：shown、not_shown（ページに概要がない）、または deferred（Google が概要をその場で生成し、ページの後に読み込みます。無料で、割合の集計から除外されます）。

入力に問題がある場合は、error_reason が input_invalid: で始まる無料の行が 1 つ返されます。

処理はすべて Apify 上で実行されます。このパッケージは、アクターの実行を開始して完了を待ち、データセットの行を返す薄いクライアントです。

クイックスタート

Node.js 18 以降と、API トークンを持つ Apify アカウントが必要です。

Claude Desktop の設定（claude_desktop_config.json）、Cursor、または任意の MCP クライアントに、次の内容を追加します。

{
  "mcpServers": {
    "mamba-ai-answer-visibility-tracker": {
      "command": "npx",
      "args": [
        "-y",
        "@mambalabsdev/mcp-ai-answer-visibility-tracker"
      ],
      "env": {
        "APIFY_TOKEN": "your-apify-token"
      }
    }
  }
}

クライアントを再起動すると、track_ai_answer_visibility ツールが表示されます。

ChatGPT、Claude、Perplexity、Gemini にも質問するには、そのサービスのキーを同じ env ブロックに追加します：OPENAI_API_KEY、ANTHROPIC_API_KEY、PERPLEXITY_API_KEY、または GEMINI_API_KEY。

前提条件

• Node.js 18 以降。
• console.apify.com/account/integrations で取得した Apify API トークンを APIFY_TOKEN として設定します。サーバーはトークンがなくてもツールを一覧表示しますが、ツールの呼び出しにはトークンが必要です。
• 任意：各エンジンを利用するための、ご自身の OpenAI、Anthropic、Perplexity、または Google AI Studio のキー。

プロンプトの例

• 「Google の AI Overview は、small business に最適な CRM として HubSpot に言及していますか？ 3 回質問してください。」
• 「この 10 個の質問では、AI の回答が Attio を挙げるのは何回で、HubSpot と Pipedrive を挙げるのはそれぞれ何回ですか？」
• 「リモートチームに最適な wiki ツールについて、AI Overview が最も多く引用しているサイトはどれですか？」

ツール

track_ai_answer_visibility。ツールは 1 つです。引数の例：

{
  "brand_name": "HubSpot",
  "brand_domain": "hubspot.com",
  "questions": [
    "best crm for small business"
  ],
  "samples": "3",
  "competitors": [
    "Pipedrive|pipedrive.com",
    "zoho.com"
  ]
}

入力

アクターの購入者向け入力はすべて対象です。ただし、4 つのエンジンキーはサーバー環境から取得されるため、会話を介して渡されることはありません。省略された入力には、アクター独自のデフォルト値が使われます。数値とブール値は文字列として送信されます。

入力	型	説明
brand_name	string	必須。検索対象のブランド名です。ユーザーが表記する名前を指定します。大文字・小文字を区別せず、単語全体で照合します
questions	array	必須。購入者が尋ねる質問を 1～50 件指定します
brand_domain	string	ブランドのドメインです。例：hubspot.com。このドメインまたはサブドメイン上のページが引用された場合、引用ありとしてカウントされます
engines	array	google_ai_overview、openai、anthropic、perplexity、gemini のいずれかです。デフォルトは google_ai_overview です
samples	string	質問 1 件、エンジン 1 つあたりの質問回数です。1～10 回で指定します。デフォルトは 3 です
competitors	array	名前、ドメイン、または name|domain の形式で最大 20 件指定できます
brand_aliases	array	回答でブランドを表記する際の別名です
country、language	string	Google 用です。デフォルトは us、en です
include_answer_text	string	true（デフォルト）または false
openai_model、anthropic_model、perplexity_model、gemini_model	string	デフォルトは gpt-5-mini、claude-sonnet-5-5、sonar、gemini-2.5-flash です
max_charge_usd	string	任意。この金額を超える料金が発生する前に実行を停止します

料金

Apify ではイベントごとに課金され、料金は Apify アカウントに請求されます。価格は USD です。

イベント	Free プラン	Bronze	Silver	Gold
ai-overview-sample、1 件の質問について Google の検索結果ページを 1 回読み取る	$0.0316	$0.03002	$0.02844	$0.02686
answer-sample、ChatGPT、Claude、Perplexity、または Gemini からの回答 1 件（独自のキーを使用）	$0.009	$0.00855	$0.0081	$0.00765
question-summary、質問とエンジンごとのレート行 1 件	$0.003	$0.00285	$0.0027	$0.00255
apify-actor-start、実行開始 1 回あたり	$0.001082	$0.001082	$0.001082	$0.001082

保留された Google のサンプル、ブロックされたページ、エンジンエラー、ブランドのレート行、拒否された入力は無料です。

キー

Google AI Overviews にはキーは不要です。ChatGPT、Claude、Perplexity、Gemini は、独自の API キーを使って実行されます。キーはこのサーバーの環境から読み込まれ、実行入力のシークレットフィールドとして渡されます。アクターはキーを該当ベンダーの API にのみ送信し、記録、保存、返却することはありません。モデルの利用料金は該当ベンダーから請求されます。Mamba Labs が負担するのは、実行にかかる Apify プラットフォーム料金とプロキシ料金です。

アクターの詳細ドキュメント

apify.com/mambalabs/ai-answer-visibility-tracker

ライセンス

MIT。LICENSE をご覧ください。