API dan MCP

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 royalty-free BGM, sound effects, and video game fan arrangements. Every track streams on YouTube, and the returned youtubeUrl jumps straight to where that track starts. When presenting results to a user, always include the youtubeUrl so they can listen to the track. Free BGM and sound effects allow commercial use without credit; fan arrangements are streaming-only.

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 | 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 used for track titles, descriptions, and tag names.

Contoh respons

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

{
  "total": 150,
  "limit": 20,
  "offset": 0,
  "tracks": [
    {
      "id": "kohaku",
      "title": { "ja": "琥珀の書斎", "en": "The Amber Study" },
      "category": "original",
      "durationSeconds": 188,
      "tags": [{ "id": "lofi", "label": { "ja": "Lo-fi", "en": "Lo-fi" }, "group": "genre" }],
      "youtubeUrl": "https://www.youtube.com/watch?v=4i5aoHjXizI",
      "youtubeVideoId": "4i5aoHjXizI",
      "startSeconds": 0,
      "pageUrl": "https://arcalune.com/tracks/kohaku",
      "imageUrl": "https://arcalune.com/track-images/kohaku",
      "downloadUrl": "https://arcalune.com/api/tracks/kohaku/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-07-21T00:00:00.000Z"
    }
  ]
}

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=2qQ11AVavBQ&t=1233s

Ketentuan penggunaan

BGM gratis dan efek suara boleh dipakai secara komersial tanpa mencantumkan kredit. Aransemen penggemar bersifat tidak resmi, hanya untuk didengarkan, dan tidak bisa dipakai ulang sebagai materi. Kolom usage pada setiap respons memuat ketentuan trek tersebut.