> 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 Music 同步到 Notion

NotionHub 可以把 Apple Music 系统「喜爱歌曲」歌单中的歌曲，以及关联的歌手、专辑整理到 Notion，方便建立自己的音乐收藏库。

## 可以同步什么

| 内容           | 在 Notion 中查看              |
| ------------ | ------------------------- |
| 系统「喜爱歌曲」中的歌曲 | 歌曲名称、封面、Apple Music 链接和日期 |
| 关联的歌手与专辑     | 歌手、专辑页面，以及与歌曲的关系          |
| 「喜爱歌曲」歌单     | 歌单页面及其歌曲关联                |
| 音频和歌词（可选）    | 在资源可获取、上传成功时，补充到歌曲页面      |

当前同步范围是系统「喜爱歌曲」歌单，不包含整个媒体库或所有自建歌单。仅将一首歌加入资料库，不代表它会进入同步范围；请先在 Apple Music 中将歌曲标记为喜爱，并确认系统歌单中能看到它。

歌曲日期优先使用 Apple 返回的加入日期；新建记录没有该日期时，会使用同步当天。日期和热力图不能用来统计实际播放时间、播放次数或收听时长。

## 使用前准备

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

资料同步以 Apple 网页能够返回账号歌单为前提。音频和歌词下载还需要有效的 Apple Music 订阅及可用的网页登录状态；插件显示「已登录」不代表订阅、播放或下载权限一定有效。NotionHub 服务激活也不包含 Apple Music 订阅。

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

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

如果插件提示提交链接，请提交复制到自己工作区后的模板页面链接。不要使用空白页面替代模板，也不要提交官方模板预览链接。

请保留歌曲、歌手、专辑、歌单及日期相关数据库的字段类型和关系。可以调整视图，更多说明见 [Notion 模板与授权](https://www.notionhub.app/docs/notion-template.md)。

## 第二步：连接 Apple Music

1. 在 Apple Music 账号卡片点击「去登录」。
2. 在打开的 Apple Music 网页中登录日常使用的 Apple 账号，并按浏览器提示允许插件访问相关网站。
3. 打开资料库中的「喜爱歌曲」，刷新网页，必要时播放一首可以正常播放的歌曲，让网页加载账号数据。
4. 返回插件，等待账号卡片显示「已登录」。

只在 iPhone 或 Mac 的音乐 App 中登录，不能替代浏览器中的连接。插件会识别网页登录状态，无需手动复制 Cookie 或 Token。

## 第三步：设置音频和歌词上传

打开「同步设置」，在「媒体文件」中按需开启「上传音频和歌词」。关闭时仍会同步歌曲、歌手、专辑等基础资料；首次使用可以先关闭，确认歌曲正常写入后再开启。

开启后会尝试补充缺失的文件，但并非每首歌曲都能下载：

- Apple Music 订阅及网页登录状态需要有效。
- 曲目需要有可获取的音频和歌词；下架、地区限制或 DRM 保护可能导致无法获取音频。
- 仅有个人云端资料库链接、未对应到 Apple Music 流媒体曲目的歌曲，会跳过音频下载。
- 文件还需符合 Notion 工作区或所用存储的上传限制，参见 [图片、音频和视频上传](https://www.notionhub.app/docs/media-upload.md)。

没有歌词时，页面可能显示暂无歌词的占位内容。播放器或歌曲页面已经出现，也不代表完整音频已经上传成功。

热力图、通知和其它选项以插件实际展示为准，参见 [同步设置](https://www.notionhub.app/docs/sync-settings.md)。

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

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

通过插件的运行记录或对应的 GitHub Action 查看进度；任务未结束时，避免重复点击。运行完成后，打开 Notion 模板，检查歌曲、歌手、专辑以及「喜爱歌曲」歌单之间的关联。开启媒体上传时，还需查看歌曲中的音频、歌词是否已经补齐。

日常同步会识别已存在的歌曲并补充新记录。需要重新检查当前可获取的歌曲资料时，可以在权益允许时使用「全量同步」。全量同步仍只处理「喜爱歌曲」，不会扩大到全部媒体库或恢复 Apple 已不再返回的内容。

在 Apple Music 中取消喜爱，不会自动删除已经写入 Notion 的页面。在 Notion 中编辑歌曲资料，也不会回写 Apple Music。

## 常见问题

### 为什么媒体库里有很多歌，Notion 中却没有？

先检查网页版「喜爱歌曲」中是否能看到这些歌曲。当前只读取该系统歌单，普通资料库歌曲、自建歌单中的歌曲不会因此自动同步。还需确认最近一次运行已完成，并检查体验条数限制。

### 已标记喜爱，仍提示没有找到歌单怎么办？

确认网页登录的是正确账号，并在网页端打开系统「喜爱歌曲」。当前可识别的歌单名称包括「喜爱歌曲」「喜欢的歌曲」「Favorite Songs」「Loved Songs」。如果网页显示其它本地化名称，或没有生成该系统歌单，请联系 [技术支持](https://www.notionhub.app/docs/support.md) 核实，不要用普通自建歌单替代。

### 网页已登录，插件为什么没有识别？

确认网页与插件位于同一个浏览器，并已允许网站访问权限。打开资料库、刷新网页或播放歌曲后回到插件重试；连接失效时点击「重新登录」。只打开公开专辑介绍页，可能没有加载账号数据。

### 有订阅，为什么仍然没有音频或歌词？

有效订阅只是前提。还要检查「上传音频和歌词」是否开启、对应处理是否完成，以及该曲目是否存在可下载资源。个人云端曲目、DRM 限制或上传失败都可能造成文件缺失。此时歌曲资料可能已经同步成功，不能仅凭缺少音频判断基础同步失败。

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