Ssave — TikTok & Instagram Downloader

@ssavecc/mcp-server

Servidor Model Context Protocol (MCP) para Ssave.cc — extraia e baixe mídia do TikTok / Instagram / YouTube / Douyin (vídeo HD sem marca d'água, áudio MP3) diretamente para o seu disco local.

Executa localmente via stdio, com suporte da Ssave Open API (/open/v1). Nenhum registro necessário no plano gratuito.

Início Rápido

npx @ssavecc/mcp-server

Depois, adicione-o ao seu cliente MCP:

Claude Code

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

Ou no nível do projeto .mcp.json:

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

Cursor

Configurações → MCP → Adicionar novo servidor MCP:

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

Claude Desktop

Edite claude_desktop_config.json:

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

Ferramentas

Ferramenta	Descrição
extract_media	Extrai metadados e formatos disponíveis de uma URL do TikTok / Instagram / YouTube / Douyin. Retorna um token ssv_ (expira em 5–15 min) além de URLs de download por formato.
download_media	Transmite a mídia extraída para o disco local (padrão ~/Downloads/ssave/, substituível com output_dir). Retorna o caminho absoluto e o tamanho.
get_thumbnail	Salva a miniatura da mídia no disco local (via proxy — nunca expõe o link CDN de origem).

Fluxo típico: extract_media(url) → pegue o id retornado → download_media(id, type: "hd" | "watermark" | "mp3").

Variáveis de Ambiente

Todas opcionais:

Variável	Padrão	Descrição
SSAVE_API_BASE_URL	https://api.ssave.cc	Substituição para desenvolvimento local (ex.: http://localhost:8000).
SSAVE_API_KEY	—	Reservado para o plano pago (Fase 3): enviado como Authorization: Bearer <key>.
SSAVE_OUTPUT_DIR	~/Downloads/ssave/	Diretório de saída padrão quando output_dir não é informado.

Limites de Taxa (plano gratuito)

Compartilhados com a Ssave Open API, por IP por dia UTC:

Operação	Limite
extract	10 / dia
download	50 / dia

Em 429 rate_limited a ferramenta informa o horário de redefinição UTC.

Desenvolvimento

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 arquivamento pessoal de conteúdo ao qual você tem acesso. Respeite os Termos de Serviço da plataforma. Sem download em massa. Consulte ssave.cc/privacy.

Licença

MIT