API・MCP

掲載中の音源は、REST APIとMCPサーバーから検索できます。認証もAPIキーも不要で、どちらも同じカタログを返します。曲の音源はYouTubeにあり、返却されるURLはその曲が始まる位置から再生されます。

MCPサーバー

AIエージェントから曲を探すためのMCPサーバーです。Streamable HTTPで待ち受け、セッションを持たないため、対応クライアントならURLを登録するだけで繋がります。

https://arcalune.com/mcp

クライアント設定

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

claude mcp add --transport http arcalune-music https://arcalune.com/mcp

ツール

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

曲の検索・単曲の取得・タグ一覧を返すJSON APIです。CORSは全オリジンに開いているため、ブラウザからも直接呼べます。

エンドポイント

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

クエリパラメータ (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.

レスポンス例

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

人気順の並び替え(sort=plays30d など)は、再生・ダウンロード・お気に入りをブラウザ側から送ってもらい、1日1件に丸めて集計した結果に基づきます。送信元は認証しておらず実測値ではないため、集計した数値そのものはAPIでは返していません。並び順の目安として扱ってください。

その場で試す

パラメータを選んで実行すると、このページから直接APIを呼びます。認証は不要で、返ってきた内容をそのまま表示します。

エンドポイント

tag

YouTubeでの再生

1本の動画に複数曲が入っているため、曲単体のリンクには開始位置が必要です。youtubeUrl はその頭出し込みのURLなので、曲を紹介するときはこれをそのまま使ってください。

https://www.youtube.com/watch?v=2qQ11AVavBQ&t=1233s

利用条件

フリーBGMと効果音は商用利用でき、クレジット表記も不要です。ファンアレンジは非公式のため試聴のみで、素材としては利用できません。レスポンスの usage フィールドに曲ごとの条件が入っています。

音源利用ガイドを見る