用途:把 X(Twitter)内容转换为 Markdown。推文与线程会生成带 YAML front matter 的 Markdown,X 文章则进行全文内容提取。脚本位于 scripts/ 子目录,主脚本路径为 ${SKILL_DIR}/scripts/main.ts。
使用方式:常用命令为 npx -y bun ${SKILL_DIR}/scripts/main.ts <url>,可加 -o output.md 指定输出路径,或加 --json 输出 JSON;--login 仅用于刷新 cookies。支持的 URL 包括 https://x.com/<user>/status/<id>、https://twitter.com/<user>/status/<id> 和 https://x.com/i/article/<id>。输出含 url、author、tweet_count 等 front matter,文件结构为 x-to-markdown/{username}/{tweet-id}.md。
许可与认证:使用逆向工程 API,非官方,需先获取用户同意。同意文件在 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" 时打印警告并继续,否则展示免责声明并询问是否接受,拒绝则退出。认证优先使用环境变量 X_AUTH_TOKEN、X_CT0,回退到 Chrome 登录并本地缓存 cookies。可通过 EXTEND.md 配置默认输出目录与输出格式偏好,路径优先项目级 .baoyu-skills/baoyu-danger-x-to-markdown/EXTEND.md,其次 $HOME/.baoyu-skills/baoyu-danger-x-to-markdown/EXTEND.md。
限制:依赖逆向工程 API,X 更改接口时可能失效,无保证与支持,可能导致账号受限,风险自负。其他未在资料中说明的能力、收费或平台暂未提供。