| name | spotify-creators |
| description | Upload, list, and manage podcast episodes on Spotify for Creators via CDP-attached browser automation. Spotify has no public upload API, so this skill drives the web UI under your signed-in account — same pattern as the suno skill. |
| metadata | {"clawdbot":{"emoji":"🎙️","requires":["node","browser-automate daemon"],"credentials":"none at the skill level — sign in to creators.spotify.com in your daily Chrome (or the daemon profile) and the daemon inherits the session"}} |
Spotify for Creators
Per-episode podcast upload automation. Spotify (formerly Anchor / Spotify for Podcasters) does not offer a public API for creator-side operations. This skill drives the creators.spotify.com UI via browser-automate + CDP attach to your real Chrome session.
If you own the RSS feed instead (self-hosted or Transistor/Buzzsprout/Libsyn/etc.), prefer that path — submit the feed URL to Spotify once and let them auto-ingest. This skill is for when Spotify is your RSS source.
Install
cd ~/clawd/skills/spotify-creators
pnpm install
pnpm run build
Requires browser-automate installed at ~/clawd/skills/browser-automate/ (auto-invoked).
Prerequisites
- Sign in to
creators.spotify.com in your daily Chrome. The browser-automate daemon seeds from ~/.config/google-chrome/Default on first start and inherits the session.
browser-automate daemon — auto-started when you call any spotify-creators verb.
Verbs
show-list — list shows you own
spotify-creators show-list
episode-list --show-id <id>
spotify-creators episode-list --show-id <id> [--limit 50] [--output episodes.json]
episode-upload
spotify-creators episode-upload \
--show-id <id> \
--audio ./full.mp3 \
--title "Episode 8 - Becoming the Mentor" \
--description "Assalamu alaikum — this week..." \
[--description-file ./description.md] \
[--art ./thumb.jpg] \
[--publish-date 2026-04-22] \
[--season 1] [--episode 8] \
[--episode-type full|trailer|bonus] \
[--schedule | --draft] \
[--explicit] \
[--dry-run]
On success: stdout JSON includes episodeId, episodeUrl, state (published | scheduled | draft).
Output
{
"ok": true,
"state": "published",
"episodeUrl": "https://creators.spotify.com/pod/show/<id>/episode/<epid>",
"episodeId": "<epid>"
}
How it works
- Skill shells out to
browser-automate run --recipe-file <temp>.mjs.
- Recipe attaches to daemon Chrome via CDP.
- Recipe navigates to
creators.spotify.com/pod/dashboard/episode/wizard (tries several URL variants because Spotify has shifted them multiple times).
- For upload: waits for the file-input selector, uploads MP3, waits for the "Next" button to become enabled, fills title + description + art + episode metadata, then clicks Publish/Schedule/Save-as-draft per flags.
- Captures the final URL to extract the episode ID.
Known fragility
- Selector drift. Spotify redesigns their upload UI periodically. When selectors break, run with
BROWSER_AUTOMATE_HEADFUL=1 (via daemon config) and watch what the real UI does, then update the selector arrays in src/cli.ts > writeEpisodeUploadRecipe().
- Error screenshots saved at
/tmp/browser-automate/spotify-creators-*/<timestamp>/error-*.png on failure.
- Metadata fields: episode-type, season/episode number, explicit toggle — these live behind varying selectors. They'll be attempted; failures are logged to stderr but don't abort the upload. Verify in the UI after.
Roadmap
episode-delete --episode-idepisode-update --episode-id (change metadata post-publish)show-update (show-level settings)- Direct HTTP — when we capture the internal endpoints + auth flow, swap from DOM-driving to authenticated HTTP calls. The
bearerCaptured hook in the recipes is there to grab the token the first time we see it.
Related
- [[Spotify for Creators API]] — vault-facing doc (verb contract)
- [[Browser Automation for Services Without APIs]] — the general pattern
- [[Suno API]] — identical shape, different service
