suprsonic-mcp

공식

하나의 API 키로 AI 에이전트에 수십 가지 기능을 제공합니다. 제공자 인증이 필요 없습니다.

GitHub

Suprsonic MCP(으)로 무엇을 할 수 있나요?

웹 검색 — search를 사용하여 AI가 요약한 결과 또는 원시 SERP 데이터 옵션으로 최신 정보를 검색하도록 어시스턴트에 요청하세요.
웹페이지 콘텐츠 추출 — scrape를 통해 모든 URL에서 깔끔한 마크다운 형식의 콘텐츠를 추출하세요.
전문가 연락처 찾기 — profiles로 프로필을 조회하고 emails를 사용하여 이메일 주소를 찾아보세요.
이미지 및 음성 생성 — images로 텍스트 프롬프트에서 이미지를 생성하고 tts를 통해 텍스트를 음성 오디오로 변환하세요.
미디어 자막 및 텍스트 변환 — stt 또는 transcribe(화자 레이블 포함)로 오디오 파일을 텍스트로 변환하고 subtitle로 SRT/VTT 자막을 생성하세요.
문서 및 파일 처리 — documents로 URL에서 구조화된 데이터를 추출하고 invoice-parse를 통해 송장을 분석하며 file-convert로 200개 이상의 형식을 변환하고 screenshot으로 웹페이지 스크린샷을 캡처하세요.

문서

@suprsonic/mcp

Suprsonic용 MCP 서버입니다. 하나의 연결로 모든 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