suprsonic-mcp

suprsonic-mcp

เซิร์ฟเวอร์ MCP สำหรับ Suprsonic มอบความสามารถมากมายให้กับ AI agent ใดก็ได้ผ่านการเชื่อมต่อเพียงครั้งเดียว

เริ่มต้นอย่างรวดเร็ว

เชื่อมต่อกับเซิร์ฟเวอร์ที่โฮสต์ไว้ ไม่ต้องติดตั้งอะไร:

• URL: https://suprsonic.ai/v1/mcp (Streamable HTTP)
• Header: Authorization: Bearer omk_your_key (หรือ x-api-key: omk_your_key สำหรับไคลเอนต์หรือเกตเวย์ที่เก็บ Authorization ไว้สำหรับการลงชื่อเข้าใช้ของตัวเอง)

หรือรันเซิร์ฟเวอร์บนเครื่องของคุณเอง:

SUPRSONIC_API_KEY=omk_your_key npx -y suprsonic-mcp

รับ API key ของคุณได้ที่ 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 จะขอคีย์หนึ่งครั้งและเก็บไว้เป็น secret):

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

ส่ง beta header 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 เพิ่มลงใน toolbox ของ 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"
      }
    }
  }
}

รายการเดียวกันใช้ได้ใน mcp.json ของ Cursor

HTTP endpoint ของคุณเอง

หากต้องการให้บริการ HTTP transport จากเครื่องของคุณเองแทนการใช้เซิร์ฟเวอร์ที่โฮสต์ไว้:

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

จากนั้นเชื่อมต่อกับ http://localhost:3100/mcp

เครื่องมือที่มีให้ใช้

การเรียกจะใช้เครดิตก็ต่อเมื่อสำเร็จเท่านั้น ในกรณีที่แสดงช่วงราคา โหมดที่คุณเลือกจะเป็นตัวกำหนดราคา

เครื่องมือ	สิ่งที่ทำ	เครดิต
search	ค้นหาเว็บด้วย SERP, AI synthesis หรือทั้งสองอย่าง	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 ต้องให้ผู้รับยินยอม: พวกเขาต้องส่งข้อความถึงหมายเลข Business ของคุณภายใน 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, tech stack, ความปลอดภัยอีเมล, โฮสติ้ง	1-2
research	การวิจัยเชิงลึกหลายขั้นตอน: ค้นหา, scrape, เสริมข้อมูลเอนทิตี และสังเคราะห์เป็นรายงานพร้อมการอ้างอิง	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 และไม่มีการเรียกเก็บเครดิต การเรียกที่ถูกปฏิเสธ (คีย์ไม่ถูกต้อง เครดิตไม่พอ หรือติด rate limit) จะตอบกลับด้วย HTTP 401, 402 หรือ 429 พร้อมออบเจกต์ภายใต้ detail:

{
  "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 agent จะได้รับออบเจกต์ข้อผิดพลาดทั้งหมดในการตอบกลับของเครื่องมือ จึงสามารถตัดสินใจได้ว่าจะลองใหม่จาก is_retriable และ retry_after_seconds หรือไม่ และบอกคุณว่า alternative_action ระบุให้ทำอะไร

เอกสารอ้างอิง API ฉบับเต็มพร้อมพารามิเตอร์ทั้งหมดและตัวอย่างการตอบกลับ: suprsonic.ai/apis