recoup-song-placement-pitch

name	recoup-song-placement-pitch
description	Turn one song into placement materials from its audio — a playlist/editorial pitch and a music-supervisor sync brief, grounded in the song's actual sound. Use for "playlist pitch", "pitch to Spotify", "sync brief", or "where could this be placed". Requires a public audio URL. For catalog-wide playlist strategy (no audio) use recoup-research-playlist-targets.

Recoup Song — Placement Pitch

Turn the song into placement materials. Uses Music Flamingo — contract in references/flamingo-api.md (read first). Needs a public audio_url; never put account_id in the body.

Outputs

• Playlist/editorial pitch — a tight pitch matched to playlist/editorial fit, grounded in the song's actual sound (genre/mood/energy from the analysis).
• Sync brief — a music-supervisor-ready brief (mood, themes, instrumentation, comparable cues, clearance-relevant notes) for TV/film/ad placement.

Use sync_brief_match + music_theory + lyric_transcription; ground every claim in the audio analysis, never invent. Save to songs/{song-slug}/pitch/.

For catalog-wide playlist strategy (which playlists, gaps — no single audio file) use recoup-research-playlist-targets instead.

Guardrails

• Audio-grounded only — every claim traces to the Flamingo analysis.
• Public URL required; no account_id in the body.
• Lyrics: don't reproduce third-party copyrighted lyrics.

References

• references/flamingo-api.md — presets + call patterns.