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 分