#X 收藏导入到 Notion

NotionHub 可以把公开的 X（Twitter）帖子和你主动选择的本地收藏文件导入 Notion。这个功能不登录 X 账号，不读取 X Cookie，也不使用付费 X API。

X 不允许通过网页内部接口自动抓取或模拟浏览器操作，因此本功能不提供自动书签轮询、后台翻页或定时抓取。每次导入都由你在插件中主动发起。

#使用前准备

• 安装最新版 NotionHub 浏览器插件并登录 Notion。
• 在插件的服务列表中打开「X 收藏」。
• 复制「X 收藏库」模板，并通过独立的 NotionHub X 连接完成 Notion 授权。
• 免费体验可以成功写入 20 条唯一帖子；已激活用户不限制条目数。

X 导入不需要连接 GitHub Runner，也不会创建 GitHub Action、Python 或 n8n 任务。

#模板内容

Post ID 用于去重。请不要删除或改名模板中的 Post ID、原文链接和作者关系字段。你可以调整视图或增加自己的属性；重复导入时，NotionHub 不覆盖你手工修改的帖子标题、标签和页面正文。

#保存当前帖子

1. 在浏览器打开一个公开的 x.com 或 twitter.com 帖子页面。
2. 点击 NotionHub 扩展图标。
3. 插件只读取当前标签页 URL，并打开「X 收藏」页面。
4. 确认链接后点击「保存当前帖子」。

插件不会向 X 页面注入采集脚本。Worker 在 Queue 中通过 X 官方免鉴权 oEmbed 接口读取该公开帖子的正文、作者、发布时间和原文链接；oEmbed 返回的脚本不会执行或保存。遇到 429、5xx、网络错误或超时会有限重试，解析成功后会加密缓存本次结果，后续 Notion 重试不会再次请求 X。

#导入链接列表

在「链接列表」中粘贴多个公开帖子链接，每行一个，也可以使用空格或逗号分隔。插件会先在本地校验并按 Post ID 去重，再以最多 20 条、256KB 一批提交。

只接受以下 HTTPS 地址：

https://x.com/<handle>/status/<postId>
https://twitter.com/<handle>/status/<postId>

受保护、已删除或不允许嵌入的帖子无法通过 oEmbed 获取，插件会显示安全错误摘要，不会尝试绕过访问限制。

#导入本地文件

本地文件必须由你主动选择，支持 .json、.jsonl 和 .csv，单个文件最大 20MB。插件会先显示可识别、重复、无效和被忽略字段数量，只有点击「确认导入」后才提交规范化记录。

导入结果会分别显示接受、排队、新建、更新、部分完成、重复和失败数量。重复 Post ID 会更新 NotionHub 管理的状态和关系字段，不会再次消耗体验额度，也不会覆盖你手工修改的标题、标签或页面正文。

NotionHub JSON 可以使用以下字段：

{
  "posts": [
    {
      "postId": "1234567890",
      "url": "https://x.com/example/status/1234567890",
      "text": "公开帖子正文",
      "authorName": "Example",
      "authorHandle": "example",
      "authorUserId": "42",
      "createdAt": "2026-08-27T10:00:00Z",
      "folders": ["稍后阅读"],
      "tags": ["Notion"],
      "quote": {
        "postId": "1234567888",
        "url": "https://x.com/quoted/status/1234567888"
      },
      "replyTo": {
        "postId": "1234567889",
        "url": "https://x.com/parent/status/1234567889"
      },
      "media": [{ "type": "image", "url": "https://example.com/image.jpg" }]
    }
  ]
}

CSV 可使用 post_id、url、text、author_handle、author_name、author_user_id、created_at、folders、tags、media_urls、quoted_post_id、quoted_url、reply_to_post_id 和 reply_to_url 等列。JSON 也兼容当前 xarchive 导出的 bookmarks 与 folders 结构；可识别的引用或回复会保存目标 Post ID/链接，目标帖子已同步时还会建立 Notion 自关联。这里只读取其本地导出格式，不使用 xarchive 的 Cookie 或网页采集能力。

#隐私与数据保留

• 原始文件不会上传，也不会写入扩展存储。
• 插件只上传 Post ID、规范链接、正文、作者、公开媒体、标签、文件夹和时间等白名单字段。
• 文件只要包含 Cookie、Token、Authorization、CSRF、ct0、请求头、GraphQL 或密码字段，就会在浏览器内被拒绝。
• Worker 短期加密保存规范化记录，成功或取消后立即清除正文；永久失败的正文暂存会在 1 天内清除。
• 不含正文的导入状态最多保留 30 天，用于显示进度和排查失败。
• X 功能不会读取私信、通知、Home Timeline、关注列表或账号书签，也不会发帖、点赞或修改书签。

#去重、额度和取消

• 同一 Notion 用户与 Post ID 只对应一个帖子页面。
• 首次成功写入唯一帖子时才消耗一条体验额度。
• 重试和已同步帖子的重复更新不再次计费。
• 永久失败或取消未处理导入会释放预留额度。
• 导入进行中可以点击「取消」；已经写入 Notion 的页面不会被删除。

#常见问题

#为什么没有“连接 X 账号”按钮

本功能不读取 X 登录态。公开链接使用官方 oEmbed，本地收藏必须由你主动选择导出文件，因此不需要 X OAuth、Cookie 或 Token。

#为什么不能自动同步我的全部书签

X 的网页内部接口和私有书签不能通过非官方浏览器自动化安全读取。为了避免账号风险，NotionHub 只支持主动提交公开链接和本地文件，不提供自动书签轮询。

#为什么帖子显示不可用

帖子可能已删除、受保护、限制嵌入，或 X oEmbed 暂时不可用。先在未登录窗口确认链接是否公开；临时错误可以稍后重试，访问受限内容不会绕过限制。

#为什么媒体只有链接

首版优先保存公开安全外链和资源元数据。媒体源失效或模板缺少可选资源库时，正文仍可部分成功写入，并在同步状态中标记提示。

#如何重新授权 Notion

打开插件的「X 收藏」页面，点击重新复制模板或重新授权。重新授权只影响 NotionHub X 连接，不复用或修改 Telegram、Flomo 等服务的 Notion 连接。