Podcast Substack + LinkedIn

Run this workflow when handling Realist podcast episode publishing.

Inputs

• RSS feed URL
• Notion data source/database ID with episode scripts
• Notion API key (NOTION_API_KEY or ~/.config/notion/api_key)
• Substack publish access

Workflow

• Fetch recent episodes:

python3 scripts/fetch_rss.py "$RSS_URL" 3

• Fetch episode script + images from Notion (recursive block traversal, image downloads included):

python3 scripts/fetch_notion_episode.py "EPISODE_NUMBER"

• Build Substack draft content from script text.
• Publish with stable embed behavior using the playbook in references/substack-embed-playbook.md.
• Generate LinkedIn post copy from the same content:

python3 scripts/render_linkedin_post.py --json-file episode.json

• Post or queue the LinkedIn copy.

Non-negotiable rules

• Do not use iframe code or markdown links for podcast embeds in Substack.
• Prefer duplicating the existing Substack draft template that already has a working embed block.
• If creating a fresh post, use /embed and confirm the player card renders before publishing.
• Use top-level Apple Podcasts show URL for reliable fallback.

References

• Substack embed behavior: references/substack-embed-playbook.md
• LinkedIn formatting: references/linkedin-playbook.md