Harmix music search

Skill Harmix/harmix-skills/skills/harmix-music-search

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

Install

npx -y skills add Harmix/harmix-skills --skill harmix-music-search

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

14 stars14 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

SKILL.md

3.9 KB, as published. Nobody here has run it

Harmix AI Music Search

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

Features Available in This Skill

Prompt Search: Search music using free text descriptions (mood, genre, tempo, scene, etc.)
Video Search: Upload video frames to find music that matches the visual mood and content

Documentation

API Documentation: https://docs.harmix.ai/
Web Platform: https://web.harmix.ai/

Authentication

All requests require the api_key header:

api_key: v8mWxAGAFTEFcU9NYGGhDWWbzYXS5e

Output Format for Users

When presenting search results to users, display each track with:

Title: The track title
Artist(s): The artist name(s)
URL: Link to the track on its streaming service (Spotify, Apple Music, Deezer, etc.)

Extract these from the response:

Title: metadata.track_title
Artists: metadata.artists
URL: metadata.extra_parameters.url

Example output format:

1. "Energy Boost" by Electric Dreams
   https://open.spotify.com/track/abc123

2. "Morning Run" by Fitness Beats
   https://music.apple.com/track/xyz789

Search Methods

1. Prompt-Based Search

Search with a natural language description of the music you want.

curl -X POST "https://api.harmix.ai/search?limit=5" \
  -H "api_key: v8mWxAGAFTEFcU9NYGGhDWWbzYXS5e" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "upbeat electronic music for a workout"}'

For full documentation, see references/prompt-search.md.

2. Video-Based Search

Find music that matches video content by analyzing visual frames.

Requirements: ffmpeg must be installed.

Quick steps:

Extract 5 JPEG frames (226x226) from video at equal intervals (must use .jpeg extension)
Upload frames to /upload endpoint
Search using the returned upload_id

# Upload frames (must use .jpeg extension)
curl -X POST "https://api.harmix.ai/upload" \
  -H "api_key: v8mWxAGAFTEFcU9NYGGhDWWbzYXS5e" \
  -F "type=manual-video" \
  -F "[email protected]" \
  -F "[email protected]" \
  -F "[email protected]" \
  -F "[email protected]" \
  -F "[email protected]"

# Search with upload_id from response
curl -X POST "https://api.harmix.ai/search?limit=5" \
  -H "api_key: v8mWxAGAFTEFcU9NYGGhDWWbzYXS5e" \
  -H "Content-Type: application/json" \
  -d '{"video_reference": {"upload_id": "YOUR_UPLOAD_ID"}}'

For full documentation, see references/video-search.md.

Response Format

Both methods return tracks with title, artists, and streaming URL:

{
  "tracks_number": 5,
  "tracks": [
    {
      "metadata": {
        "track_title": "Track Name",
        "artists": ["Artist Name"],
        "extra_parameters": {
          "url": "https://open.spotify.com/track/abc123"
        }
      }
    }
  ]
}

API Limits

The provided API key has usage limits. If you receive a 403 error with code 4005, the limit has been reached.

When limit is reached:

Request your own API key by contacting [email protected]
Or use the web platform directly at https://web.harmix.ai/

Scripts

scripts/video_search.py - CLI tool for video-based music search