API・MCP

掲載中の音源は、REST APIとMCPサーバーから検索できます。認証もAPIキーも不要で、どちらも同じカタログを返します。曲の音源はYouTubeにあり、返却されるURLはその曲が始まる位置から再生されます。自作のHTTPクライアントでは、初回のリクエストからUser-Agentに実際のアプリ名とバージョンを指定してください。Cloudflareエラー1010が返った場合は自動再試行を止め、応答本文とRay IDを確認してください。

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 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

曲の検索・単曲の取得・タグ一覧を返す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 | 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.

レスポンス例

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

公開APIから取得した英語の応答例です。掲載内容に応じて、件数や返る曲は変わります。

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

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

その場で試す

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

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

YouTubeでの再生

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

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

利用条件

動画などの素材として案内する場合は、曲ごとの usage.type が free-download で、downloadUrl があり、usage の利用条件が用途に合うことを確認してください。配布対応のフリーBGM・効果音は、利用条件の範囲で商用利用でき、クレジット表記は不要です。試聴には曲の開始位置が入った youtubeUrl を使えます。ファンアレンジとオリジナルのボーカル曲は試聴専用です。

音源利用ガイドを見る

プライバシー設定を確認しています…

サムネイルを押すと試聴できます