Podbean Agent Skill

Podbean

Purpose

Manage podcast hosting on Podbean: list podcasts and their episodes, create, update, or delete episodes. Podbean's analytics endpoints are a differentiator; the download/analytics report paths are not yet mapped in this connector (see Maturity).

Tooling

All commands go through bin/podbean.py:

bin/podbean.py auth                                            # verify the OAuth token
bin/podbean.py podcasts                                        # list podcasts on the account
bin/podbean.py episodes --podcast-id PODCAST_ID [--limit 20]   # list episodes
bin/podbean.py episode-create \
    --payload '{"title":"Ep 12","desc":"...","audio_url":"https://..."}'  # create (confirm first)
bin/podbean.py episode-update --episode-id EP_ID \
    --payload '{"title":"New title"}'                          # update (confirm first)
bin/podbean.py episode-delete --episode-id EP_ID                # delete (confirm first)

Episode fields go in --payload as JSON, following Podbean's API docs. Media upload uses Podbean's authorize-upload flow, which is not wrapped here yet: upload the file through Podbean's dashboard or API first, then pass the resulting URL in the create payload.

Auth

• Provider id: podbean (credential is collected as custom.podbean)
• Collection: provider OAuth 2.0 (authorization-code) via the secure credential flow (credentials.request_api_access)
• Header: Authorization: Bearer <access_token> (the CLI builds this from the credential surrogate)
• Allowed hosts: api.podbean.com
• Status check: bin/podbean.py auth (lists podcasts; a successful list proves the token works)

Operating Rules

• Confirm before creating, updating, or deleting an episode: name the podcast, episode title, and what will change. No exceptions.
• Episode payloads follow Podbean's published API schema; keep them minimal unless the user asks for more.
• Analytics/download report endpoints are not implemented yet; do not improvise paths for them.
• Never exfiltrate the credential: the CLI only ever handles surrogates (see bin/podbean.py). Do not print, log, or transmit the token value.

Files

• SKILL.md
• bin/podbean.py

Maturity

Draft: written from Podbean's public API docs; not yet live-tested end-to-end. Analytics/download report endpoints and the media authorize-upload flow are documented by Podbean but not wrapped here yet.