{"id":"5be62347-c135-4148-8b0d-0a4720e4ed3c","shortId":"E8wwNB","kind":"skill","title":"harmix-music-search","tagline":"Search for music tracks using natural language prompts or video content via the Harmix AI API. Use when the user asks to find music, search for songs, discover tracks, needs music recommendations based on mood/genre/tempo/scene, or wants to find music for a video, video soundtrac","description":"# Harmix AI Music Search\n\n[Harmix](https://www.harmix.ai/) is an AI-powered music search platform tailored for production music, TV and movie productions, record labels, and publishers. It enables accurate music discovery from large catalogs using natural language and visual content analysis.\n\n## Features Available in This Skill\n\n- **Prompt Search**: Search music using free text descriptions (mood, genre, tempo, scene, etc.)\n- **Video Search**: Upload video frames to find music that matches the visual mood and content\n\n## Documentation\n\n- API Documentation: https://docs.harmix.ai/\n- Web Platform: https://web.harmix.ai/\n\n## Authentication\n\nAll requests require the `api_key` header:\n\n```\napi_key: v8mWxAGAFTEFcU9NYGGhDWWbzYXS5e\n```\n\n## Output Format for Users\n\nWhen presenting search results to users, display each track with:\n\n1. **Title**: The track title\n2. **Artist(s)**: The artist name(s)\n3. **URL**: Link to the track on its streaming service (Spotify, Apple Music, Deezer, etc.)\n\nExtract these from the response:\n- Title: `metadata.track_title`\n- Artists: `metadata.artists`\n- URL: `metadata.extra_parameters.url`\n\nExample output format:\n```\n1. \"Energy Boost\" by Electric Dreams\n   https://open.spotify.com/track/abc123\n\n2. \"Morning Run\" by Fitness Beats\n   https://music.apple.com/track/xyz789\n```\n\n## Search Methods\n\n### 1. Prompt-Based Search\n\nSearch with a natural language description of the music you want.\n\n```bash\ncurl -X POST \"https://api.harmix.ai/search?limit=5\" \\\n  -H \"api_key: v8mWxAGAFTEFcU9NYGGhDWWbzYXS5e\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"prompt\": \"upbeat electronic music for a workout\"}'\n```\n\nFor full documentation, see [references/prompt-search.md](references/prompt-search.md).\n\n### 2. Video-Based Search\n\nFind music that matches video content by analyzing visual frames.\n\n**Requirements**: ffmpeg must be installed.\n\n**Quick steps**:\n1. Extract 5 JPEG frames (226x226) from video at equal intervals (must use `.jpeg` extension)\n2. Upload frames to `/upload` endpoint\n3. Search using the returned `upload_id`\n\n```bash\n# Upload frames (must use .jpeg extension)\ncurl -X POST \"https://api.harmix.ai/upload\" \\\n  -H \"api_key: v8mWxAGAFTEFcU9NYGGhDWWbzYXS5e\" \\\n  -F \"type=manual-video\" \\\n  -F \"source=@frame1.jpeg\" \\\n  -F \"source=@frame2.jpeg\" \\\n  -F \"source=@frame3.jpeg\" \\\n  -F \"source=@frame4.jpeg\" \\\n  -F \"source=@frame5.jpeg\"\n\n# Search with upload_id from response\ncurl -X POST \"https://api.harmix.ai/search?limit=5\" \\\n  -H \"api_key: v8mWxAGAFTEFcU9NYGGhDWWbzYXS5e\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"video_reference\": {\"upload_id\": \"YOUR_UPLOAD_ID\"}}'\n```\n\nFor full documentation, see [references/video-search.md](references/video-search.md).\n\n## Response Format\n\nBoth methods return tracks with title, artists, and streaming URL:\n\n```json\n{\n  \"tracks_number\": 5,\n  \"tracks\": [\n    {\n      \"metadata\": {\n        \"track_title\": \"Track Name\",\n        \"artists\": [\"Artist Name\"],\n        \"extra_parameters\": {\n          \"url\": \"https://open.spotify.com/track/abc123\"\n        }\n      }\n    }\n  ]\n}\n```\n\n## API Limits\n\nThe provided API key has usage limits. If you receive a **403 error with code 4005**, the limit has been reached.\n\n**When limit is reached:**\n1. Request your own API key by contacting support@harmix.ai\n2. Or use the web platform directly at https://web.harmix.ai/\n\n## Scripts\n\n- [scripts/video_search.py](scripts/video_search.py) - CLI tool for video-based music search\n\n## Resources\n\n- [Prompt Search Reference](references/prompt-search.md)\n- [Video Search Reference](references/video-search.md)","tags":["harmix","music","search","skills","agent-skills","agentic-ai","api","media","openclaw","openclaw-skills"],"capabilities":["skill","source-harmix","skill-harmix-music-search","topic-agent-skills","topic-agentic-ai","topic-api","topic-media","topic-music","topic-openclaw","topic-openclaw-skills","topic-search"],"categories":["harmix-skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/Harmix/harmix-skills/harmix-music-search","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add Harmix/harmix-skills","source_repo":"https://github.com/Harmix/harmix-skills","install_from":"skills.sh"}},"qualityScore":"0.456","qualityRationale":"deterministic score 0.46 from registry signals: · indexed on github topic:agent-skills · 13 github stars · SKILL.md body (3,580 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-04-22T13:03:29.221Z","embedding":null,"createdAt":"2026-04-19T00:40:50.808Z","updatedAt":"2026-04-22T13:03:29.221Z","lastSeenAt":"2026-04-22T13:03:29.221Z","tsv":"'/)':57 '/search?limit=5':242,364 '/track/abc123':208,418 '/track/xyz789':217 '/upload':307,328 '1':158,200,220,288,446 '2':163,209,266,303,455 '226x226':293 '3':170,309 '4005':436 '403':432 '5':290,403 'accur':80 'ai':19,51,61 'ai-pow':60 'analysi':92 'analyz':278 'api':20,127,138,141,244,330,366,419,423,450 'api.harmix.ai':241,327,363 'api.harmix.ai/search?limit=5':240,362 'api.harmix.ai/upload':326 'appl':181 'application/json':251,373 'artist':164,167,193,396,410,411 'ask':25 'authent':133 'avail':94 'base':37,223,269,472 'bash':236,316 'beat':214 'boost':202 'catalog':85 'cli':467 'code':435 'contact':453 'content':15,91,125,249,276,371 'content-typ':248,370 'curl':237,323,359 'd':252,374 'deezer':183 'descript':105,230 'direct':461 'discov':32 'discoveri':82 'display':154 'docs.harmix.ai':129 'document':126,128,262,384 'dream':205 'electr':204 'electron':255 'enabl':79 'endpoint':308 'energi':201 'equal':297 'error':433 'etc':110,184 'exampl':197 'extens':302,322 'extra':413 'extract':185,289 'f':333,338,341,344,347,350 'featur':93 'ffmpeg':282 'find':27,43,117,271 'fit':213 'format':145,199,389 'frame':115,280,292,305,318 'frame1.jpeg':340 'frame2.jpeg':343 'frame3.jpeg':346 'frame4.jpeg':349 'frame5.jpeg':352 'free':103 'full':261,383 'genr':107 'h':243,247,329,365,369 'harmix':2,18,50,54 'harmix-music-search':1 'header':140 'id':315,356,378,381 'instal':285 'interv':298 'jpeg':291,301,321 'json':400 'key':139,142,245,331,367,424,451 'label':75 'languag':11,88,229 'larg':84 'limit':420,427,438,443 'link':172 'manual':336 'manual-video':335 'match':120,274 'metadata':405 'metadata.artists':194 'metadata.extra_parameters.url':196 'metadata.track':191 'method':219,391 'mood':106,123 'mood/genre/tempo/scene':39 'morn':210 'movi':72 'music':3,7,28,35,44,52,63,69,81,101,118,182,233,256,272,473 'music.apple.com':216 'music.apple.com/track/xyz789':215 'must':283,299,319 'name':168,409,412 'natur':10,87,228 'need':34 'number':402 'open.spotify.com':207,417 'open.spotify.com/track/abc123':206,416 'output':144,198 'paramet':414 'platform':65,131,460 'post':239,325,361 'power':62 'present':149 'product':68,73 'prompt':12,98,222,253,476 'prompt-bas':221 'provid':422 'publish':77 'quick':286 'reach':441,445 'receiv':430 'recommend':36 'record':74 'refer':376,478,482 'references/prompt-search.md':264,265,479 'references/video-search.md':386,387,483 'request':135,447 'requir':136,281 'resourc':475 'respons':189,358,388 'result':151 'return':313,392 'run':211 'scene':109 'script':464 'scripts/video_search.py':465,466 'search':4,5,29,53,64,99,100,112,150,218,224,225,270,310,353,474,477,481 'see':263,385 'servic':179 'skill':97 'skill-harmix-music-search' 'song':31 'soundtrac':49 'sourc':339,342,345,348,351 'source-harmix' 'spotifi':180 'step':287 'stream':178,398 'support@harmix.ai':454 'tailor':66 'tempo':108 'text':104 'titl':159,162,190,192,395,407 'tool':468 'topic-agent-skills' 'topic-agentic-ai' 'topic-api' 'topic-media' 'topic-music' 'topic-openclaw' 'topic-openclaw-skills' 'topic-search' 'track':8,33,156,161,175,393,401,404,406,408 'tv':70 'type':250,334,372 'upbeat':254 'upload':113,304,314,317,355,377,380 'url':171,195,399,415 'usag':426 'use':9,21,86,102,300,311,320,457 'user':24,147,153 'v8mwxagaftefcu9nygghdwwbzyxs5e':143,246,332,368 'via':16 'video':14,47,48,111,114,268,275,295,337,375,471,480 'video-bas':267,470 'visual':90,122,279 'want':41,235 'web':130,459 'web.harmix.ai':132,463 'workout':259 'www.harmix.ai':56 'www.harmix.ai/)':55 'x':238,324,360","prices":[{"id":"6f967d7d-ddf7-4fce-8ffb-109e5c58d5d9","listingId":"5be62347-c135-4148-8b0d-0a4720e4ed3c","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"Harmix","category":"harmix-skills","install_from":"skills.sh"},"createdAt":"2026-04-19T00:40:50.808Z"}],"sources":[{"listingId":"5be62347-c135-4148-8b0d-0a4720e4ed3c","source":"github","sourceId":"Harmix/harmix-skills/harmix-music-search","sourceUrl":"https://github.com/Harmix/harmix-skills/tree/main/skills/harmix-music-search","isPrimary":false,"firstSeenAt":"2026-04-19T00:40:50.808Z","lastSeenAt":"2026-04-22T13:03:29.221Z"}],"details":{"listingId":"5be62347-c135-4148-8b0d-0a4720e4ed3c","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"Harmix","slug":"harmix-music-search","github":{"repo":"Harmix/harmix-skills","stars":13,"topics":["agent-skills","agentic-ai","ai","api","media","music","openclaw","openclaw-skills","search"],"license":"mit","html_url":"https://github.com/Harmix/harmix-skills","pushed_at":"2026-03-29T10:00:14Z","description":"Search for music tracks using natural language prompts or video content via the Harmix AI API. Use when the user asks to find music, search for songs, discover tracks, needs music recommendations based on mood/genre/tempo/scene, or wants to find music for a video, video soundtrack, or music that matches video content","skill_md_sha":"18ec35767d287fb036b1a6748d2a0318a6af9b9f","skill_md_path":"skills/harmix-music-search/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/Harmix/harmix-skills/tree/main/skills/harmix-music-search"},"layout":"multi","source":"github","category":"harmix-skills","frontmatter":{"name":"harmix-music-search","description":"Search for music tracks using natural language prompts or video content via the Harmix AI API. Use when the user asks to find music, search for songs, discover tracks, needs music recommendations based on mood/genre/tempo/scene, or wants to find music for a video, video soundtrack, or music that matches video content."},"skills_sh_url":"https://skills.sh/Harmix/harmix-skills/harmix-music-search"},"updatedAt":"2026-04-22T13:03:29.221Z"}}