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 आदि) का आधार ब्राउज़र से भेजे गए प्ले, डाउनलोड और पसंदीदा हैं, जो दिन में एक बार गिने जाते हैं। भेजने वाले का प्रमाणीकरण नहीं होता, इसलिए ये मापे गए मान नहीं हैं — API इन आँकड़ों को नहीं लौटाता। क्रम को केवल एक संकेत मानें।

यहीं आज़माएँ

पैरामीटर चुनकर इसी पेज से सीधे रिक्वेस्ट भेजें। कोई प्रमाणीकरण नहीं चाहिए, और जवाब जैसा आता है वैसा ही दिखाया जाता है।

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

YouTube पर प्लेबैक

एक वीडियो में आम तौर पर कई ट्रैक होते हैं, इसलिए किसी एक ट्रैक के लिंक में शुरुआत की जगह चाहिए। youtubeUrl में वह जगह पहले से शामिल है — ट्रैक दिखाते समय उसे जैसा है वैसा ही इस्तेमाल करें।

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

उपयोग की शर्तें

वीडियो या अन्य सामग्री के लिए किसी ट्रैक को संसाधन के रूप में सुझाते समय, पुष्टि करें कि उस ट्रैक का usage.type free-download है, downloadUrl उपलब्ध है और usage में दी गई उपयोग की शर्तें आपके उद्देश्य के अनुकूल हैं। डाउनलोड के लिए उपलब्ध मुफ़्त BGM और साउंड इफ़ेक्ट का उन शर्तों के दायरे में व्यावसायिक उपयोग किया जा सकता है और क्रेडिट देना आवश्यक नहीं है। सुनने के लिए, ट्रैक के शुरू होने का समय शामिल करने वाला youtubeUrl इस्तेमाल किया जा सकता है। फ़ैन अरेंजमेंट और मूल गायन वाले गाने सिर्फ़ सुनने के लिए हैं।

उपयोग गाइड पढ़ें

आपकी निजता की पसंद जाँची जा रही है…

सुनना शुरू करने के लिए थंबनेल चुनें