podcast-to-substack
by danielfoch
Browser & AutomationBrief
Publish podcast episodes from RSS + Notion to Substack with reliable Apple Podcasts embedding and image extraction.
Description
What This Skill Does
Automates publishing podcast episodes from RSS and Notion to Substack, with reliable Apple Podcasts embedding. Also generates LinkedIn companion posts from the same episode content.
Handles the specific embed fragility in Substack that causes podcast players to render as plain text instead of interactive cards.
When to Use It
- Publishing a new podcast episode to Substack after it drops
- Pulling episode scripts and images out of Notion for a post draft
- Fixing broken or text-only podcast embeds in Substack
- Cross-posting episode summaries to LinkedIn without rewriting
- Keeping a consistent publishing workflow across RSS, Notion, and Substack
Example Workflow
User asks: publish episode 42 of the Realist podcast to Substack and generate a LinkedIn post
- 1
Fetch recent episodes from the RSS feed using fetch_rss.py
- 2
Retrieve episode 42 script and images from Notion via recursive block traversal
- 3
Build Substack draft content from the script text
- 4
Publish to Substack using the embed playbook to ensure the Apple Podcasts player card renders correctly
- 5
Run render_linkedin_post.py to generate formatted LinkedIn copy from the episode JSON
Substack post published with working podcast embed, LinkedIn post copy ready to paste or queue
Requirements
- NOTION_API_KEY environment variable or key stored at ~/.config/notion/api_key
- Substack account with publish access
- Notion database ID containing episode scripts
Installation
clawhub install danielfoch/podcast-to-substackRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.