> 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 中查看             |
| --------- | ------------------------ |
| 本人发布的微博   | 原创与转发微博、正文、作者、发布时间和原文链接  |
| 收藏的微博     | 当前账号收藏列表中可获取的微博，标记「收藏」来源 |
| 长微博与转发上下文 | 可获取的长正文，以及被转发微博的作者、内容和链接 |
| 话题与互动数量   | 可获取的话题、点赞数、评论数和转发数       |
| 图片与视频     | 正文中的可用媒体，以及上传成功的附件       |

**当前不采集「我赞过的微博」列表，也不采集评论区正文、本人评论列表、私信或关注信息流。** 记录中的「点赞数」「评论数」是该微博的互动数量，不代表同步了点赞列表或评论内容。

日期按微博的发布时间整理；收藏的微博也使用原微博的发布时间，不代表收藏发生的时间。

## 使用前准备

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

微博入口位于插件服务列表。若找不到，先核对安装版本并更新插件。

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

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

继续使用旧模板时，在授权页选择自己的原模板。如果插件要求提交链接，提交自己工作区里的微博模板页面链接。

保留微博数据库中的标题、链接、正文、收录类型和日期等字段及关系。尤其不要删除或改写「链接」字段，它用于识别同一条微博。可以调整视图、筛选和排序，更多说明见 [Notion 模板与授权](https://www.notionhub.app/docs/notion-template.md)。

## 第二步：连接微博账号

1. 在微博账号卡片点击「去登录」。
2. 允许插件请求的微博网站访问权限。
3. 在打开的微博官网完成登录与安全验证，确认可以访问自己的主页和收藏。
4. 返回插件，核对显示的昵称和账号状态，等待显示「已登录」。

插件通过当前浏览器的网页登录状态连接账号，无需手动复制 Cookie。只在手机微博 App 中登录不能完成连接。

需要更换账号或更新失效登录时，点击「重新登录」，按提示在官网完成操作，再核对插件中的账号。开始同步前还会检查网页登录状态，所以浏览器切换到另一个微博账号后，应先重新连接。

## 第三步：检查同步设置

首次使用可以保留默认设置。当前同步统一读取本人发布和收藏，不需要选择额外模块，也没有点赞列表或评论内容的同步开关。

可在「同步设置」中查看通知等可用选项。图片和视频随微博记录处理，当前微博页面没有单独的「上传视频等大文件」开关。

默认每天自动同步一次，也可以手动运行。自动同步需要有效的账号连接、完整的 GitHub 配置和可用的服务权益，具体安排以插件显示为准。

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

完成模板与账号连接后，点击「开始同步」。如提示连接 GitHub，点击「连接 GitHub」并按引导完成授权。

在插件运行记录或对应的 GitHub Action 中查看结果。任务未结束时，避免重复点击同步。完成后打开 Notion 模板，检查：

- **收录类型**：区分「本人发布」与「收藏」。
- **微博正文**：查看文字、转发上下文和可用媒体。
- **链接与附件**：返回原微博核对内容，查看哪些媒体已经保存。
- **同步状态**：若标记「部分完成」，优先检查媒体是否上传成功。

同步按原文链接识别已有记录。同一条微博同时出现在本人发布和收藏列表中时会合并来源，不会按来源各建一页。后续运行会更新读取到的记录属性，但不会每次重新读取所有历史长正文或重建已有页面正文。

## 历史数据与媒体限制

普通同步在连续遇到已同步记录后会提前结束。需要检查较早记录时，可以在权益允许的情况下点击「全量同步」。全量同步会扩大历史检查范围，但仍受单次分页上限、账号可见范围和微博访问限制影响；运行成功不等于账号所有历史都已备份。

图片和视频会尝试保存为 Notion 文件。无法上传时，新建页面会保留可获取的外部媒体链接，并可能标记「部分完成」。这些外部链接可能失效，文件是否可保存也受到 Notion 工作区限制。详情见 [图片、音频和视频上传](https://www.notionhub.app/docs/media-upload.md)。

普通同步和「全量同步」不会因为微博被删除或取消收藏而自动删除已有 Notion 页面。在 Notion 中编辑内容也不会回写微博。

## 常见问题

### 已登录微博，为什么插件还提示登录失败？

确认微博与插件在同一个浏览器中，已允许网站访问权限，并在官网完成安全验证。返回插件重新点击「去登录」或「重新登录」。如果提示账号不一致，先核对官网当前账号，再更新连接。

### 为什么刚收藏的一条旧微博没有出现？

先检查账号和最近运行结果。体验同步会限制条数，并优先保留发布时间较新的候选微博；较早发布、刚刚收藏的微博可能没有进入本次体验结果。完整同步仍以微博当前可返回的收藏列表为准。

### 为什么点赞数有数据，却找不到我点过赞的微博？

点赞数是已收录微博的统计信息。「我赞过的微博」不在当前同步范围中，全量同步也不会增加这个来源。

### 遇到安全验证、访问频率限制或媒体缺失怎么办？

安全验证需要先在微博官网完成。访问频率受限时，稍后再试，避免反复启动全量同步。若只有媒体缺失，先确认文字和原文链接已经写入，再检查附件状态及原媒体是否仍可访问。

模板提示未就绪时，重新检查授权页面与模板结构。仍有问题时，查看 [运行状态与排错](https://www.notionhub.app/docs/sync-status.md) 或联系 [技术支持](https://www.notionhub.app/docs/support.md)。