suprsonic-mcp

suprsonic-mcp

Suprsonic 用の MCP サーバーです。1つの接続を通じて、あらゆる AI エージェントに数十の機能を提供します。

クイックスタート

ホスト型サーバーに接続するだけで、インストールは不要です:

• URL: https://suprsonic.ai/v1/mcp (Streamable HTTP)
• ヘッダー: Authorization: Bearer omk_your_key (または x-api-key: omk_your_key、クライアントやゲートウェイが Authorization を自身のサインイン用に保持している場合)

または、自分のマシンでサーバーを実行することもできます:

SUPRSONIC_API_KEY=omk_your_key npx -y suprsonic-mcp

API キーは suprsonic.ai/app/api で取得してください。どちらも同じツールを同じ価格で提供します。ツールの一覧表示にキーは不要です。有効なキーなしで呼び出すと、API 自身のエラーが返され、そこにキーの取得方法が示されます。

パッケージ名は suprsonic-mcp です。この README の以前の版では @suprsonic/mcp と記載されていましたが、その npm スコープは無関係な企業のものであるため、決してインストールしないでください。

ホスト型サーバー

Claude Code

claude mcp add --transport http suprsonic https://suprsonic.ai/v1/mcp --header "Authorization: Bearer omk_your_key"

Cursor

~/.cursor/mcp.json に追加してください (プロジェクト内では .cursor/mcp.json):

{
  "mcpServers": {
    "suprsonic": {
      "url": "https://suprsonic.ai/v1/mcp",
      "headers": {
        "Authorization": "Bearer omk_your_key"
      }
    }
  }
}

VS Code

.vscode/mcp.json に追加してください (VS Code はキーを一度だけ要求し、シークレットとして保存します):

{
  "inputs": [
    { "type": "promptString", "id": "suprsonic-key", "description": "Suprsonic API key (omk_...)", "password": true }
  ],
  "servers": {
    "suprsonic": {
      "type": "http",
      "url": "https://suprsonic.ai/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${input:suprsonic-key}"
      }
    }
  }
}

Claude API (MCP コネクター)

ベータヘッダー anthropic-beta: mcp-client-2025-11-20 を送信し、Messages リクエストに以下を追加してください:

{
  "mcp_servers": [
    { "type": "url", "url": "https://suprsonic.ai/v1/mcp", "name": "suprsonic", "authorization_token": "omk_your_key" }
  ],
  "tools": [
    { "type": "mcp_toolset", "mcp_server_name": "suprsonic" }
  ]
}

OpenAI Responses API

リクエストの tools に追加してください:

{
  "type": "mcp",
  "server_label": "suprsonic",
  "server_url": "https://suprsonic.ai/v1/mcp",
  "authorization": "omk_your_key",
  "require_approval": "never"
}

Smithery

Suprsonic は Smithery に suprsonic として掲載されています。Smithery のツールボックスに追加し、Smithery から求められたらキーを貼り付けてください。Smithery はそれを x-api-key としてホスト型サーバーに渡します。

ローカルサーバー (npx)

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json に追加してください:

{
  "mcpServers": {
    "suprsonic": {
      "command": "npx",
      "args": ["-y", "suprsonic-mcp"],
      "env": {
        "SUPRSONIC_API_KEY": "omk_your_key"
      }
    }
  }
}

同じエントリは Cursor の mcp.json でも動作します。

独自の HTTP エンドポイント

ホスト型サーバーを使う代わりに、自分のマシンから HTTP トランスポートを提供するには:

SUPRSONIC_API_KEY=omk_your_key npx -y suprsonic-mcp --http --port 3100

その後、http://localhost:3100/mcp に接続してください。

利用可能なツール

呼び出しは成功した場合にのみクレジットを消費します。範囲が示されている場合、選択したモードによって価格が決まります。

ツール	機能	クレジット
search	SERP、AI 合成、またはその両方でウェブを検索	1-3
scrape	任意の URL からコンテンツを Markdown または HTML として抽出	1-5
profiles	プロフェッショナルプロフィールの検索とエンリッチ	3
emails	プロフェッショナルなメールアドレスの検索	2
images	テキストプロンプトから画像を生成	3
tts	テキストを音声オーディオに変換	2
stt	タイムスタンプ付きでオーディオをテキストに文字起こし	2
sound-generate	テキストプロンプトから効果音や短い音楽トラックを生成 (音声ではない: 話し声には tts を使用)	4
sms	SMS または WhatsApp メッセージを送信。デフォルトのチャネルは SMS (確実な配信)。WhatsApp は受信者のオプトインが必要: 受信者が 24 時間以内にあなたのビジネス番号にメッセージを送っている必要があります。	1
documents	URL またはコンテンツから構造化データを抽出	3
companies	ドメインによる企業データのエンリッチ	3
email-verify	メールが配信可能か、catch-all か、使い捨てかを確認	1
transcribe	話者ダイアリゼーションとタイムスタンプ付きでオーディオを文字起こし	3
invoice-parse	請求書や領収書から構造化データを抽出	3
subtitle	オーディオまたはビデオから SRT/VTT 字幕を生成	2
file-convert	ドキュメント、ウェブページ、スプレッドシート、画像を形式間で変換	2
bg-remove	任意の画像から背景を削除。透明な PNG を返します。	2
screenshot	任意のウェブページのレンダリング済みスクリーンショットを取得	1
code-execute	事前設定済みの環境を備えた安全なサンドボックスでコードを実行	2
site-intel	包括的なドメインインテリジェンスを取得: WHOIS、DNS、SSL、技術スタック、メールセキュリティ、ホスティング	1-2
research	多段階のディープリサーチ: 検索、スクレイプ、エンティティのエンリッチ、引用付きレポートへの合成	10-35
video-info	任意の URL からビデオのメタデータ、利用可能な形式、サムネイルを抽出	1
video-download	任意の URL からビデオをダウンロードし、一時的なダウンロードリンクを返す	2-3
domains	ビジネスに適したドメイン名と拡張子を検索	1-5

レスポンス形式

すべてのツールは統一されたレスポンスオブジェクトを返します:

{
  "success": true,
  "data": {
    "results": [
      { "title": "OpenAI raises $6.6B", "url": "https://...", "snippet": "..." }
    ]
  },
  "error": null,
  "metadata": {
    "provider_used": "serperdev",
    "providers_tried": ["serperdev"],
    "response_time_ms": 1200,
    "request_id": "req_abc123"
  },
  "credits_used": 1
}

失敗時は、success が false となり、error に詳細が含まれます (以下を参照)。

エラー処理

すべてのエラーは同じオブジェクトです。失敗した機能は、上記のレスポンス内で error としてそれを返し、success が false に設定され、クレジットは消費されません。拒否された呼び出し (無効なキー、クレジット不足、レート制限) は、オブジェクトを detail の下に含めて HTTP 401、402、または 429 で応答します:

{
  "detail": {
    "type": "https://api.o-mega.ai/errors/insufficient-credits",
    "title": "Insufficient Suprsonic API credits",
    "status": 402,
    "detail": "This call needs 2 credits and your Suprsonic account has 0 left of its 200 free credits a month, which refill on November 12. This is your Suprsonic credit balance, not a provider's.",
    "is_retriable": false,
    "error_category": "billing",
    "alternative_action": "Pro gives 2,000 credits a month, 10 times the free plan: choose it at https://suprsonic.ai/app/subscription, or wait until November 12."
  }
}

エラーカテゴリ: transient (再試行しても安全)、permanent (不正なリクエスト)、authentication (無効なキー)、billing (クレジット切れ)、content_access (その URL は提供できません: ブロック済み、地域制限、またはプライベート)。

MCP を使用する場合、AI エージェントはツールレスポンスでエラーオブジェクト全体を受け取るため、is_retriable と retry_after_seconds から再試行すべきかを判断し、alternative_action が何をすべきかを伝えることができます。

すべてのパラメータとレスポンス例を含む完全な API リファレンス: suprsonic.ai/apis