抖音同步到 Notion 使用指南
NotionHub 可以把当前登录抖音账号的自己发布、收藏和点赞记录同步到 Notion。同步后，你可以在 Notion 中按来源、作者、年、月、周、日检索视频和图集，保留原始链接、封面、发布时间、统计数据和可选上传的媒体文件。
快速开始
- 安装或升级 NotionHub 浏览器插件。
- 获取抖音同步服务激活码。
- 复制抖音 Notion 模板并完成授权。
- 在抖音网页版复制当前账号 Cookie 并保存。
- 点击「开始同步」。
如果还没有激活码，可以扫描下面的二维码添加微信购买。
同步前须知
- 抖音同步只面向当前登录账号的个人低频同步，不支持任意账号批量采集、评论、直播或自动发布。
- 默认只同步元数据、封面和原始链接，不会默认下载并上传视频或图集文件。
- 媒体上传需要在「同步设置」中开启「上传视频等大文件」，上传会明显增加运行时间。
- 视频或图集下载可能受到抖音登录状态、隐私权限、作品下架、签名链接过期、验证码和风控影响。
- 上传到 Notion 的文件受 Notion 工作区文件大小限制影响，普通 Notion 用户可能无法上传较大的视频文件。
- 抖音同步只支持 NotionHub 提供的模板，不支持自行改造字段结构后的模板。
同步内容
同一个作品如果同时出现在不同来源中，会按「作品 ID + 来源」分别保存，避免收藏和点赞关系互相覆盖。
第一步：打开抖音同步
打开 NotionHub 插件，在服务列表中选择「抖音」。
进入页面后，按顺序完成激活、复制模板、授权 Notion、保存抖音登录态，然后再开始同步。
第二步：输入激活码
在「激活服务」步骤中输入抖音同步服务激活码，然后点击激活。
激活成功后，插件会进入 Notion 模板复制和授权流程。激活码只用于绑定当前同步服务，请不要分享给他人。
第三步：复制 Notion 模板并授权
点击插件中的「复制 Notion 模板」按钮。浏览器会跳转到 Notion 授权页面，请选择 NotionHub 提供的抖音模板并完成授权。
授权时需要注意：
- 只支持使用 NotionHub 提供的抖音模板。
- 不要自己新建空页面替代模板，也不要把其他服务模板改造成抖音模板。
- 不要删除模板里的「视频」主数据源，也不要修改「记录 ID」「来源」「作者」「收藏夹」「发布时间」等核心字段。
- 模板复制完成后，可以把整个模板页面移动到自己的 Notion 页面下整理位置，只要不删除数据库、不修改字段结构，就不会影响同步。
第四步：保存抖音登录态
点击插件中的「登录抖音」。当前版本使用手动 Cookie 方式：
- 在浏览器中打开并登录 https://www.douyin.com/。
- 打开浏览器开发者工具，找到
www.douyin.com请求。 - 复制请求头里的 Cookie。
- 回到 NotionHub 插件，粘贴 Cookie 并保存。
- 如果你知道当前账号的
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
- 查看 GitHub Action 同步说明：https://www.notionhub.app/docs/github-action.html
- 查看媒体上传说明：https://www.notionhub.app/docs/media-upload.html
- 遇到问题：https://www.notionhub.app/docs/support.html