suprsonic-mcp

chính thức

Một khóa API, hàng chục khả năng cho tác nhân AI của bạn. Không cần xác thực nhà cung cấp.

GitHub

Bạn có thể làm gì với Suprsonic MCP?

  • Tìm kiếm trên web — Yêu cầu trợ lý tìm kiếm thông tin hiện tại bằng cách sử dụng search, với các tùy chọn cho kết quả tổng hợp AI hoặc dữ liệu SERP thô.
  • Trích xuất nội dung trang web — Yêu cầu trích xuất Markdown sạch từ bất kỳ URL nào qua scrape.
  • Tìm kiếm liên hệ chuyên nghiệp — Tra cứu hồ sơ với profiles và khám phá địa chỉ email bằng emails.
  • Tạo hình ảnh và giọng nói — Tạo hình ảnh từ văn bản mô tả bằng images và chuyển đổi văn bản thành âm thanh nói qua tts.
  • Phiên âm và phụ đề phương tiện — Phiên âm các tệp âm thanh bằng stt hoặc transcribe (có nhãn người nói), và tạo phụ đề SRT/VTT với subtitle.
  • Xử lý tài liệu và tệp tin — Trích xuất dữ liệu có cấu trúc từ URL bằng documents, phân tích hóa đơn qua invoice-parse, chuyển đổi giữa hơn 200 định dạng bằng file-convert, và chụp ảnh màn hình trang web với screenshot.

Tài liệu

@suprsonic/mcp

Máy chủ MCP cho Suprsonic. Cung cấp cho bất kỳ tác nhân AI nào hàng chục khả năng thông qua một kết nối duy nhất.

Bắt Đầu Nhanh

SUPRSONIC_API_KEY=omk_your_key npx -y @suprsonic/mcp

Lấy khóa API của bạn tại suprsonic.ai/app/apis.

Claude Desktop

Thêm vào ~/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

Thêm vào .cursor/mcp.json hoặc cấu hình MCP của VS Code:

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

HTTP Từ Xa (dành cho Claude API, ChatGPT, tác nhân lập trình)

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

Sau đó kết nối tới http://localhost:3100/mcp.

Công Cụ Khả Dụng

Công cụChức năng
searchTìm kiếm trên web (tổng hợp AI, SERP, hoặc cả hai)
scrapeTrích xuất nội dung từ bất kỳ URL nào dưới dạng Markdown
profilesTìm hồ sơ chuyên nghiệp theo tên hoặc URL LinkedIn
emailsTìm địa chỉ email chuyên nghiệp
imagesTạo hình ảnh từ mô tả văn bản
ttsChuyển văn bản thành giọng nói
sttChuyển âm thanh thành văn bản
smsGửi tin nhắn SMS hoặc WhatsApp
documentsTrích xuất dữ liệu có cấu trúc từ URL
companiesTra cứu dữ liệu công ty theo tên miền
email-verifyKiểm tra xem email có thể gửi đến được không
transcribeChuyển âm thanh thành văn bản kèm nhãn người nói
invoice-parseTrích xuất dữ liệu từ hóa đơn
subtitleTạo phụ đề SRT/VTT
file-convertChuyển đổi tệp giữa hơn 200 định dạng
bg-removeXóa nền ảnh
screenshotChụp ảnh màn hình trang web

Định Dạng Phản Hồi

Mỗi công cụ trả về một đối tượng phản hồi thống nhất:

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

Khi thất bại, success là false và error chứa chi tiết (xem bên dưới).

Xử Lý Lỗi

Cấu trúc đối tượng lỗi (được trả về khi success là 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"
}

Các loại lỗi: transient (an toàn để thử lại), permanent (yêu cầu không hợp lệ), authentication (khóa không hợp lệ), billing (hết tín dụng).

Khi sử dụng MCP, tác nhân AI nhận lỗi trong phản hồi công cụ và có thể quyết định thử lại dựa trên is_retriable và retry_after_seconds.

Tham khảo API đầy đủ với tất cả tham số và phản hồi mẫu: suprsonic.ai/apis