Suprsonic

io.github.O-mega-Enterprise由 GitHub 帳號 O-mega-Enterprise 發布v0.3.4更新於 Oct 28, 2026

One API key, dozens of capabilities for your AI agent. Zero provider auth.

已驗證Streamable HTTP可網頁執行網頁搜尋與抓取資料與分析媒體與設計

概覽

AI 產生的概覽

Suprsonic 用一組 API 金鑰把網頁搜尋、擷取、資料擴充、媒體生成、轉錄與沙箱程式執行打包成託管或本機執行的 MCP 伺服器。

可以做什麼
  • 網頁搜尋(SERP、AI 綜合或兩者)、將頁面擷取為 Markdown 或 HTML、網頁截圖,以及多步驟附引用的深度研究
  • 人物、公司與網域資料擴充:專業檔案、工作信箱、信箱驗證、公司資料、WHOIS/DNS/SSL/技術棧、網域命名建議
  • 從網頁、發票與收據擷取結構化資料;在多种格式之間轉換檔案
  • 生成圖片、語音、音效與音樂;附時間戳或講者分離的音訊轉錄;產生 SRT/VTT 字幕
  • 檢視並下載影片、去除圖片背景、傳送簡訊或 WhatsApp 訊息,以及在全新沙箱中執行程式碼
適用情境
適合需要多種彼此無關能力(研究、擷取、資料擴充、媒體生成、轉錄)卻不想分別串接多個服務商與金鑰的助理。適用於調研與潛在客戶資料擴充、內容與媒體製作、文件與發票處理等情境。
執行需求
需要 Suprsonic API 金鑰:本機 npx 套件透過 SUPRSONIC_API_KEY 環境變數傳入,託管端點透過 Authorization bearer 標頭(或 x-api-key)傳入。本機套件需要 Node.js,託管伺服器只需網路存取。呼叫會消耗帳戶額度。
安裝前請注意
每次成功呼叫都會消耗 Suprsonic 帳戶額度,其中深度研究最貴;失敗的呼叫不收費。sms 工具會向手機號碼傳送真實訊息,video-download 回傳的連結一小時後失效。此金鑰可存取全部工具,應以機密方式保存。README 提醒早期套件名稱屬於無關公司,不應安裝。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Suprsonic,將其新增到工作區。
  2. 連接 Authorization token 憑證。它們會被私密儲存,絕不會在公開頁面上展示。
  3. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.O-mega-Enterprise%2Fsuprsonic-mcp/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "suprsonic": {
      "type": "http",
      "url": "https://suprsonic.ai/v1/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

README

suprsonic-mcp

MCP server for Suprsonic. Gives any AI agent dozens of capabilities through one connection.

Quick Start

Connect to the hosted server, nothing to install:

  • URL: https://suprsonic.ai/v1/mcp (Streamable HTTP)
  • Header: Authorization: Bearer omk_your_key (or x-api-key: omk_your_key, for a client or gateway that keeps Authorization for its own sign-in)

Or run the server on your own machine:

bash
SUPRSONIC_API_KEY=omk_your_key npx -y suprsonic-mcp

Get your API key at suprsonic.ai/app/api. Both offer the same tools at the same prices. Listing the tools needs no key; a call without a valid key answers with the API's own error, which says where to get one.

The package is suprsonic-mcp. Earlier copies of this README named @suprsonic/mcp: that npm scope belongs to an unrelated company, so never install it.

Hosted server

Claude Code

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

Cursor

Add to ~/.cursor/mcp.json (or .cursor/mcp.json in a project):

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

VS Code

Add to .vscode/mcp.json (VS Code asks for the key once and stores it as a secret):

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

Send the beta header anthropic-beta: mcp-client-2025-11-20 and add to your Messages request:

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

Add to the request's tools:

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

Smithery

Suprsonic is listed on Smithery as suprsonic. Add it to your Smithery toolbox and paste your key when Smithery asks for it; Smithery passes it to the hosted server as x-api-key.

Local server (npx)

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

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

The same entry works in Cursor's mcp.json.

Your own HTTP endpoint

To serve the HTTP transport from your own machine instead of using the hosted server:

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

Then connect to http://localhost:3100/mcp.

Available Tools

A call costs credits only when it succeeds. Where a range is shown, the mode you pick sets the price.

ToolWhat it doesCredits
searchSearch the web with SERP, AI synthesis, or both1-3
scrapeExtract content from any URL as Markdown or HTML1-5
profilesFind and enrich professional profiles3
emailsFind professional email addresses2
imagesGenerate images from text prompts3
ttsConvert text to speech audio2
sttTranscribe audio to text with timestamps2
sound-generateGenerate sound effects and short music tracks from text prompts (NOT speech: use tts for spoken voice)4
smsSend SMS or WhatsApp messages. Default channel is SMS (reliable delivery). WhatsApp requires recipient opt-in: they must have messaged your Business number within 24 hours.1
documentsExtract structured data from URLs or content3
companiesEnrich company data by domain3
email-verifyCheck if an email is deliverable, catch-all, or disposable1
transcribeTranscribe audio with speaker diarization and timestamps3
invoice-parseExtract structured data from invoices and receipts3
subtitleGenerate SRT/VTT subtitles from audio or video2
file-convertConvert documents, web pages, spreadsheets and images between formats2
bg-removeRemove background from any image. Returns transparent PNG.2
screenshotCapture a rendered screenshot of any webpage1
code-executeExecute code in a secure sandbox with pre-configured environments2
site-intelGet comprehensive domain intelligence: WHOIS, DNS, SSL, tech stack, email security, hosting1-2
researchMulti-step deep research: search, scrape, enrich entities, and synthesize into a cited report10-35
video-infoExtract video metadata, available formats, and thumbnail from any URL1
video-downloadDownload video from any URL and return a temporary download link2-3
domainsFind domain names and the extensions that fit a business1-5

Response Format

Every tool returns a unified response object:

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

On failure, success is false and error contains the details (see below).

Error Handling

Every error is the same object. A capability that fails returns it as error in the response above, with success set to false and no credits charged. A refused call (an invalid key, too few credits, a rate limit) answers HTTP 401, 402 or 429 with the object under detail:

json
{  "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."  }}

Error categories: transient (retry safe), permanent (bad request), authentication (invalid key), billing (out of credits), content_access (that URL cannot be served: blocked, region-locked or private).

When using MCP, the AI agent receives the whole error object in the tool response, so it can decide whether to retry from is_retriable and retry_after_seconds, and tell you what alternative_action says to do.

Full API reference with all parameters and example responses: suprsonic.ai/apis

來源:README.md,提交 a83a07d

工具

24

scrape

Scrape

Extract content from any URL as Markdown or HTML. Returns the page's content in the chosen format (Markdown by default) with its title, description and links. Use when you have a URL and need what the page says. Start with fast; use standard for pages that need JavaScript and thorough only for sites that block scrapers. To pull specific fields into JSON use documents; to see the page as an image use screenshot. Cost: fast 1 credit, standard 2 credits, thorough 5 credits, charged only when a call succeeds.

輸入參數url必填modeoutputtimeoutwait_for

profiles

Profile Finder

Find and enrich professional profiles. Returns the person's name, headline, current company and title, location, summary, experience, education, skills, photo URL and LinkedIn URL. Use to learn who a professional is and what they have done. For their work email use emails; for a company rather than a person use companies. Pass linkedin_url, or first_name and last_name; company helps find the right person. Cost: 3 credits, charged only when a call succeeds.

輸入參數companylast_namefirst_namelinkedin_urlinclude_image

emails

Email Finder

Find professional email addresses. Returns the address with its confidence (0 to 1) and verification status. Use to find a named person's work email at a company. To check an address you already have use email-verify; for the person's background use profiles. Cost: 2 credits, charged only when a call succeeds.

輸入參數domain必填companylast_name必填first_name必填

images

Image Generation

Generate images from text prompts. Returns a hosted URL of the PNG and the same image as base64 (b64_json), with the aspect ratio and size used. Use to create a new picture from a description. To cut the background out of an existing image use bg-remove; to capture a web page use screenshot. Cost: 3 credits, charged only when a call succeeds.

輸入參數prompt必填aspect_ratio

tts

Text-to-Speech

Convert text to speech audio. Returns the speech as base64 MP3 audio with its sample rate and the voice used. Use for spoken voice or narration, up to 2,000 characters a call. For sound effects or music use sound-generate. Cost: 2 credits, charged only when a call succeeds.

輸入參數text必填providervoice_model

stt

Speech-to-Text

Transcribe audio to text with timestamps. Returns the transcript, its confidence, language and duration, and every word with its start and end time. Use for a short clip whose exact words and timings you need. For a long recording with several speakers use transcribe; for caption files use subtitle. Pass audio_url, or the audio itself as audio_base64. Cost: 2 credits, charged only when a call succeeds.

輸入參數languageaudio_urlaudio_base64

sound-generate

Sound Generation

Generate sound effects and short music tracks from text prompts (NOT speech: use tts for spoken voice). Returns the audio as base64 with its format, sample rate and duration. Use for sound effects, ambience and short instrumental music. It produces no spoken words: for speech use tts. Cost: 4 credits, charged only when a call succeeds.

輸入參數prompt必填output_formatduration_secondsprompt_influence

sms

SMS

Send SMS or WhatsApp messages. Default channel is SMS (reliable delivery). WhatsApp requires recipient opt-in: they must have messaged your Business number within 24 hours. Returns the message id, channel, recipient, sender number and send status. Sends a real message to a phone number: a sent message cannot be recalled, and every call sends a new one. Use it to text a number the user gave you. Cost: 1 credit, charged only when a call succeeds.

輸入參數to必填channelmessage必填

documents

Document Extraction

Extract structured data from URLs or content. Returns the extracted data as JSON (shaped by your schema when you pass one), with the source URL and whether long content was truncated. Use to turn a page or a text into structured fields. For a page's full text use scrape; for invoices and receipts use invoice-parse. Pass url or content; extraction_prompt says what to extract, and schema fixes the shape of the JSON you get back. Cost: 3 credits, charged only when a call succeeds.

輸入參數urlschemacontentextraction_prompt必填

companies

Company Enrichment

Enrich company data by domain. Returns the company's name, description, industry, size, founding year, headquarters, employees, revenue, funding, social links, technologies, logo and brand colors. Use for business facts about a company. For technical facts about its domain (WHOIS, DNS, SSL, hosting) use site-intel; for a person use profiles. Cost: 3 credits, charged only when a call succeeds.

輸入參數domain必填company_name

email-verify

Email Verification

Check if an email is deliverable, catch-all, or disposable. Returns the status (such as valid, invalid or catch-all) with a sub-status, whether it is a free mailbox, a suggested correction, the domain's age and its mail servers. Use before emailing an address you were given or found. To find an address from a person's name use emails. Cost: 1 credit, charged only when a call succeeds.

輸入參數email必填

transcribe

Transcription

Transcribe audio with speaker diarization and timestamps. Returns the full transcript with its confidence, language, duration, word and speaker counts, and the utterances, each with its speaker and start and end time. Use for meetings, interviews and podcasts, where who spoke when matters. For a short clip's word timings use stt; for caption files use subtitle. Cost: 3 credits, charged only when a call succeeds.

輸入參數languageaudio_url必填speaker_labels

invoice-parse

Invoice Parsing

Extract structured data from invoices and receipts. Returns the invoice number, dates, supplier and customer, currency, subtotal, tax, total and every line item. Use for an invoice or receipt given as a PDF or image URL. For any other document use documents with your own schema. Cost: 3 credits, charged only when a call succeeds.

輸入參數document_url必填

subtitle

Subtitles

Generate SRT/VTT subtitles from audio or video. Returns the subtitles as SRT or VTT text with the language, duration and number of cues. Use to caption a video or an audio file. For a plain transcript use stt or transcribe. Cost: 2 credits, charged only when a call succeeds.

輸入參數formatlanguageaudio_url必填

file-convert

File Conversion

Convert documents, web pages, spreadsheets and images between formats. Returns a download URL of the converted file with its name, size and formats. Use to change a file's format, for example Word to PDF or PDF to Markdown. To extract specific fields use documents; to read a web page's text use scrape. Cost: 2 credits, charged only when a call succeeds.

輸入參數file_url必填source_format必填target_format

bg-remove

Background Removal

Remove background from any image. Returns transparent PNG. Returns the cut-out as a base64 PNG with a transparent background. Use to isolate the subject of an existing image. To create a new image use images. Cost: 2 credits, charged only when a call succeeds.

輸入參數sizeimage_url必填

screenshot

Screenshot

Capture a rendered screenshot of any webpage. Returns the image as base64 with its format, dimensions and size in bytes. Use to see how a page looks. To read its text use scrape. Cost: 1 credit, charged only when a call succeeds.

輸入參數url必填widthformatheightfull_page

code-execute

Code Execution

Execute code in a secure sandbox with pre-configured environments. Returns stdout, stderr, the exit code, the run time, and the files the code wrote to /home/user/output/ as base64. Use for calculations, data processing and running scripts. Each call runs in a fresh sandbox that is destroyed afterwards, so nothing carries over from one call to the next. Cost: 2 credits, charged only when a call succeeds.

輸入參數code必填timeoutlanguagetemplate

site-intel

Site Intelligence

Get comprehensive domain intelligence: WHOIS, DNS, SSL, tech stack, email security, hosting. Returns, by mode, the registration (WHOIS) data, DNS records with email security, the technology stack, a security grade from A to F, or the subdomains; overview combines registration, DNS, SSL and hosting. Use for technical facts about a domain. For business facts about the company behind it use companies; to find a name you can register use domains. Cost: overview 2 credits, whois 1 credit, dns 1 credit, tech-stack 2 credits, security 2 credits, subdomains 2 credits, charged only when a call succeeds.

輸入參數modedomain必填

research

Deep Research

Multi-step deep research: search, scrape, enrich entities, and synthesize into a cited report. Returns a report (title, summary, sections, key findings, confidence) with numbered sources and the people and companies it found, enriched. Use for a question that needs many sources and a synthesized, cited answer. It takes far longer and costs more than search, which suits a quick fact. Cost: standard 10 credits, deep 20 credits, comprehensive 35 credits, charged only when a call succeeds. Options change it: include_analysis true +5, academic in source_types +2, enrich_entities false -3, synthesis false -5.

輸入參數depthquery必填freshnesssynthesismax_sourcessource_typesenrich_entitiesinclude_analysis

video-info

Video Info

Extract video metadata, available formats, and thumbnail from any URL. Returns the title, duration, thumbnail, uploader, upload date, view count, platform and the available formats with their sizes. Use to inspect a video before downloading it. To get the file use video-download; for what is said in it use transcribe. Cost: 1 credit, charged only when a call succeeds.

輸入參數url必填

video-download

Video Download

Download video from any URL and return a temporary download link. Returns a download link that expires after one hour, with the file name, size, duration, quality, format, title and thumbnail. Use to get a video, or only its audio, as a file. For its details without downloading use video-info. Cost: video 3 credits, audio 2 credits, charged only when a call succeeds.

輸入參數url必填formatquality

domains

Domains

Find domain names and the extensions that fit a business. Returns, by mode, name ideas with prices, extensions that fit with reasons, one name across extensions, availability for a list of domains, prices per extension, or the extension catalog. Use to name a business or check domains before buying one; it never registers or buys a domain. For facts about a domain that is already live use site-intel. mode decides which fields apply: company_name and description for the suggest modes, query for search-extensions, domains for check-availability, tlds for pricing. Cost: suggest-names 5 credits, suggest-extensions 3 credits, search-extensions 2 credits, check-availability 1 credit, pricing 1 credit, tlds 1 credit, charged only when a call succeeds.

輸入參數modetldsqueryoffsetdomainspurposecompany_iddescriptioncompany_namesearch_optionsexact_extension

版本歷史

4
  1. v0.3.4最新Oct 19, 2026
  2. v0.3.3Oct 7, 2026
  3. v0.3.2Oct 6, 2026
  4. v0.3.1Sep 16, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分