API y MCP

Todo el catálogo se puede consultar mediante una API REST y un servidor MCP. Ninguno necesita clave de API ni autenticación, y ambos devuelven las mismas pistas. El audio vive en YouTube, y cada URL que devolvemos empieza justo donde empieza esa pista. Si escribes tu propio cliente HTTP, indica en el User-Agent el nombre y la versión reales de tu aplicación desde la primera petición. Si recibes un error 1010 de Cloudflare, detén los reintentos automáticos y revisa el cuerpo de la respuesta y el Ray ID.

Servidor MCP

Un servidor MCP para encontrar pistas desde un agente de IA. Habla Streamable HTTP y no mantiene sesión, así que a un cliente compatible le basta con la URL.

https://arcalune.com/mcp

Configuración del cliente

{
  "mcpServers": {
    "arcalune-music": {
      "type": "http",
      "url": "https://arcalune.com/mcp"
    }
  }
}
claude mcp add --transport http arcalune-music https://arcalune.com/mcp

Herramientas

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

Una API JSON para buscar pistas, obtener una sola pista y listar etiquetas. CORS está abierto a cualquier origen, así que puedes llamarla directamente desde el navegador.

Endpoints

GET https://arcalune.com/api/v1/tracks
GET https://arcalune.com/api/v1/tracks/{id}
GET https://arcalune.com/api/v1/tags

Pará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.

Ejemplo de respuesta

curl "https://arcalune.com/api/v1/tracks?category=bgm&tag=lofi&limit=1&locale=en"

Este ejemplo se obtuvo en inglés de la API pública. El total y las pistas devueltas pueden cambiar cuando se actualice el catálogo.

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

El orden por popularidad (sort=plays30d y similares) se basa en reproducciones, descargas y favoritos que informa el navegador, contados una vez al día. Quien los envía no está autenticado, así que no son valores medidos: la API no devuelve las cifras en sí. Tómalo como una pista para ordenar.

Pruébalo aquí

Elige los parámetros y lanza la petición desde esta misma página. No hace falta autenticación y la respuesta se muestra tal cual llega.

curl "https://arcalune.com/api/v1/tracks"

Reproducción en YouTube

Un vídeo suele contener varias pistas, así que el enlace a una pista concreta necesita su punto de inicio. youtubeUrl ya lo incluye: úsalo tal cual siempre que presentes una pista.

https://www.youtube.com/watch?v=XR-j50V8SIU&t=1319s

Condiciones de uso

Si vas a recomendar una pista como recurso para vídeos u otros contenidos, comprueba que su usage.type sea free-download, que exista un downloadUrl y que las condiciones de uso de usage sean adecuadas para el uso previsto. La música de fondo y los efectos de sonido gratuitos disponibles para descarga pueden utilizarse con fines comerciales dentro de sus condiciones, sin necesidad de atribución. Para escucharlos, puedes usar el youtubeUrl que incluye el punto de inicio de la pista. Los arreglos de aficionados y las canciones originales con voz son solo para escuchar.

Leer la guía de uso

Comprobando tus opciones de privacidad…

Elige una miniatura para empezar a escuchar