suprsonic-mcp Server

公式

1つのAPIキーで、AIエージェントに数十の機能を提供。プロバイダー認証は不要。

GitHub

ドキュメント

@suprsonic/mcp

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

クイックスタート

SUPRSONIC_API_KEY=omk_your_key npx -y @suprsonic/mcp

API キーは suprsonic.ai/app/apis で取得してください。

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 / VS Code

.cursor/mcp.json または VS Code の MCP 設定に以下を追加します:

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

リモート HTTP (Claude API、ChatGPT、プログラムによるエージェント向け)

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

その後、http://localhost:3100/mcp に接続します。

利用可能なツール

ツール機能
searchWeb 検索 (AI 合成、SERP、またはその両方)
scrape任意の URL から Markdown としてコンテンツを抽出
profiles名前または LinkedIn URL でプロフェッショナルプロフィールを検索
emailsプロフェッショナルなメールアドレスを検索
imagesテキストプロンプトから画像を生成
ttsテキストを音声に変換
stt音声をテキストに文字起こし
smsSMS または WhatsApp メッセージを送信
documentsURL から構造化データを抽出
companiesドメインで企業データを検索
email-verifyメールが配信可能かどうかを確認
transcribe話者ラベル付きで音声を文字起こし
invoice-parse請求書からデータを抽出
subtitleSRT/VTT 字幕を生成
file-convert200 以上の形式間でファイルを変換
bg-remove画像の背景を削除
screenshotWeb ページのスクリーンショットをキャプチャ

レスポンス形式

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

{
  "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 に詳細が含まれます (下記参照)。

エラーハンドリング

エラーオブジェクトの構造 (success が false の場合に返されます):

{
  "type": "billing_error",
  "title": "Insufficient credits",
  "status": 402,
  "detail": "Your account has 0 credits remaining. Add credits at suprsonic.ai/app/billing.",
  "is_retriable": false,
  "retry_after_seconds": null,
  "error_category": "billing"
}

エラーカテゴリ: transient (再試行安全)、permanent (不正なリクエスト)、authentication (無効なキー)、billing (クレジット不足)。

MCP 使用時、AI エージェントはツールレスポンスでエラーを受け取り、is_retriable と retry_after_seconds に基づいて再試行するかどうかを判断できます。

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