用途:通过官方 xurl CLI 从智能体或终端管理 X/Twitter 发布,支持单条帖子、长贴串、媒体上传与 X Article 草稿流程。
主要能力:可创建帖子与贴串、回复、读取、删除、上传媒体,并把 Markdown/MDX 转换为 X Article 的 content_state JSON 后创建未发布草稿。
使用方式:每次任务先做状态探测,运行 command -v xurl、xurl --version、xurl auth status、xurl whoami。若 xurl whoami 成功即复用现有账号;缺失或未配置 OAuth 时需先完成安装与授权。发布命令包括 xurl post "TEXT"、xurl reply <POST_ID> "..."、xurl read、xurl delete、xurl media upload。不熟悉的参数先用 xurl <command> --help 查询。Article 流程为:编写或接收 Markdown/MDX,本地校验并列出有损或不支持的构造,处理或明确接受警告后无凭据转换为 content_state,再用官方 xurl 上传本地媒体,通过官方 API 创建未发布草稿,由用户在 X 中审阅,收到单独明确指令后才发布。
适用场景:需要在智能体、脚本或终端中程序化发布 X 内容的个人或团队,尤其是含 Markdown 到 Article 转换的工作流。
限制与安全:xurl 是唯一可持有和使用 X 凭据的组件,禁止把 OAuth 客户端密钥、刷新/访问令牌、Bitwarden 机器令牌、X Cookie 或浏览器会话信息贴入聊天或命令输出。持久密钥应存于密钥管理器或系统凭据存储,不要明文写入 shell 配置。已测试的 xurl 版本执行 xurl -v 会打印 Authorization 头,因此认证请求中禁止使用。不把 XMaster 或浏览器 Cookie 工具作为本流程的认证发布路径。第三方代码仅在源码审查、版本固定并在支持时禁用依赖安装生命周期脚本后,才可用于纯转换。HTTP 429 视为停止条件,不盲目重试;5xx 可能瞬时,但重复写入前先隔离载荷。当前测试的转换器为 mgcrea/mcp-x,仅使用其纯 Markdown 到 Article 的转换/校验代码,并保持无凭据;固定版本不得静默升级,需先审计新版本。创建草稿会改变外部状态但不会公开,X 可能对每日草稿创建设有限额,不要随意重复探测。每次写入后应报告创建/删除了什么、返回的帖子或文章 ID 及公开 URL、对象是公开还是草稿、以及格式警告或未解决的兼容性限制。