X Post Extractor Extension

一个无需后端、无需书签脚本的浏览器扩展，用来把单条 X 或 Twitter 帖子详情页导出成 Markdown。

功能

• 提取单条帖子正文、作者、账号、发布时间和原始链接
• 尝试抓取 X Article 卡片的全文内容
• 支持在导出前直接预览和手动编辑 Markdown
• 支持一键复制或下载 .md 文件
• 仅在本地浏览器页面内运行，不上传内容到任何服务器

适用浏览器

• Google Chrome
• Microsoft Edge
• 其他兼容 Manifest V3 的 Chromium 浏览器

安装

1. 下载或克隆这个仓库
2. 打开 chrome://extensions/ 或 edge://extensions/
3. 打开右上角的 Developer mode
4. 点击 Load unpacked
5. 选择当前项目目录

使用方法

1. 打开单条帖子详情页，例如 https://x.com/<user>/status/<id>
2. 等待页面右下角出现 Export Markdown
3. 点击按钮后，扩展会弹出 Markdown 预览面板
4. 你可以直接：
   • Copy Markdown
   • Download .md
   • 在文本框内手动修改后再导出

导出内容

默认会尽量包含以下信息：

• 作者名
• 用户句柄
• 发布时间
• 帖子链接
• 帖子正文
• Article 标题与正文（如果可读取）
• 图片 alt 文本等媒体备注
• 页面原始文本片段

权限与隐私

• 仅匹配 https://x.com/* 和 https://twitter.com/*
• 不调用任何第三方 API
• 不收集、不上传、不存储用户数据
• 所有提取、复制和下载行为都在本地浏览器中完成

更多说明见 PRIVACY.md。

已知限制

• 最适合单条帖子详情页，不保证时间线列表页表现稳定
• X 页面结构变动后，选择器可能需要更新
• 如果 Article 页面要求重新登录，扩展会回退到卡片摘要
• 某些媒体内容只能提取到 alt 文本，不能直接导出原图

本地开发

这个项目没有构建步骤或打包依赖。

1. 修改 content.js 或 manifest.json
2. 回到扩展管理页面点击刷新
3. 重新打开帖子详情页验证效果

项目结构

• manifest.json: 扩展清单
• content.js: 页面注入与导出逻辑

License

MIT