@suprsonic/mcp

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

クイックスタート

SUPRSONIC_API_KEY=omk_your_key npx -y @suprsonic/mcp

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

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 に接続します。

利用可能なツール

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

レスポンス形式

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

{
  "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

This server cannot be installed

A

license - permissive license

-

quality - not tested

C

maintenance

How are these scores calculated?

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

suprsonic-mcp