Playlist to Metal Prompts

A small zero-dependency TypeScript/JSDoc CLI that converts authorized Spotify playlist metadata into original, Suno-ready metal prompt briefs in JSON and CSV.

It intentionally does not scrape lyrics, copy melodies, download audio, or imitate a named artist's voice. Titles and metadata are used only as high-level seeds for new material.

Quick start

npm test
node cli.mjs --input playlist.json --out output

For a public Spotify playlist, create Spotify developer client credentials and use the canonical playlist URL:

npm run build
node cli.mjs \
  --spotify-url "https://open.spotify.com/playlist/PLAYLIST_ID" \
  --client-id "$SPOTIFY_CLIENT_ID" \
  --client-secret "$SPOTIFY_CLIENT_SECRET" \
  --out output

Short spotify.link or Spotify Jam/social-session links must first be opened in Spotify and copied as a canonical open.spotify.com/playlist/... URL. Client credentials stay local and are never written to output.

Input format

{
  "name": "Playlist name",
  "tracks": [
    {
      "title": "Track title",
      "artists": ["Artist"],
      "album": "Album",
      "genres": ["rock"],
      "tempoBpm": 120
    }
  ]
}

Output

• suno-prompts.json: structured prompt briefs.
• suno-prompts.csv: spreadsheet-friendly version.

Every row contains an explicit originality guardrail and a lyric brief that forbids quoting or paraphrasing existing lyrics.