stackscan

StackScan MCP サーバー

ウェブサイトが何で構築されているのか、運営元はどこなのかをアシスタントに尋ねましょう。

StackScan Tech Lookup API 用の Model Context Protocol サーバーです。Claude、Cursor、その他の MCP クライアントを接続すれば、次のような質問ができます。

example.com は何で構築されていますか？

vercel.com の運営元はどこですか？所在地や業界、LinkedIn は？

Klaviyo を利用しているサイトはいくつあり、どの国にありますか？

設計上、読み取り専用です。お使いのシステムに書き込みは一切行いません。

---

インストール

StackScan アカウントが必要です。サインインし、ダッシュボードの API Tokens を開いてトークンを作成し、同じページからワークスペース UUID をコピーしてください。

Claude Desktop（拡張機能）

リリースページから stackscan.mcpb をダウンロードし、Settings > Extensions にドラッグします。API トークンとワークスペース ID を求められ、残りは自動でインストールされます。

Claude Desktop（手動設定）

Settings → Developer → Edit Config を開き、次を追加します。

{
  "mcpServers": {
    "stackscan": {
      "command": "npx",
      "args": ["-y", "@stackscan/mcp-server"],
      "env": {
        "STACKSCAN_API_TOKEN": "your-token",
        "STACKSCAN_TENANT_ID": "your-workspace-uuid"
      }
    }
  }
}

Claude Desktop を再起動します。ツールはコネクタアイコンの下に表示されます。

Claude Code

claude mcp add stackscan \
  --env STACKSCAN_API_TOKEN=your-token \
  --env STACKSCAN_TENANT_ID=your-workspace-uuid \
  -- npx -y @stackscan/mcp-server

Cursor、Windsurf、その他

同じ形式です。command: npx、args: ["-y", "@stackscan/mcp-server"] と、2 つの環境変数を設定します。設定ファイルの場所については、お使いのクライアントの MCP ドキュメントを確認してください。

---

ツール

ツール	内容	コスト
check_credits	残高と今月の割り当て	無料
lookup_company	ドメインの運営企業：名前、業界、市、国、LinkedIn、推定売上高の範囲	1 クレジット
lookup_domain_technologies	1 つのドメインで使われているテクノロジーの詳細：各テクノロジーのカテゴリと世界全体での利用状況（limit、デフォルトは 50、最大 100）、有料（プレミアム）製品の数、推定月間テクノロジー支出	1 クレジット
lookup_technology	そのテクノロジーを利用しているサイトの数と所在地	1 クレジット
lookup_companies	最大 20 ドメインの運営企業をコンパクトな表で表示	データがあるドメインごとに 1 クレジット
lookup_domains_technologies	最大 20 ドメインで使われているテクノロジーをコンパクトな表で表示。category フィルターは任意	データがあるドメインごとに 1 クレジット

該当する情報が見つからなかった検索には課金されません。check_credits も同様です。

幅と深さ

テクノロジー検索ツールは 2 種類あり、それぞれ異なる質問に答えます。 lookup_domains_technologies は幅を調べる機能です。複数のドメインを対象にテクノロジー名だけを返すため、「この中で Shopify を使っているのはどれ？」といった質問に最適です。lookup_domain_technologies は深さを調べる機能です。1 つのドメインを対象に、すべてのテクノロジーとそのカテゴリ、世界全体でそれぞれを利用しているサイト数を返します。一括検索ツールは、ドメインごとに省略したテクノロジーの数を報告するため、モデルはさらに詳しく調べることを提案できます。

一括検索ツールが 20 件までなのはなぜですか？

これらのツールが利用する REST エンドポイントは 1 リクエストで 100 ドメインを受け付けますが、ツール側では意図的に制限しています。ツールの結果はそのままモデルのコンテキストに入り、企業情報の全データが 100 件あると数万トークンになって、実際に進めている会話を圧迫します。そのうえ、モデルは回答するために情報をすべて読み直さなければなりません。コンパクトな 20 行の表なら、モデルが内容を推論できます。

また、件数を切り詰めるのではなく、リクエストを拒否します。一括検索の料金がセッション上限を超える場合、課金せずに、利用可能な件数をお知らせします。ドメインを何も言わずに除外すると、完全に見えて実際には不完全な回答になってしまうためです。

本当に数百件のドメインが必要な場合は、REST エンドポイントをご利用ください。

---

設定

変数	必須	デフォルト	備考
STACKSCAN_API_TOKEN	はい	なし	ダッシュボード → API Tokens
STACKSCAN_TENANT_ID	はい	なし	ワークスペース UUID。同じページにあります
STACKSCAN_API_BASE	いいえ	https://api.stackscan.com	通常は不要です
STACKSCAN_SESSION_LOOKUP_CAP	いいえ	25	下記を参照

セッションの上限は支出の上限です。意図的に設けられています

StackScan 独自の上限はレート制限、つまり分あたりのリクエスト数です。これは短時間の集中したアクセスを防ぎます。しかし、慎重なエージェントが午後いっぱいかけてクレジット残高を使い切るのを防ぐことはできません。ボタンをクリックする人間には起こらないタイプの問題です。

そのため、このサーバーでは独自にカウンターを保持しています。デフォルトでは、セッションあたりのクレジットを消費する検索は25 回までで、それを超えると理由を示して拒否します。検索結果が見つからなかった場合や check_credits は、いずれも課金されないためカウントされません。成功した検索結果には毎回、残りの検索回数と最後に確認した残高を示すフッターが付きます。これにより、モデルは上限に達して初めて気づくのではなく、自分でペースを調整できます。

上限を増やす場合は、あとから気づくのではなく、意図的に引き上げてください（"STACKSCAN_SESSION_LOOKUP_CAP": "200"）。

---

開発

npm install
npm run build

test-stdio.mjs は、実際の標準入出力パイプ経由でサーバーを動かす最小限の JSON-RPC クライアントです。MCP ホストなしで動作を試せます。

export STACKSCAN_API_TOKEN=...
export STACKSCAN_TENANT_ID=...
node test-stdio.mjs check_credits lookup_company:stripe.com

このサーバーでは、標準出力に絶対に書き込まないでください。 標準出力は JSON-RPC の通信チャネルです。それ以外のものを書き込むと、プロトコルが壊れます。診断情報は標準エラー出力に送ってください。

---

ソースコードを読む方向けの注意事項

上流 API の次の 3 点がこのコードの設計に影響しており、誤解しやすい点でもあります。

検索結果が見つからない場合でも HTTP 200 が返り、404 にはなりません。 API は「そのドメインのデータがありません」という場合に、200 {"success": false, "error": "No data available"} を返します。ステータスコードをそのまま信頼するクライアントは、存在しないペイロードを読み込んでクラッシュします。すべてのレスポンスは、結果が見つからなかった場合と失敗を区別する一か所の処理を通るため、実際の失敗だけがエラーとして報告されます。

キャッシュされたレスポンスも課金対象です。 API のレスポンスキャッシュが保護するのはデータベースであり、利用者の残高ではありません。キャッシュ期間内に同じ検索を繰り返しても、同じクレジットがかかります。そのため、どの呼び出しが無料だったか推測しようとせず、検索がヒットするたびにローカル残高を減らします。

有効なベース URL は 2 つあります。 API の標準 URL は api.stackscan.com/v1/... です。古い app.stackscan.com/api/v1/... のパスも引き続き提供されており、POST のリダイレクトで本文が失われるため、意図的にリダイレクトされません。設定に古いホストが指定されている場合、このサーバーはそれを検出し、古いパス形式を使い続けるため、アップグレードしても動作が壊れることはありません。

プライバシーポリシー

StackScan のプライバシーポリシーは www.stackscan.com/privacy にあります。このサーバーに関する内容は次のとおりです。

収集される情報。 検索したドメインとテクノロジー名が、API トークンとワークスペース ID とともに HTTPS 経由で api.stackscan.com に送信されます。それ以外の情報がマシンから送信されることはありません。このサーバーはファイルを読み込まず、ポートを開かず、ローカルストアも保持しません。保持する状態は検索回数のカウンターとクレジット残高だけで、どちらもメモリー上にあり、プロセス終了時に消去されます。

情報の使用と保存方法。 クレジットの計測とアカウントのサポートのため、検索内容はワークスペースに関連付けて記録されます。検索結果は StackScan 独自のクロールデータから取得され、利用者が送信した情報に基づくものではありません。

第三者。 検索語が販売されたり、広告目的で共有されたりすることはありません。ポリシーの「サービスプロバイダーとの共有」に記載されているとおり、検索語は StackScan が利用するインフラストラクチャプロバイダーにのみ送信され、それ以外に送信されることはありません。

保持期間。 ポリシーの「データ保持」に記載されています。アカウントを削除すると、関連する検索履歴も削除されます。

お問い合わせ。 [email protected]、または www.stackscan.com/contact。

リンク

• API リファレンス
• 平易な説明での概要
• StackScan

ライセンス

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

このライセンスの対象はこのクライアントのみで、およそ 500 行の HTTP リクエストを行うコードです。このクライアントがアクセスする StackScan のデータは有料サービスであり、このライセンスの対象ではありません。