API e MCP
Todo o catálogo pode ser consultado por uma API REST e por um servidor MCP. Nenhum dos dois exige chave de API ou autenticação, e ambos devolvem as mesmas faixas. O áudio fica no YouTube, e cada URL que devolvemos começa exatamente onde a faixa começa. Se escrever o seu próprio cliente HTTP, defina o User-Agent com o nome e a versão reais da sua aplicação desde o primeiro pedido. Se receber um erro 1010 da Cloudflare, pare as repetições automáticas e verifique o corpo da resposta e o Ray ID.
Servidor MCP
Um servidor MCP para encontrar faixas a partir de um agente de IA. Ele fala Streamable HTTP e não mantém sessão, então um cliente compatível só precisa da URL.
https://arcalune.com/mcpConfiguração do cliente
{
"mcpServers": {
"arcalune-music": {
"type": "http",
"url": "https://arcalune.com/mcp"
}
}
}claude mcp add --transport http arcalune-music https://arcalune.com/mcpFerramentas
- search_tracks
- Search Arcalune Music for free BGM and sound effects, plus streaming-only video game fan arrangements and original vocal songs. Every track streams on YouTube, and the returned youtubeUrl jumps straight to where that track starts. Recommend a track as reusable audio only when usage.type is "free-download", downloadUrl is present, and usage permits the intended use. Check commercial permission, attribution, and restrictions in usage. For listening, share pageUrl and the timestamped youtubeUrl.
- get_track
- Get one track by id, together with related tracks from the same catalog. Returns the YouTube URL with the track's start position, the track page, and the download URL when the audio is distributed.
- list_tags
- List every tag that can be passed to search_tracks, grouped by production use, genre, mood, usage, scene, source game, and usage rights, with how many tracks carry each tag.
API REST
Uma API JSON para buscar faixas, obter uma faixa e listar etiquetas. O CORS está aberto para qualquer origem, então você pode chamá-la direto do navegador.
Endpoints
GET https://arcalune.com/api/v1/tracks
GET https://arcalune.com/api/v1/tracks/{id}
GET https://arcalune.com/api/v1/tagsParâmetros de consulta (GET /api/v1/tracks)
- qstring
- Free text over titles, descriptions, and tag names (ja + en).
- tagstring
- Tag id. Repeat or comma-separate for an OR filter.
- categoryall | bgm | se | song | arrangement
- Catalog to search. Defaults to all.
- downloadabletrue | false
- Filter by whether the audio file is distributed.
- sortdefault | newest | title | plays30d | playsAll | favorites | downloads30d | downloadsAll
- Result order. Defaults to default (newest first).
- limitinteger (max 100)
- Page size. Defaults to 20.
- offsetinteger
- Number of tracks to skip. Defaults to 0.
- localeja | en | es | pt | hi | id | fr
- Language of track titles, descriptions, and page URLs. Tag labels include all supported languages.
Exemplo de resposta
curl "https://arcalune.com/api/v1/tracks?category=bgm&tag=lofi&limit=1&locale=en"Este exemplo foi obtido em inglês pela API pública. O total e as faixas retornadas podem mudar conforme o catálogo é atualizado.
{
"total": 5,
"limit": 1,
"offset": 0,
"tracks": [
{
"id": "candy-land-06-soda-rain",
"title": "Soda Rain",
"description": "Soda bubbles fall like rain over the candy kingdom. Cute chill hop with a mellow electric piano, as background for work or chatty streams.",
"category": "original",
"durationSeconds": 270,
"tags": [
{
"id": "downloadable",
"label": {
"ja": "ダウンロード可",
"en": "Free download",
"es": "Descarga gratuita",
"pt": "Download gratuito",
"hi": "मुफ़्त डाउनलोड",
"id": "Unduhan gratis",
"fr": "Téléchargement gratuit"
},
"group": "access"
},
{
"id": "lofi",
"label": {
"ja": "Lo-fi",
"en": "Lo-fi",
"es": "Lo-fi",
"pt": "Lo-fi",
"hi": "Lo-fi",
"id": "Lo-fi",
"fr": "Lo-fi"
},
"group": "genre"
},
{
"id": "cute",
"label": {
"ja": "かわいい",
"en": "Cute",
"es": "Adorable",
"pt": "Fofo",
"hi": "प्यारा",
"id": "Menggemaskan",
"fr": "Mignon"
},
"group": "mood"
},
{
"id": "chill",
"label": {
"ja": "チル",
"en": "Chill",
"es": "Relajado",
"pt": "Relaxante",
"hi": "सुकून",
"id": "Santai",
"fr": "Détendu"
},
"group": "mood"
},
{
"id": "rain",
"label": {
"ja": "雨",
"en": "Rain",
"es": "Lluvia",
"pt": "Chuva",
"hi": "बारिश",
"id": "Hujan",
"fr": "Pluie"
},
"group": "mood"
},
{
"id": "streaming",
"label": {
"ja": "生配信",
"en": "Streaming",
"es": "Directos",
"pt": "Lives",
"hi": "लाइव स्ट्रीम",
"id": "Siaran langsung",
"fr": "Direct"
},
"group": "usage"
},
{
"id": "video-production",
"label": {
"ja": "動画・配信",
"en": "Video & streaming",
"es": "Vídeo y directos",
"pt": "Vídeo e lives",
"hi": "वीडियो और स्ट्रीम",
"id": "Video & siaran",
"fr": "Vidéo et direct"
},
"group": "purpose"
}
],
"youtubeUrl": "https://www.youtube.com/watch?v=XR-j50V8SIU&t=1319s",
"youtubeVideoId": "XR-j50V8SIU",
"startSeconds": 1319,
"pageUrl": "https://arcalune.com/en/tracks/candy-land-06-soda-rain",
"imageUrl": "https://arcalune.com/track-images/candy-land-06-soda-rain",
"downloadUrl": "https://arcalune.com/api/tracks/candy-land-06-soda-rain/download",
"isArrangement": false,
"usage": {
"type": "free-download",
"commercialUse": true,
"creditRequired": false,
"restrictions": [
"no-standalone-redistribution",
"no-ai-training"
],
"termsUrl": "https://arcalune.com/about#usage-guide"
},
"publishedAt": "2026-11-05"
}
]
}A ordenação por popularidade (sort=plays30d e afins) baseia-se em reproduções, downloads e favoritos informados pelo navegador, contados uma vez por dia. Quem envia não é autenticado, então não são valores medidos — a API não devolve os números em si. Trate a ordem como uma dica.
Teste aqui
Escolha os parâmetros e dispare a requisição direto desta página. Não é preciso autenticação, e a resposta aparece exatamente como chega.
curl "https://arcalune.com/api/v1/tracks"Reprodução no YouTube
Um vídeo geralmente traz várias faixas, então o link para uma faixa específica precisa do ponto de início. O youtubeUrl já inclui esse ponto — use-o como está sempre que apresentar uma faixa.
https://www.youtube.com/watch?v=XR-j50V8SIU&t=1319sCondições de uso
Ao recomendar uma faixa como recurso para vídeos ou outros conteúdos, confira se o usage.type é free-download, se existe um downloadUrl e se as condições de uso em usage são adequadas à finalidade prevista. As músicas de fundo e os efeitos sonoros gratuitos disponíveis para download podem ser usados comercialmente dentro dessas condições, sem necessidade de crédito. Para ouvi-los, você pode usar o youtubeUrl que inclui o ponto de início da faixa. Os arranjos de fãs e as canções originais com voz estão disponíveis apenas para audição.
Ler o guia de uso