baoyu-danger-x-to-markdown
将X（推特）推文及文章转换为带YAML前置元数据的Markdown格式。采用逆向工程API，需获得用户授权方可使用。当用户提及"X转markdown"、"推文转markdown"、"保存推文"或提供x.com/twitter.com链接请求转换时启用此功能。
baoyu-danger-x-to-markdown
技能概述
将 X (Twitter) 推文和文章转换为带 YAML Front Matter 的 Markdown 文件的命令行工具，支持推文串和长篇文章的完整内容提取。
适用场景
-
内容归档备份：当你需要将重要的推文、推文串或 X Articles 保存到本地时，直接导出为结构化的 Markdown 文件，方便离线阅读和长期保存。
-
内容创作者素材收集：博主、研究员、记者等需要收集 Twitter/X 平台上的有价值内容作为素材引用时，使用此工具快速转换为可编辑的 Markdown 格式。
-
知识库与笔记集成：将 X 平台内容导入 Obsidian、Logseq 等支持 Markdown 的笔记工具，YAML Front Matter 可被自动识别为元数据标签。
核心功能
-
推文与文章转换：支持单条推文、推文串（Thread）和 X Articles 的完整内容提取，自动生成包含 URL、作者信息、推文数量等元数据的 YAML Front Matter。
-
智能认证管理：支持环境变量配置（
X_AUTH_TOKEN、X_CT0），也提供 Chrome 自动登录和 Cookie 缓存功能，首次登录后可复用认证状态。 -
用户同意机制：由于使用逆向工程的非官方 API，工具内置了用户同意流程和免责声明，确保用户了解潜在风险（API 变动、账号限制等）后自愿使用。
常见问题
这个工具安全吗？会导致封号吗？
该工具使用的是逆向工程的 X API，并非官方接口。虽然工具本身设计谨慎，但使用非官方 API 存在一定风险，包括但不限于：X 平台 API 变动导致工具失效、潜在的账号使用限制等。工具强制要求用户阅读并接受免责声明后才能使用，请根据自身情况评估风险。
支持哪些 URL 格式？
支持以下三种 URL 格式：
https://x.com/<用户名>/status/<推文ID>https://twitter.com/<用户名>/status/<推文ID>https://x.com/i/article/<文章ID>
如何配置认证信息？
推荐使用环境变量方式（优先级更高）：设置 X_AUTH_TOKEN 和 X_CT0 两个环境变量。如果未配置，工具会尝试自动打开 Chrome 浏览器完成登录，并将 Cookie 缓存到本地，后续使用可直接复用。使用 --login 参数可单独刷新认证状态。