Ssave — TikTok & Instagram Downloader

@ssavecc/mcp-server

Servidor de Model Context Protocol (MCP) para Ssave.cc — extrae y descarga contenido multimedia de TikTok / Instagram / YouTube / Douyin (video HD sin marca de agua, audio MP3) directamente a tu disco local.

Se ejecuta localmente a través de stdio, respaldado por la Ssave Open API (/open/v1). No se requiere registro en el plan gratuito.

Inicio rápido

npx @ssavecc/mcp-server

Luego agrégalo a tu cliente MCP:

Claude Code

claude mcp add ssave -- npx @ssavecc/mcp-server

O a nivel de proyecto .mcp.json:

{
  "mcpServers": {
    "ssave": { "command": "npx", "args": ["@ssavecc/mcp-server"] }
  }
}

Cursor

Configuración → MCP → Agregar nuevo servidor MCP:

{
  "mcpServers": {
    "ssave": {
      "command": "npx",
      "args": ["@ssavecc/mcp-server"]
    }
  }
}

Claude Desktop

Edita claude_desktop_config.json:

{
  "mcpServers": {
    "ssave": {
      "command": "npx",
      "args": ["@ssavecc/mcp-server"]
    }
  }
}

Herramientas

Herramienta	Descripción
extract_media	Extrae metadatos y formatos disponibles de una URL de TikTok / Instagram / YouTube / Douyin. Devuelve un token ssv_ (expira en 5–15 min) más URLs de descarga por formato.
download_media	Transmite el contenido multimedia extraído al disco local (por defecto ~/Downloads/ssave/, se puede sobrescribir con output_dir). Devuelve la ruta absoluta y el tamaño.
get_thumbnail	Guarda la miniatura del contenido multimedia en el disco local (a través de proxy — nunca expone el enlace CDN de origen).

Flujo típico: extract_media(url) → toma el id devuelto → download_media(id, type: "hd" | "watermark" | "mp3").

Variables de entorno

Todas opcionales:

Variable	Valor por defecto	Descripción
SSAVE_API_BASE_URL	https://api.ssave.cc	Sobrescritura para desarrollo local (p. ej. http://localhost:8000).
SSAVE_API_KEY	—	Reservada para el plan de pago (Fase 3): se envía como Authorization: Bearer <key>.
SSAVE_OUTPUT_DIR	~/Downloads/ssave/	Directorio de salida por defecto cuando no se pasa output_dir.

Límites de uso (plan gratuito)

Compartidos con la Ssave Open API, por IP y por día UTC:

Operación	Límite
extract	10 / día
download	50 / día

En 429 rate_limited la herramienta informa la hora de reinicio en UTC.

Desarrollo

npm install
npm run dev        # run server on stdio (connect with MCP Inspector: npx @modelcontextprotocol/inspector)
npm test           # unit tests (mock fetch)
npm run build      # compile to dist/

Legal

Para archivo personal de contenido al que tengas acceso. Respeta los Términos de Servicio de las plataformas. Sin descargas masivas. Consulta ssave.cc/privacy.

Licencia

MIT