# Send DJ mp3 sourcer to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "dj-mp3-sourcer", "name": "DJ mp3 sourcer", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/Robinnnnn/dj-mp3-sourcer", "canonicalUrl": "https://clawhub.ai/Robinnnnn/dj-mp3-sourcer", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/dj-mp3-sourcer", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=dj-mp3-sourcer", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "SKILL.md", "scripts/normalize-filenames.sh" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "dj-mp3-sourcer", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-05-02T08:30:53.654Z", "expiresAt": "2026-05-09T08:30:53.654Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=dj-mp3-sourcer", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=dj-mp3-sourcer", "contentDisposition": "attachment; filename=\"dj-mp3-sourcer-1.0.2.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "dj-mp3-sourcer" }, "scope": "item", "summary": "Item download looks usable.", "detail": "Yavira can redirect you to the upstream package for this item.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/dj-mp3-sourcer" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/dj-mp3-sourcer", "downloadUrl": "https://openagent3.xyz/downloads/dj-mp3-sourcer", "agentUrl": "https://openagent3.xyz/skills/dj-mp3-sourcer/agent", "manifestUrl": "https://openagent3.xyz/skills/dj-mp3-sourcer/agent.json", "briefUrl": "https://openagent3.xyz/skills/dj-mp3-sourcer/agent.md" } } ``` ## Documentation ### DJ MP3 Sourcer DJ-oriented music downloading skill. Takes any music link and finds the best available source, prioritizing extended mixes and MP3 320k output. ⚠️ Legal Notice: This skill is intended for downloading music you have the right to access — purchases, free releases, creative commons, etc. Respect copyright laws in your jurisdiction. The author is not responsible for misuse. ### Dependencies pip install yt-dlp spotdl brew install ffmpeg # needed by yt-dlp for audio extraction # optional pip install bandcamp-dl # for free bandcamp downloads ### Source Priority Search in this order — stop at the first match: Bandcamp — supports artists directly, often has extended mixes Beatport — DJ-standard, has BPM/key metadata, extended mixes Amazon Music — digital purchase option Spotify (via spotdl) — good metadata/tagging, 320k MP3 YouTube (via yt-dlp) — fallback, always works For paid sources (bandcamp, beatport, amazon), surface the purchase link with price. For free sources, download directly. If free only mode is enabled, skip steps 1-3 and go straight to spotdl → yt-dlp. ### Core Rule: Prefer Extended Mixes Always prefer the extended mix over radio edits. An extended mix from a lower-priority source beats a radio edit from a higher-priority one. Example: extended mix on YouTube > radio edit on Spotify. When searching, append "extended mix" to queries. If only a radio edit exists, note it in the output. ### Workflow Identify the track — extract artist + title: yt-dlp --dump-json "" | jq '{title, artist: .artist // .uploader, duration}' Search each source using web_search: " extended mix site:bandcamp.com" "<artist> <title> extended mix site:beatport.com" "<artist> <title> site:amazon.com/music" Download or link — free sources download; paid sources return purchase URL with price Tag the file — artist, title, album, cover art. Note BPM/key if available from beatport. ### spotdl spotdl download "<spotify-url>" --output "{artist} - {title}" --format mp3 --bitrate 320k ### yt-dlp yt-dlp -x --audio-format mp3 --audio-quality 0 \\ --embed-thumbnail --add-metadata \\ --metadata-from-title "%(artist)s - %(title)s" \\ -o "%(artist)s - %(title)s.%(ext)s" "<url>" ### Post-Download: Filename Normalization yt-dlp filenames are often messy (NA - prefixes, (Official Video) suffixes, label names, wrong artist credits). Always run the normalization script after downloads complete. Usage: # 1. Write the tracklist as JSON (from the parsed tracklist in step 2) cat > /tmp/tracklist.json << 'EOF' [{"artist": "Karol G", "title": "Ivonny Bonita"}, {"artist": "Doja Cat", "title": "Woman (Never Dull's Disco Rework)"}] EOF # 2. Run the normalize script scripts/normalize-filenames.sh ~/Downloads/set-name /tmp/tracklist.json The script fuzzy-matches each mp3 in the directory to a tracklist entry and renames to clean Artist - Title.mp3 format. Unmatched files are left untouched. The tracklist is the source of truth for filenames, not YouTube metadata. ### Configuration SettingDefaultNotesOutput directory~/Downloads/Where files are saved (subfolder per set when used with dj-set-ripper)Formatmp3 320kHigh-bitrate MP3; configurable to flac if neededExtended mixalwaysPrefer extended/original mix over radio editFree onlyfalseWhen true, skip paid sources (bandcamp, beatport, amazon) — only use spotdl and yt-dlp ### Batch Processing When given multiple links, process in parallel using sub-agents (sessions_spawn). Report results as each track completes. ### Edge Cases DJ mixes / long sets — download via yt-dlp directly, skip source searching Unavailable tracks — report clearly, suggest alternatives if found Region-locked content — note restriction, try alternative sources Remix vs original — if the link is a specific remix, search for that exact remix, not the original ## Trust - Source: tencent - Verification: Indexed source record - Publisher: Robinnnnn - Version: 1.0.2 ## Source health - Status: healthy - Item download looks usable. - Yavira can redirect you to the upstream package for this item. - Health scope: item - Reason: direct_download_ok - Checked at: 2026-05-02T08:30:53.654Z - Expires at: 2026-05-09T08:30:53.654Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/dj-mp3-sourcer) - [Send to Agent page](https://openagent3.xyz/skills/dj-mp3-sourcer/agent) - [JSON manifest](https://openagent3.xyz/skills/dj-mp3-sourcer/agent.json) - [Markdown brief](https://openagent3.xyz/skills/dj-mp3-sourcer/agent.md) - [Download page](https://openagent3.xyz/downloads/dj-mp3-sourcer)