SuperAPI AI 工具集

baoyu-danger-x-to-markdown

写作与研究

查看项目

更新于 10-16 03:38

技能介绍

用途:把 X(Twitter)的推文、线程和 X Articles 转换为 Markdown,输出带 YAML front matter(url、author、tweetCount、coverImage 等),并支持图片/视频本地化。该技能使用逆向工程 API,并非官方接口,需用户先阅读并同意免责声明。

主要能力:推文与线程转换为 Markdown;X Articles 全文提取;--json 输出;--download-media 将图片保存到 markdown 同级 imgs/、视频保存到 videos/,并重写 Markdown 链接为本地相对路径;文件结构为 x-to-markdown/{username}/{tweet-id}/{content-slug}.md。支持的 URL:https://x.com/<user>/status/<id>、https://twitter.com/<user>/status/<id>、https://x.com/i/article/<id>。

使用方式:脚本位于 scripts/ 子目录,路径为 {baseDir}/scripts/main.ts,其中 {baseDir} 为该 SKILL.md 所在目录;运行时 {BUN_X} 优先用 bun,其次 npx -y bun,否则建议安装 bun。示例:${BUN_X} {baseDir}/scripts/main.ts <url>;加 -o output.md 指定输出;加 --download-media 下载媒体;加 --json 输出 JSON;加 --login 仅刷新 cookies。首次使用需同意免责声明并生成 consent.json;若 EXTEND.md 不存在,必须先完成首次设置(阻塞操作),询问媒体处理方式、默认输出目录和偏好保存位置。EXTEND.md 支持 download_media(ask/1/0,默认 ask)和 default_output_dir(默认空即 ./x-to-markdown/),值优先级为 CLI 参数、EXTEND.md、技能默认值。认证优先使用环境变量 X_AUTH_TOKEN、X_CT0,回退为自动打开 Chrome 并本地缓存 cookies。

适用场景:需要把 X 内容归档、二次编辑或转为本地文档时。

限制:使用逆向工程 API,X 更改 API 时可能失效,无保证与支持,可能触发账号限制,风险自负;需用户明确同意;偏好设置和认证可能需要额外配置。具体收费、价格、平台支持范围及效果暂未提供。