用途:把 X(Twitter)的推文、线程和 X Articles 转换成带 YAML front matter 的 Markdown,便于归档或二次使用。
主要能力:支持推文/线程转 Markdown,X Articles 全文提取;可用 --json 输出 JSON;可用 --download-media 下载图片与视频并将链接改写为本地相对路径;输出文件结构为 x-to-markdown/{username}/{tweet-id}/{content-slug}.md,媒体存于同目录 imgs/ 与 videos/。支持 URL:https://x.com/<user>/status/<id>、https://twitter.com/<user>/status/<id>、https://x.com/i/article/<id>。
使用方式:脚本位于 scripts/ 子目录,路径为 {baseDir}/scripts/main.ts;先解析运行时 ${BUN_X}:装有 bun 用 bun,否则用 npx -y bun,都无则建议安装 bun。常用命令:${BUN_X} {baseDir}/scripts/main.ts <url>、加 -o output.md、加 --download-media、加 --json,--login 仅刷新 cookies。首次使用需同意声明并创建 consent.json,缺失或不匹配时展示风险说明并询问是否接受;随后需完成 EXTEND.md 首次设置(阻断式),询问媒体处理与默认输出目录及保存位置,不得静默使用默认值。
适用场景:需要把 X 内容批量或单条转成 Markdown、保留封面与媒体、纳入本地知识库或写作流程。
限制:使用逆向工程 API,非官方,X 变更可能导致失效,无保证与支持,可能引发账号限制,风险自担。认证优先用环境变量 X_AUTH_TOKEN、X_CT0,回退到 Chrome 登录缓存 cookies。extend.md 优先级为项目、XDG、用户主目录;键包括 download_media(ask/1/0)与 default_output_dir。其他细节暂未提供。