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

# 抖音同步到 Notion 使用指南

NotionHub 可以把当前登录抖音账号的自己发布、收藏和点赞记录同步到 Notion。同步后，你可以在 Notion 中按来源、作者、年、月、周、日检索视频和图集，保留原始链接、封面、发布时间、统计数据和可选上传的媒体文件。

## 快速开始

1. 安装或升级 NotionHub 浏览器插件。
2. 获取抖音同步服务激活码。
3. 复制抖音 Notion 模板并完成授权。
4. 在抖音网页版复制当前账号 Cookie 并保存。
5. 点击「开始同步」。

如果还没有激活码，可以扫描下面的二维码添加微信购买。

<img src="/activation-code-wechat.png" alt="扫码购买 NotionHub 抖音同步激活码" width="320" />

## 同步前须知

- 抖音同步只面向当前登录账号的个人低频同步，不支持任意账号批量采集、评论、直播或自动发布。
- 默认只同步元数据、封面和原始链接，不会默认下载并上传视频或图集文件。
- 媒体上传需要在「同步设置」中开启「上传视频等大文件」，上传会明显增加运行时间。
- 视频或图集下载可能受到抖音登录状态、隐私权限、作品下架、签名链接过期、验证码和风控影响。
- 上传到 Notion 的文件受 Notion 工作区文件大小限制影响，普通 Notion 用户可能无法上传较大的视频文件。
- 抖音同步只支持 NotionHub 提供的模板，不支持自行改造字段结构后的模板。

## 同步内容

| 数据类型    | 同步内容                                         |
| ------- | -------------------------------------------- |
| 视频 / 图集 | 标题、描述、封面、链接、发布时间、媒体类型、时长和统计数据                |
| 来源      | 我的视频、收藏的视频、点赞的视频                             |
| 作者      | 作者名称、作者 ID 和头像                               |
| 时间维度    | 年、月、周、日和全部关系                                 |
| 媒体文件    | 可选上传视频文件或图集图片，已上传文件会记录 Notion File Upload ID |

同一个作品如果同时出现在不同来源中，会按「作品 ID + 来源」分别保存，避免收藏和点赞关系互相覆盖。

## 第一步：打开抖音同步

打开 NotionHub 插件，在服务列表中选择「抖音」。

进入页面后，按顺序完成激活、复制模板、授权 Notion、保存抖音登录态，然后再开始同步。

## 第二步：输入激活码

在「激活服务」步骤中输入抖音同步服务激活码，然后点击激活。

激活成功后，插件会进入 Notion 模板复制和授权流程。激活码只用于绑定当前同步服务，请不要分享给他人。

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

点击插件中的「复制 Notion 模板」按钮。浏览器会跳转到 Notion 授权页面，请选择 NotionHub 提供的抖音模板并完成授权。

授权时需要注意：

- 只支持使用 NotionHub 提供的抖音模板。
- 不要自己新建空页面替代模板，也不要把其他服务模板改造成抖音模板。
- 不要删除模板里的「视频」主数据源，也不要修改「记录 ID」「来源」「作者」「收藏夹」「发布时间」等核心字段。
- 模板复制完成后，可以把整个模板页面移动到自己的 Notion 页面下整理位置，只要不删除数据库、不修改字段结构，就不会影响同步。

## 第四步：保存抖音登录态

点击插件中的「登录抖音」。当前版本使用手动 Cookie 方式：

1. 在浏览器中打开并登录 [https://www.douyin.com/。](https://www.douyin.com/。)
2. 打开浏览器开发者工具，找到 `www.douyin.com` 请求。
3. 复制请求头里的 Cookie。
4. 回到 NotionHub 插件，粘贴 Cookie 并保存。
5. 如果你知道当前账号的 `sec_uid`，也可以一并填写；留空时脚本会尽量从账号资料中补全。

Cookie 相当于网页登录态，请不要公开分享。NotionHub 会把它写入你的 Runner Secret，用于 GitHub Actions 执行同步。

## 第五步：按需开启媒体上传

抖音同步默认只保存元数据和 external 封面。如果你希望把视频或图集文件保存到 Notion，可以进入「同步设置」，开启「上传视频等大文件」。

开启后，同步会先写入元数据，再执行媒体上传阶段。已成功上传并记录 File Upload ID 的作品，后续运行会自动跳过，不会重复上传。

建议先完成一次元数据同步，确认模板和账号正常后，再开启媒体上传。大批量媒体上传更容易遇到 Notion 文件大小限制、网络超时或抖音风控。

## 第六步：开始同步

完成前面的步骤后，点击「开始同步」。

第一次同步可能需要较长时间。后续再次同步时，NotionHub 会根据「记录 ID」更新已有页面，并补充新增发布、收藏或点赞记录。

同步过程中请不要重复点击开始同步。如果插件提示任务正在运行，说明上一次同步还没有结束，可以在 GitHub Actions 或插件运行状态中查看进度。

## 常见问题

### 为什么提示需要重新登录？

通常是 Cookie 失效、账号退出登录、Cookie 不是来自 `www.douyin.com`，或抖音触发了登录校验。请重新打开抖音网页版确认账号已登录，再复制新的 Cookie 保存。

### 为什么同步结果为空？

可能是当前账号没有公开可读取的数据、收藏或点赞列表设为私密、Cookie 与当前账号不匹配，或抖音接口临时风控。可以先确认网页端能正常看到对应列表，再稍后重新运行。

### 媒体文件为什么没有上传？

请确认「同步设置」中已开启「上传视频等大文件」。如果仍未上传，常见原因包括 Notion 文件大小限制、作品已下架、媒体签名链接过期、图集格式不支持或运行时间不足。元数据成功写入时，媒体失败通常可以下次继续补传。

### 会不会重复创建记录？

正常情况下不会。NotionHub 使用「作品 ID + 来源」生成稳定「记录 ID」，重复运行会更新已有页面。如果手动删除「记录 ID」字段内容，可能影响去重判断。

### 可以修改模板字段吗？

可以调整视图和页面位置，但不建议删除数据库、修改字段名称、字段类型或关系字段。字段结构变化可能导致同步失败、关系丢失或重复创建。

## 下一步

- 安装或升级插件：[https://www.notionhub.app/docs/install.html](https://www.notionhub.app/docs/install.html)
- 查看 GitHub Action 同步说明：[https://www.notionhub.app/docs/github-action.html](https://www.notionhub.app/docs/github-action.html)
- 查看媒体上传说明：[https://www.notionhub.app/docs/media-upload.html](https://www.notionhub.app/docs/media-upload.html)
- 遇到问题：[https://www.notionhub.app/docs/support.html](https://www.notionhub.app/docs/support.html)