> 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.

# Spotify 同步到 Notion

NotionHub 可以把 Spotify 中喜欢的歌曲、歌单曲目以及关联的艺人和专辑整理到 Notion，方便建立音乐收藏库。你也可以在同步设置中选择播客模块，保存关注的节目和可获取的单集信息。

## 可以同步什么

| 内容         | 在 Notion 中查看            |
| ---------- | ----------------------- |
| 喜欢的歌曲      | 歌曲名称、封面、Spotify 链接和收藏日期 |
| 歌单与曲目      | 歌单信息，以及歌曲与歌单的关联         |
| 艺人与专辑      | 歌曲对应的艺人、专辑和关联信息         |
| 播客（选择该模块后） | 关注的节目，以及这些节目中可获取的部分单集   |

音乐日期来自加入收藏或歌单的时间。音乐热力图用于查看收藏分布，不代表实际播放日期、播放次数或收听时长。

播客模块目前读取关注节目中的部分单集，普通同步默认每个节目读取最多 10 集，体验同步还受体验额度限制。它不是完整的收听历史或全部已保存单集备份；单集日期也可能使用发布日期。

## 使用前准备

- 安装最新版 [NotionHub 浏览器插件](https://www.notionhub.app/docs/install.md)，并登录 NotionHub。
- 确认在安装插件的同一个浏览器中，可以打开并登录 [Spotify 网页版](https://open.spotify.com/)。
- 准备自己的 Notion 工作区，使用插件提供的 Spotify 模板。
- 按插件提示连接 GitHub，用于运行同步任务，参见 [GitHub Action 同步](https://www.notionhub.app/docs/github-action.md)。
- 确认服务有可用的体验次数或已激活，具体范围以插件显示为准，参见 [免费体验与激活](https://www.notionhub.app/docs/free-trial.md)。

当前通过 Spotify 网页登录状态连接账号，无需自行创建 Spotify 开发者应用，也无需手动复制 Cookie。

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

1. 打开 NotionHub 插件，在服务列表中选择「Spotify」。
2. 在「Notion 模板」卡片点击「去复制」。
3. 在 Notion 授权页面选择开发者提供的模板，确认工作区并允许访问。
4. 返回插件，等待模板显示已配置，再点击「打开模板」确认页面。

如果要继续使用已有的 Spotify 模板，在授权页选择原模板；如果插件提示提交链接，打开自己工作区里的模板，复制页面链接后提交。

可以调整模板视图或移动整个模板页面，但请保留数据库、字段名称、字段类型和关系。更多说明见 [Notion 模板与授权](https://www.notionhub.app/docs/notion-template.md)。

## 第二步：连接 Spotify 账号

1. 在 Spotify 账号卡片点击「去连接」。
2. 浏览器请求访问 Spotify 网站时，允许该权限。
3. 在打开的 Spotify 网页版中登录日常使用的账号。
4. 返回插件，等待显示账号信息和「已登录」。如果还未连接成功，在网页确认登录完成后再重试。

只在手机或桌面 Spotify App 中登录，不能替代浏览器中的连接。连接后请核对插件显示的账号，避免同步到另一账号的收藏。

## 第三步：选择同步范围

打开「同步设置」，按需要选择「音乐」或「播客」，并调整同步顺序。只需要整理音乐收藏时，可以只选择「音乐」。

选择播客模块时，模板也需要保留对应的播客和单集数据库。如果出现模板不完整提示，先检查授权与模板结构，再重新同步。

热力图、通知和其它选项以插件实际展示为准。首次使用建议先保持默认设置，确认基础数据同步成功后再调整。

## 第四步：开始同步

完成模板与 Spotify 连接后，点击「开始同步」。如果提示连接 GitHub，点击「连接 GitHub」并完成授权，再按提示继续。

第一次同步会读取所选范围中的数据，收藏或歌单较多时需要更长时间。同步启动后，可以在插件的运行记录中查看进度，也可以打开对应的 GitHub Action。任务未结束时，避免重复点击同步。

默认每天北京时间 00:00 自动同步，也可以手动运行。自动同步需要账号连接有效、GitHub 配置完整且服务权益可用；当前计划以插件显示为准。

## 第五步：查看与维护数据

打开 Notion 模板，查看歌曲、歌单、艺人和专辑之间的关联；如果选择了播客模块，也可以查看节目与单集。

后续同步会识别已存在的记录，新增或更新数据。需要重新检查当前可获取的数据时，可使用「全量同步」；该功能是否可用取决于服务权益，运行结束后恢复日常增量同步。

全量同步仍受 Spotify 返回范围限制，不能补回平台没有提供的历史记录。在 Spotify 中取消收藏或将歌曲移出歌单，也不会自动删除已经写入 Notion 的页面。NotionHub 的同步方向是 Spotify 到 Notion，在 Notion 中编辑记录不会回写 Spotify。

## 常见问题

### 网页已经登录，插件为什么仍提示连接失败？

确认网页登录发生在安装 NotionHub 的同一个浏览器中，并且已允许插件访问 Spotify 网站。刷新 Spotify 网页，确认能看到自己的媒体库，再返回插件点击「去连接」或「重新登录」。

### 提示登录失效或账号切换后如何更新？

先在 Spotify 网页版登录目标账号，再回到插件点击「重新登录」，核对显示的账号后重新同步。

如需暂停后续自动同步，可以点击「断开连接」。断开不会删除已经同步到 Notion 的页面；恢复使用时重新连接即可。

### 为什么有些歌曲或歌单没有同步？

依次检查账号是否正确、是否选择了「音乐」模块、最近一次运行是否完成，以及是否受到体验条数限制。已下架、不可访问或平台未返回的曲目可能无法同步。

确认配置正常后，可以在权益允许时尝试全量同步。若仍有遗漏，保留运行时间和错误提示，参考 [运行状态与排错](https://www.notionhub.app/docs/sync-status.md)。

### 为什么没有播放次数、收听时长或全部播客单集？

当前音乐同步以收藏和歌单为主，不提供完整播放历史。播客模块读取关注节目的有限单集，日期可能是发布日期，不能据此统计真实收听时长。全量同步也不会突破这些范围。

### 会自动删除 Notion 中已取消收藏的歌曲吗？

不会。取消收藏或移出歌单后，已有 Notion 页面仍会保留，也不要把它理解为与 Spotify 完全一致的实时镜像。如果需要整理旧记录，可以在 Notion 中自行分类。

仍有问题时，查看 [第三方平台登录方式](https://www.notionhub.app/docs/service-login.md) 或联系 [技术支持](https://www.notionhub.app/docs/support.md)。