SuperAPI AI 工具集

baoyu-danger-x-to-markdown

编程与开发

查看项目

更新于 10-15 21:56

技能介绍

用途:把 X(Twitter)的推文、线程和 X Articles 转换为 Markdown,输出带 YAML front matter(url、author、tweetCount、coverImage 等)。

主要能力:支持推文/线程转 Markdown、X Articles 全文提取;可用 --json 输出 JSON;可用 --download-media 将图片、视频下载到本地 imgs/ 与 videos/ 并重写链接为相对路径;支持 --login 仅刷新 cookies。支持 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 用 npx -y bun;都没有则建议安装 bun。命令示例:${BUN_X} {baseDir}/scripts/main.ts <url>;可加 -o output.md、--download-media、--json。

同意与配置:使用前必须检查并获取同意。同意文件在 macOS 为 ~/Library/Application Support/baoyu-skills/x-to-markdown/consent.json,Linux 为 ~/.local/share/baoyu-skills/x-to-markdown/consent.json。若 accepted: true 且 disclaimerVersion: "1.0" 则打印警告后继续;否则展示免责声明并询问是否接受,接受后写入 consent.json,拒绝则输出 "User declined. Exiting." 并停止。偏好文件 EXTEND.md 按项目、XDG、用户主目录顺序查找,找到即读取应用;未找到必须执行首次设置(阻塞),用 AskUserQuestion 询问媒体处理、默认输出目录、保存位置,不得静默创建默认值。支持键:download_media(ask/1/0)、default_output_dir。优先级:CLI 参数 > EXTEND.md > 技能默认。

认证:优先环境变量 X_AUTH_TOKEN、X_CT0;回退为 Chrome 登录,自动打开 Chrome 并本地缓存 cookies。

限制:使用逆向工程 X API,非官方;X 变更 API 时可能失效,无保证与支持,可能导致账号受限,风险自负。首次设置未完成前不得进行转换。其他细节资料未提供。