Logo

1. Resolving Song Identity & DNA

The foundational workflow for tracking specific released tracks.

  • Chema Rodriguez
    Author
    by Chema Rodriguez
    17 days ago

    • The Anatomy of a Track

    Before you can analyze a song’s performance, your Agent must locate its unique identity in the database.

    Tool: song_identity_resolver

    Description: This is the essential first step. It resolves a song's Chatmu UUID by querying an ISRC code, a platform-specific ID (like a Spotify track link), or by matching a song title against an artist's catalog.

    Tool: get_released_song_metadata

    Description: Once you have the song_uuid, this tool extracts the track's DNA. It retrieves the technical metadata (ISRC, Label), Spotify Audio Features (Acousticness, Danceability, etc.), and AI-driven lyric analysis. Strict Rule: This is only for already released tracks, not raw audio files.

    Tool: get_song_performance_and_charts

    Description: Retrieves the song's current performance metrics (streams, popularity) and its historical presence in official charts across major platforms like Apple Music, Deezer, and YouTube.