API et MCP
Tout le catalogue est interrogeable via une API REST et un serveur MCP. Ni l'un ni l'autre ne demande de clé d'API ou d'authentification, et les deux renvoient les mêmes morceaux. L'audio est hébergé sur YouTube, et chaque URL renvoyée démarre là où le morceau commence. Si vous écrivez votre propre client HTTP, indiquez dans le User-Agent le nom et la version réels de votre application dès la première requête. En cas d'erreur 1010 de Cloudflare, arrêtez les tentatives automatiques et examinez le corps de la réponse ainsi que le Ray ID.
Serveur MCP
Un serveur MCP pour trouver des morceaux depuis un agent IA. Il parle Streamable HTTP et ne conserve aucune session : un client compatible n'a besoin que de l'URL.
https://arcalune.com/mcpConfiguration du client
{
"mcpServers": {
"arcalune-music": {
"type": "http",
"url": "https://arcalune.com/mcp"
}
}
}claude mcp add --transport http arcalune-music https://arcalune.com/mcpOutils
- 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
Une API JSON pour rechercher des morceaux, récupérer un morceau et lister les étiquettes. Le CORS est ouvert à toutes les origines : vous pouvez donc l'appeler directement depuis le navigateur.
Points d'accès
GET https://arcalune.com/api/v1/tracks
GET https://arcalune.com/api/v1/tracks/{id}
GET https://arcalune.com/api/v1/tagsParamètres de requête (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.
Exemple de réponse
curl "https://arcalune.com/api/v1/tracks?category=bgm&tag=lofi&limit=1&locale=en"Cet exemple en anglais a été obtenu via l’API publique. Le total et les morceaux renvoyés peuvent varier lorsque le catalogue évolue.
{
"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"
}
]
}Le tri par popularité (sort=plays30d, etc.) repose sur les écoutes, téléchargements et favoris signalés par le navigateur, comptés une fois par jour. L'émetteur n'étant pas authentifié, ce ne sont pas des valeurs mesurées : l'API ne renvoie pas les chiffres eux-mêmes. Considérez cet ordre comme une simple indication.
Essayer ici
Choisissez les paramètres et lancez la requête directement depuis cette page. Aucune authentification n'est nécessaire, et la réponse s'affiche telle quelle.
curl "https://arcalune.com/api/v1/tracks"Lecture sur YouTube
Une vidéo contient généralement plusieurs morceaux : le lien vers un morceau précis a donc besoin de son point de départ. youtubeUrl l'inclut déjà — utilisez-le tel quel chaque fois que vous présentez un morceau.
https://www.youtube.com/watch?v=XR-j50V8SIU&t=1319sConditions d'utilisation
Lorsque vous recommandez un morceau comme ressource pour une vidéo ou un autre contenu, vérifiez que son usage.type est free-download, qu’un downloadUrl est présent et que les conditions d’utilisation indiquées dans usage conviennent à l’usage prévu. Les musiques de fond et effets sonores gratuits proposés au téléchargement peuvent être utilisés à des fins commerciales dans le respect de ces conditions, sans obligation de crédit. Pour l’écoute, vous pouvez utiliser le youtubeUrl qui inclut le point de départ du morceau. Les arrangements de fans et les chansons originales avec voix sont réservés à l’écoute.
Lire le guide d'utilisation