podcast-to-substack

该技能专为播客创作者设计，旨在打通 RSS 订阅源、Notion 知识库与 Substack 发布平台之间的内容流转通道，同时延伸至 LinkedIn 社交媒体推广。通过自动化脚本组合，用户能够从 RSS 抓取最新剧集信息，从 Notion 递归提取播客脚本与配图，生成符合 Substack 平台特性的文章草稿，并同步创建适合 LinkedIn 格式的推广文案。

核心用法围绕六个步骤展开：首先通过 fetch_rss.py 脚本获取 RSS 源中最新 3 期剧集元数据；随后利用 fetch_notion_episode.py 深入遍历 Notion 页面块结构，提取文字内容并下载内嵌图片至本地临时目录；接着基于提取的脚本文本构建 Substack 草稿，严格遵循"非协商规则"——即禁止使用 iframe 或 markdown 链接嵌入播客，而是采用平台原生的 /embed 指令或复制已有成功的嵌入模板，确保 Apple Podcasts 播放器卡片稳定渲染；最后通过 render_linkedin_post.py 将同一内容转换为 LinkedIn 格式的帖子副本，实现一键多平台分发。

显著优点包括工作流的高度自动化，大幅减少手动复制粘贴操作；针对 Substack 嵌入行为的深度优化，有效避免常见的"嵌入变文本"显示故障；Notion 图片的自动抓取与本地存储机制，解决了跨平台图片引用失效问题；以及 LinkedIn 配套内容的智能生成，帮助创作者构建一致的多平台内容策略。此外，技能明确规定了发布规范，确保输出质量稳定。

潜在缺点与局限性主要体现在对外部服务的强依赖性：Notion API 的可用性、RSS 源的稳定性以及 Substack 平台嵌入规则的未来变更都可能影响功能连续性。作为 T3 来源的个人开发者作品，长期维护与更新频率存在不确定性。同时，LinkedIn 的自动化发布可能需要额外的身份验证机制，目前流程中暗示的手动"发布或排队"步骤表明完全自动化可能存在平台限制。

适合使用该技能的目标群体包括独立播客创作者、内容运营团队（特别是 Realist 播客团队）、以及采用 Notion 作为内容中台的多平台发布者。对于希望建立从内容创作到跨平台分发标准化流程的媒体工作者，该技能提供了即插即用的解决方案。

使用过程中的常规风险需关注：API 密钥（Notion API Key）的安全存储与权限管理，虽然技能本身不上传密钥至第三方，但用户需确保本地环境变量或配置文件的安全；RSS feed 的隐私与可靠性，公开的 RSS 源可能被第三方追踪更新频率；图片下载产生的本地存储占用，需定期清理 /tmp/podcast-to-substack-images 目录；以及 Substack 嵌入策略变更导致的模板失效风险，建议持续关注平台更新。

核心功能

podcast-to-substack 是一套面向播客创作者的内容自动化工作流 Skill，专注于解决多平台分发的重复劳动问题。其核心价值在于将 RSS 源、Notion 脚本库、Substack 发布、LinkedIn 推广四个环节串联成标准化流水线。

显著优点

1. 可靠的嵌入机制：针对 Substack 平台特性设计了专门的嵌入策略，明确禁止 iframe 和 markdown 链接方式，强制使用 /embed 命令或复制已有模板，从根本上避免"播放器变文本"的常见错误。

2. Notion 深度集成：支持递归遍历 Notion 页面块结构，自动提取文本脚本和嵌套图片，解决了播客制作中"脚本与素材分散"的痛点。

3. 跨平台内容复用：同一套内容源自动生成 Substack 长文和 LinkedIn 短文案，保持品牌声音一致性。

4. 安全评分优秀：CLS 认证评分 78/A 级，依赖库单一且可信（feedparser），网络请求均为官方 HTTPS 端点，无数据外泄风险。

潜在局限

• 来源可信度 T3：维护者为个人开发者（danielfoch），非企业级背书，建议在生产环境使用前行代码审查。
• 依赖自动安装：使用 subprocess 自动安装 feedparser，某些安全敏感环境可能触发策略警告。
• 输入验证薄弱：RSS URL 由用户自由输入，缺乏协议白名单和域名验证，存在理论 SSRF 风险（需配合用户环境评估）。
• 图片完整性校验缺失：从 Notion 下载的图片仅做 MIME 类型推断，无哈希或签名验证。

适合人群

• 使用 Notion 管理播客脚本的内容创作者
• 需要将播客内容同步发布到 Newsletter 和 LinkedIn 的个人 IP 运营者
• 熟悉命令行工具、具备基础 API 密钥管理经验的用户

常规风险

• 凭证管理：需配置 NOTION_API_KEY，建议存放于 ~/.config/notion/api_key 而非环境变量，避免意外泄露。
• API 配额：Notion API 和 Substack 均有调用频率限制，大批量发布前建议测试。
• 嵌入失效：Apple Podcasts 页面结构变更可能导致嵌入卡片样式异常，建议发布前预览验证。

安全等级

综合评估为 A 级/S 安全等级：功能边界清晰、代码透明、无恶意行为模式，适合受信任环境运行。建议在 CI/CD 或本地受控环境中使用，避免在共享服务器直接暴露执行。