> For AI agents: the complete documentation index is available at https://www.notionhub.app/llms.txt, the full documentation bundle is available at https://www.notionhub.app/llms-full.txt.

# 苹果播客（Apple Podcasts）同步到 Notion

NotionHub 可以将苹果播客中的订阅节目、最近收听进度和保存的单集整理到 Notion。你可以在同一份模板中查看节目和单集、阅读节目说明，并在音源可用时使用播放器。

## 可以同步什么

| 内容       | 在 Notion 中查看                    |
| -------- | ------------------------------- |
| 关注或订阅的节目 | 节目名称、封面、作者和 Apple Podcasts 链接   |
| 最近播放的单集  | 单集标题、所属节目、时长、收听日期、进度和播放状态       |
| 保存的单集    | 单集信息与收藏标记；没有收听记录的单集也可进入模板       |
| 节目说明     | 单集正文中的 shownotes，保留可获取的文字、链接和排版 |
| 语音转文字    | 配置千问后，为符合条件的单集补充转写、AI 总结和思维导图   |

收听进度来自 Apple 网页当前提供的最近播放记录。同步会读取可用分页并保留已同步的旧记录，但不能保证导入账号的全部历史收听记录，也不会因为订阅一个节目就导入该节目的全部单集。

## 使用前准备

- 安装最新版 [NotionHub 浏览器插件](https://www.notionhub.app/docs/install.md)，并登录 NotionHub。
- 准备能正常登录 [Apple Podcasts 网页版](https://podcasts.apple.com/) 的 Apple 账号。
- 使用插件提供的苹果播客 Notion 模板，并允许 NotionHub 访问。
- 按插件提示连接 GitHub，用于运行同步任务，参见 [GitHub Action 同步](https://www.notionhub.app/docs/github-action.md)。
- 确认服务有可用的体验次数或已激活，具体范围以插件显示为准，参见 [免费体验与激活](https://www.notionhub.app/docs/free-trial.md)。

## 第一步：打开苹果播客服务

打开 NotionHub 插件，在服务列表中选择「Apple Podcasts」。如果找不到入口，先更新插件，再重新打开服务列表。

## 第二步：复制模板并授权 Notion

1. 在「Notion 模板」卡片点击「去复制」（部分页面显示「复制 Notion 模板」），打开官方模板。
2. 将模板复制到自己的 Notion 工作区。
3. 回到插件点击「授权 Notion」，选择刚复制的模板并允许访问。
4. 打开复制后的模板，在 Notion 页面右上角菜单中选择「拷贝链接」。
5. 回到插件，使用「提交复制后的模板链接」入口，粘贴链接并点击「提交」。

复制模板、授权访问和提交模板链接是三个步骤。请提交自己工作区里的模板链接，不要提交官方模板的预览链接。

完成后，使用「打开 Notion 模板」确认打开的是自己的模板。可以移动模板页面或调整视图，但请保留数据库、字段名称、字段类型和关系。更多说明见 [Notion 模板与授权](https://www.notionhub.app/docs/notion-template.md)。

## 第三步：连接 Apple Podcasts

1. 在 Apple Podcasts 账号卡片点击「去登录」。
2. 在打开的 Apple Podcasts 网页中，登录日常收听播客使用的 Apple 账号。
3. 登录后打开资料库、刷新网页，或播放一个单集，让网页加载账号数据。
4. 返回插件，等待账号卡片显示「已登录」。

请在安装 NotionHub 的同一个浏览器中操作。只在 iPhone 或 Mac 的播客 App 中登录，不能替代浏览器中的账号连接。

账号连接由插件识别网页登录状态完成，无需手动复制 Cookie 或 Token。

## 第四步：配置千问转写

如果需要将单集音频转换成文字，在「千问」账号卡片点击「去登录」，按页面提示完成登录。已经在 NotionHub 小宇宙服务中连接的千问账号可以共用。

转写需要有效的千问登录状态、可获取的音频和完整模板。节目说明与单集基本信息会先写入，转写、总结、思维导图和可用逐字稿随后补充；处理时间取决于音频长度和千问的处理进度。

没有可用音源或音频超过 5 小时的单集会跳过转写。体验次数与转写额度以插件提示为准。逐字稿并非每个单集都能立即生成。

## 第五步：开始同步并查看结果

完成模板、Apple Podcasts 账号和 GitHub 连接后，点击「开始同步」。如果出现激活提示，按提示完成体验或激活配置。

同步启动后，通过插件的运行记录查看进度，也可以进入 GitHub Action 查看对应任务。任务未结束时，避免重复点击同步。

打开 Notion 模板，可以分别查看：

- **播客库**：节目、作者、封面和来源链接。
- **单集库**：最近收听和保存的单集，以及播放进度、状态和收藏信息。
- **单集正文**：播放器、shownotes，以及已经处理完成的转写内容。

后续同步会按单集标识更新已有记录。已保存单集不在最近播放列表中时，不会把已知收听进度清零。自动同步和通知选项可在「同步设置」中查看。

## 常见问题

### 网页已登录，插件仍未识别怎么办？

确认 Apple Podcasts 网页与插件位于同一个浏览器中，并允许插件访问对应网站。在网页中打开资料库、刷新或播放一个单集，再回到插件重试连接。只打开公开节目介绍页，可能没有触发账号数据加载。

### 为什么只看到部分收听记录？

先确认网页端登录的是正确账号，并检查网页里能否看到对应单集。Apple 网页只提供可用的最近播放和保存记录，无法保证返回全部历史。全量同步也无法找回 Apple 已不再提供的历史记录。

如果正在免费体验，还需检查插件显示的同步条数限制。

### 单集已有数据，为什么还没有逐字稿或思维导图？

单集基础数据与转写分阶段处理。先查看运行记录，确认转写是否仍在处理中，再检查千问账号是否有效、单集是否有可用音频，以及模板中的思维导图等数据库是否保留。处理尚未完成时，可等待后续同步继续补充。

### 提示需要重新登录或模板未就绪怎么办？

账号失效时，在对应账号卡片点击「重新登录」，完成网页登录后再同步。

模板未就绪时，确认授权的是自己的苹果播客模板，并重新提交复制后的页面链接。不要用空白页面代替模板，也不要删除数据库或修改同步需要的字段类型。

仍有问题时，查看 [运行状态与排错](https://www.notionhub.app/docs/sync-status.md) 或联系 [技术支持](https://www.notionhub.app/docs/support.md)。