vischeck

vischeck

vischeck は、スタートアップの製品を AI 検索エンジンが推奨しているかを追跡する、FrontStat のホスト型 MCP サーバーへの小規模なローカルブリッジです。ローンチについて尋ねると、可視性スコアと、ChatGPT、 Claude、Gemini が購入者の質問に対してその製品を挙げるかどうかが回答に表示されます。挙げない場合は、 代わりにどの競合製品を挙げるかが表示されます。

このブリッジは、可視性データを独自に保持しません。ライブエンドポイントから取得したとおりの上流サーバーの ツール一覧をローカルで提供し、各ツール呼び出しを上流に転送して、結果を変更せずに返します。 取得した機能は、トークン不要の公開ローンチ検索と、FrontStat Pro のダッシュボードトークンが必要な 5 つの Pro レポートビューのみです。

ツール

• check_public_launch — FrontStat がすでに追跡している製品ローンチを検索します。製品名、今週または 今月のローンチボードでの順位、可視性スコア（0〜100）、ChatGPT、Claude、Gemini が購入者の質問に対して その製品を推奨するかどうか、代わりに挙げる製品、FrontStat の公開ページへのリンクを返します。 ドメインがまだ追跡されていない場合は、その旨を伝え、無料レポートへのリンクを表示します。必須： domain（製品のドメインまたは URL。例： example.com）。トークンは不要です。
• get_visibility — 最新の FrontStat Pro レポートを返します。日付、可視性スコア、各 AI 検索エンジンが 主な購入者の質問に対して製品を推奨するかどうかと、代わりに挙げる製品、購入者の質問ごとに各 アシスタントの回答で製品が推奨される件数（X/Y）が含まれます。Pro トークンが必要です。引数は不要です。
• list_buyer_questions — FrontStat が市場について AI 検索エンジンに尋ねる各購入者の質問と、回答で 製品が推奨されているかどうかをエンジンごとに「はい」または「いいえ」で返します。Pro トークンが必要です。 引数は不要です。
• who_wins_instead — 最新の Pro レポートから、AI 検索エンジンが自社製品の代わりに挙げる製品と、 引用するサイトを返します。それぞれが何件の回答に登場するかも含まれます。Pro トークンが必要です。 引数は不要です。
• cited_sites — AI 検索エンジンが購入者の質問に回答する際に最もよく引用するサイトを、自社ドメインを 除外して、各サイトが引用される回答数とともに返します。掲載を狙うべきページがわかります。 Pro トークンが必要です。引数は不要です。
• visibility_history — 過去 30 日間の各日のデータを返します。可視性スコアと製品が推奨される回答数が 含まれるため、変更によって AI 検索エンジンの結果が変わったかどうかを確認できます。Pro トークンが必要です。引数は不要です。

設定

• FRONTSTAT_MCP_URL（任意）— 上流エンドポイントを上書きします。デフォルトは https://frontstat.com/api/mcp です。 （上書き用の仕組みは、この再構築で独自に付与したラベル付きの再現機能です。）
• FRONTSTAT_API_KEY（任意）— 設定すると、すべての上流リクエストに Authorization: Bearer <value> ヘッダーが付加されます。これにより、5 つの Pro ツールに ダッシュボードトークンが渡されます。未設定の場合は Authorization ヘッダーが送信されず、 公開ローンチ検索のみ利用できます。（この転送機能も、この再構築で独自に付与したラベル付きの再現機能です。 元の機能はキーなしで取得されました。）

転送の仕組み

最初のツール呼び出し時に、クライアントは上流とのストリーミング可能な HTTP セッションを開きます。 JSON-RPC の initialize リクエスト（protocolVersion 2025-03-26、clientInfo の name は vischeck）を送り、続いて notifications/initialized 通知を送り、その後、呼び出し元の引数を変更せずに 含めた tools/call リクエストを送ります。上流からの initialize への応答に Mcp-Session-Id ヘッダーが 含まれる場合、その値はセッション中の以降のすべてのリクエストに付加され、プロセスの実行中は同じ セッションが再利用されます。応答は通常の JSON またはサーバー送信イベントとして届く場合があり、 どちらも読み取られます。

上流からの成功結果は、上流が設定した isError フラグも含め、変更せずにそのまま返されます。 JSON-RPC エラー、2xx 以外のステータス、読み取り不能な応答、完了できないリクエストなどの失敗は、 テキストが vischeck error: で始まる isError 結果として返されます（このエラー表示は、 この再構築で独自に付与したラベル付きの再現機能です）。

CLI

各ツールは、JSON 引数を 1 つ取るサブコマンドでもあります （引数を必要としないツールでは省略します）。

npx @reneturcios/vischeck check_public_launch '{"domain":"example.com"}'
npx @reneturcios/vischeck get_visibility
npx @reneturcios/vischeck who_wins_instead '{}'
npx @reneturcios/vischeck visibility_history
npx @reneturcios/vischeck --version

終了コード：成功時は 0、isError の結果時は 1、使用方法の誤り時は 2 です。

MCP サーバー

npx -y @reneturcios/vischeck mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "vischeck": {
      "command": "npx",
      "args": ["-y", "@reneturcios/vischeck", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/vischeck
docker run --rm ghcr.io/cloudcorprecords/vischeck --version

コンテナのデフォルトコマンドは mcp なので、最初の形式は stdio MCP サーバーとして動作します。それ以外の引数は通常どおり CLI に渡されます。

開発

npm install
npm run build
npm test
npm run dev

テストスイートはすべて、スタブ化された JSON-RPC アップストリームに対して実行されます。実際のネットワーク呼び出しはありません。

ライセンス

MIT — LICENSE を参照してください。