brandcheck

brandcheck

購入者が AI アシスタントにおすすめを尋ねたとき、あなたのブランドは実際に表示されますか？ brandcheck は、ホスト型の AskedThrice 測定サービスへの小規模なキー不要のブリッジです。OpenAI、Anthropic、Gemini に実際の購入者の質問を投げかけ、回答すると考えている内容ではなく、実際の回答を報告します。

0 から 100 までのスコアはありません。測定が完了すると、3 段階の判定、ブランドが勝った購入者の質問の数、代わりに挙げられた競合他社、実際に回答したプロバイダーが報告されます。このサービスは無料で、サインアップも API キーも不要です。また、ドメインごとに 30 日間で 1 回の測定が可能です。このクォータは上流にあり、quota_reached の応答はこのクライアントで変更されずにそのまま渡されます。

ツール

• start_visibility_check — ブランドの測定を開始します。必須項目：brand（顧客が記載するブランド名）、website（yourbrand.com のようなドメイン）、category（事業内容を簡潔に表したもの）。任意項目：competitors（実在する競合他社を最大 5 社、カンマ区切りで指定）、location（事業を展開する地域）、language（購入者への質問に使用する言語。en または es）。runId を返します。
• get_visibility_check — runId を使って測定結果を取得します。プロバイダーがまだ回答中の場合はステータス running を返すため、20～30 秒ごとにポーリングしてください（測定には約 1 分かかります）。完了すると、判定と件数が報告されます。

ローカルでは検証も集計も行いません。引数は指定されたとおりに転送され、上流の結果コンテンツは isError フラグを含め、そのまま返されます。

設定

• ASKEDTHRICE_MCP_URL（任意）— ホスト型エンドポイントを上書きします。デフォルトは https://mcp.askedthrice.com/mcp です。
• ASKEDTHRICE_TIMEOUT_MS（任意）— リクエストごとのタイムアウトをミリ秒で指定します。デフォルトは 60000 です。

失敗は 3 種類の形式（この再構築で独自に定義したもの）で返されます。上流からの JSON-RPC エラーは askedthrice error: <message> になります。上流の応答を解析できない場合は askedthrice error: malformed response になります。タイムアウトを含め、リクエストを完了できない場合は askedthrice unreachable になります。

転送の仕組み

ブリッジの内部処理は、ラベル付きの再構築（Streamable HTTP セッションパターン）です。最初の呼び出し時に、クライアントは initialize リクエスト（protocolVersion 2025-03-26、空の capabilities、clientInfo name brandcheck）を POST し、返された場合は mcp-session-id レスポンスヘッダーを取得します。次に notifications/initialized を POST し、その後、取得した場合はセッションヘッダーを付けて tools/call リクエストを POST します。セッションはプロセスの存続期間中、再利用されます。 すべての POST には Content-Type: application/json と Accept: application/json, text/event-stream が含まれ、応答は通常の JSON または SSE の場合があります。

CLI

各ツールは、1 つの JSON 引数文字列を受け取るサブコマンドです。

npx @reneturcios/brandcheck start_visibility_check '{"brand":"Acme","website":"acme.com","category":"project management tool","competitors":"Asana, Monday"}'
npx @reneturcios/brandcheck get_visibility_check '{"runId":"run-123"}'
npx @reneturcios/brandcheck --version

出力は、転送された結果コンテンツを JSON 形式で表したものです。終了コード：成功時は 0、isError 結果の場合は 1、使用方法に誤りがある場合は 2 です。

MCP サーバー

npx -y @reneturcios/brandcheck mcp

MCP クライアントの設定：

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

Docker

docker run -i ghcr.io/cloudcorprecords/brandcheck
docker run --rm ghcr.io/cloudcorprecords/brandcheck get_visibility_check '{"runId":"run-123"}'

開発

npm install
npm run build   # tsc -> dist/
npm test        # tsx --test test/*.test.ts (fake fetch only, no network)
npm run dev     # run the CLI from source

ライセンス

MIT — Copyright (c) 2026 Rene Turcios