API dan MCP

Seluruh katalog bisa ditelusuri melalui REST API dan server MCP. Keduanya tidak butuh kunci API atau autentikasi, dan keduanya mengembalikan trek yang sama. Audionya ada di YouTube, dan setiap URL yang kami kembalikan mulai tepat di titik trek itu dimulai. Jika Anda menulis klien HTTP sendiri, tetapkan User-Agent dengan nama dan versi aplikasi Anda yang sebenarnya sejak permintaan pertama. Jika menerima error 1010 dari Cloudflare, hentikan percobaan ulang otomatis dan periksa isi respons serta Ray ID.

Server MCP

Server MCP untuk mencari trek dari agen AI. Server ini berbicara Streamable HTTP dan tidak menyimpan sesi, jadi klien yang kompatibel hanya perlu URL-nya.

https://arcalune.com/mcp

Konfigurasi klien

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

Tool

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.

REST API

API JSON untuk mencari trek, mengambil satu trek, dan menampilkan daftar tag. CORS terbuka untuk semua origin, jadi kamu bisa memanggilnya langsung dari browser.

Endpoint

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

Parameter kueri (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.

Contoh respons

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

Contoh berbahasa Inggris ini diambil dari API publik. Jumlah dan trek yang dikembalikan dapat berubah seiring pembaruan katalog.

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

Pengurutan popularitas (sort=plays30d dan sejenisnya) didasarkan pada putaran, unduhan, dan favorit yang dilaporkan browser, dihitung sekali per hari. Pengirimnya tidak diautentikasi, jadi ini bukan nilai hasil pengukuran — API tidak mengembalikan angkanya. Anggap urutannya sebagai petunjuk saja.

Coba di sini

Pilih parameternya lalu kirim permintaan langsung dari halaman ini. Tidak perlu autentikasi, dan responsnya ditampilkan apa adanya.

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

Pemutaran di YouTube

Satu video biasanya memuat beberapa trek, jadi tautan ke satu trek perlu titik awalnya. youtubeUrl sudah menyertakan titik itu — pakai apa adanya setiap kali kamu menampilkan sebuah trek.

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

Ketentuan penggunaan

Jika Anda merekomendasikan lagu sebagai materi untuk video atau konten lain, pastikan usage.type setiap lagu bernilai free-download, tersedia downloadUrl, dan ketentuan penggunaan di usage sesuai dengan tujuan penggunaan. BGM dan efek suara gratis yang tersedia untuk diunduh dapat digunakan secara komersial selama mematuhi ketentuan tersebut, dan pencantuman kredit tidak diwajibkan. Untuk pratinjau, gunakan youtubeUrl yang mencantumkan posisi awal lagu. Aransemen penggemar dan lagu vokal orisinal tersedia hanya untuk didengarkan.

Baca panduan penggunaan

Memeriksa pilihan privasimu…

Pilih thumbnail untuk mulai mendengarkan