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:
bashbin/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 ascustom.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.


