SonoVault

Pesquisa de metadados musicais: mais de 90 milhões de faixas, ISRC/ISWC, IDs multiplataforma

GitHubExperimente este MCPPatrocinado

Documentação

sonovault-mcp

CI npm

Servidor MCP para a API de metadados musicais SonoVault. Oferece ao Claude, Cursor e qualquer cliente MCP busca em mais de 93 milhões de faixas, artistas, gravadoras e lançamentos, com metadados completos por resultado: gênero, gravadora, datas de lançamento, créditos de artistas, códigos ISRC e ISWC, e IDs multiplataforma (Spotify, Apple Music, Tidal, Beatport, Discogs, MusicBrainz, YouTube).

Pergunte ao seu assistente coisas como:

  • "Quais lançamentos a mau5trap publicou este ano?"
  • "Encontre Veridis Quo do Daft Punk e me dê o gênero, a gravadora e o ISRC"
  • "Mostre a lista de faixas de Discovery com os ISRCs"
  • "Qual é o ID no Spotify e no Beatport para o ISRC GBDUW0000053?"
  • "Resolva este log de reprodução para ISRCs e gravadoras" (cole até 100 linhas)
  • "Liste todas as gravações do ISWC T-071.020.439-9"

Configuração

Você precisa de uma chave de API da SonoVault. O plano gratuito inclui 1.000 requisições/mês, sem cartão de crédito: obtenha uma chave.

Claude Desktop

Adicione em claude_desktop_config.json:

{
  "mcpServers": {
    "sonovault": {
      "command": "npx",
      "args": ["-y", "sonovault-mcp"],
      "env": { "SONOVAULT_API_KEY": "svk_live_..." }
    }
  }
}

Claude Code

claude mcp add sonovault -e SONOVAULT_API_KEY=svk_live_... -- npx -y sonovault-mcp

Cursor

Adicione em ~/.cursor/mcp.json (ou .cursor/mcp.json no seu projeto):

{
  "mcpServers": {
    "sonovault": {
      "command": "npx",
      "args": ["-y", "sonovault-mcp"],
      "env": { "SONOVAULT_API_KEY": "svk_live_..." }
    }
  }
}

VS Code (GitHub Copilot)

Adicione em .vscode/mcp.json:

{
  "servers": {
    "sonovault": {
      "command": "npx",
      "args": ["-y", "sonovault-mcp"],
      "env": { "SONOVAULT_API_KEY": "svk_live_..." }
    }
  }
}

Windsurf

Adicione o mesmo bloco mcpServers do Claude Desktop em ~/.codeium/windsurf/mcp_config.json.

Outros clientes MCP

Qualquer cliente que fale MCP via stdio funciona. Comando: npx -y sonovault-mcp com a variável de ambiente SONOVAULT_API_KEY definida.

Ferramentas

FerramentaO que faz
search_tracksBusca difusa por artista + título. Retorna ISRC, gênero, gravadora, data de lançamento.
lookup_isrcConsulta exata de gravação por ISRC.
get_trackBusca uma faixa pelo ID da SonoVault.
get_work_codesGravação para composição: o(s) ISWC(s) por trás de uma gravação.
get_recordings_of_workComposição para gravações: todas as gravações de um ISWC.
get_platform_linksID e link direto de uma faixa nas 7 plataformas, a partir de qualquer ID ou ISRC.
resolve_tracksResolução em lote de até 100 nomes de faixas, ISRCs ou IDs de plataforma.
search_artists, get_artist_releasesBusca de artistas e discografia, com identificadores Wikidata e MusicBrainz.
search_labels, get_label_releasesBusca de gravadoras e catálogo.
search_releases, get_releaseBusca de lançamentos e listas de faixas com ISRCs em ordem de reprodução, com números de disco e faixa, além dos IDs de lançamento e grupo de lançamento do MusicBrainz.
list_genresA hierarquia canônica de gêneros.
browse_tracksDescoberta por gravadora, artista, gênero ou ano (plano pago).

Todas as ferramentas são somente leitura. A maioria funciona no plano gratuito; browse_tracks exige um plano pago.

Exemplos de fluxos de trabalho

Enriqueça um log de reprodução de rádio para relatórios de royalties

Cole um log de reprodução com apenas artista e título e pergunte: "Resolva estes para ISRC, álbum e gravadora, e me dê uma tabela que eu possa mapear em um Relatório de Uso da SoundExchange." O assistente chama resolve_tracks uma vez a cada 100 linhas e retorna os identificadores que as sociedades de arrecadação reconhecem. Funciona igualmente para relatórios da PPL, Sena, GVL e Re:Sound.

Organize uma biblioteca de DJ

"Aqui estão 50 faixas da minha exportação do rekordbox. Encontre a versão canônica de cada uma, sinalize duplicatas que compartilham um ISRC e marque cada uma com seu gênero." O assistente combina resolve_tracks com os campos de gênero de cada resultado.

Conecte gravações a composições

"Tenho ISRCs da minha distribuidora. A quais obras musicais eles pertencem e que outras gravações existem de cada obra?" O assistente encadeia get_work_codes e get_recordings_of_work. Útil para administração de publicação e pesquisa de covers/versões.

Verifique disponibilidade multiplataforma

"Este exclusivo do Beatport já está no Spotify? Beatport ID 6014288." Uma única chamada de get_platform_links responde, com links diretos por plataforma.

Pesquise uma gravadora

"Resuma o que a Anjunabeats lançou nos últimos seis meses, agrupado por subgênero." O assistente navega pelas páginas de get_label_releases e extrai o gênero das listas de faixas.

FAQ

Existe um plano gratuito?

Sim. Uma chave gratuita da SonoVault inclui 1.000 requisições/mês, sem cartão de crédito. Todas as ferramentas, exceto browse_tracks, funcionam nele.

Quais metadados cada faixa inclui?

Título, créditos de artistas (com flags de artista principal/remixer), ISRC, duração, gênero e subgênero, e por lançamento: título do álbum, gravadora e data de lançamento. Os códigos de obra ISWC vêm das ferramentas dedicadas de códigos de obra.

Retorna BPM ou tonalidade musical?

Não. A API pública da SonoVault exclui deliberadamente características de áudio como BPM, tonalidade e energia. Também não há prévias de áudio nem capas de arte.

De onde vêm os dados?

Agregados e deduplicados de MusicBrainz, Discogs, Spotify, Apple Music, Tidal e Beatport, com links de ISWC do The MLC. Detalhes: sonovault.now/data-sources.

Qual é a diferença em relação a uma integração com a API do Spotify?

APIs de plataforma única retornam apenas seus próprios IDs. A SonoVault resolve uma gravação para seus IDs nas sete plataformas suportadas, usando ISRC como chave, e adiciona identificadores (ISRC, ISWC) que as APIs de plataforma não expõem. Comparação: sonovault.now/compare/spotify-api.

Minha chave de API é enviada para algum lugar além da SonoVault?

Não. O servidor roda localmente via stdio e envia sua chave apenas para api.sonovault.now como cabeçalho de requisição. O código é pequeno e auditável: src/server.ts.

Agent Skill

Não usa MCP? skill/SKILL.md é um Agent Skill que ensina qualquer agente a chamar a API da SonoVault diretamente via HTTP: regras de busca, receitas de ISRC/ISWC, resolução em lote e tratamento de erros.

Relacionados

Licença

MIT