API और MCP

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

यहीं आज़माएँ

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

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

YouTube पर प्लेबैक

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

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

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

मुफ़्त BGM और साउंड इफ़ेक्ट को श्रेय दिए बिना व्यावसायिक रूप से इस्तेमाल किया जा सकता है। फ़ैन अरेंजमेंट अनौपचारिक हैं, सिर्फ़ सुनने के लिए हैं, और सामग्री के रूप में दोबारा इस्तेमाल नहीं किए जा सकते। हर प्रतिक्रिया का usage फ़ील्ड उस ट्रैक की शर्तें बताता है।