用途:xurl 是 X API 命令行工具,既提供人类/智能体友好的快捷命令,也支持对任意 X API v2 端点的原始 curl 风格访问,所有命令返回 JSON 到 stdout。使用前需先完成认证,可用 xurl auth status 检查。
主要能力:发帖(xurl post "Hello world!")、回复(xurl reply POST_ID "...")、引用(xurl quote)、删除、读取单帖;搜索(xurl search "QUERY" -n 10);查看自身资料 whoami、用户查询 user;时间线与提及 timeline、mentions;点赞、转发、书签及其取消;关注、屏蔽、静音等社图操作;私信 dm、dms;媒体上传 media upload 与状态查询 media status。原始模式可写 xurl /2/users/me,或用 -X POST、-d、-H、-s(流式)访问端点,流式端点自动识别。
使用方式:安装可选 brew install --cask xdevplatform/tap/xurl、npm install -g @xdevplatform/xurl、Go 安装或官方 shell 脚本。认证需用户本机手动配置,之后运行 xurl auth oauth2;多应用可用 xurl auth default prod-app 切换,或用 --app 做一次性覆盖。命令中 POST_ID 可换成完整帖子 URL;用户名前导 @ 可省略。
限制与安全:~/.xurl 为 YAML 存储凭据,绝不可读取或传入 LLM 上下文,也不要让用户粘贴密钥;智能体会话中禁用 --verbose/-v 及 --bearer-token、--consumer-key 等敏感参数,应用凭据须在智能体外手动注册。X API 有每端点速率限制,写入端点更严格,429 需等待重试;403 可能因令牌缺少 scope,可重跑认证。OAuth 2.0 令牌过期自动刷新。其余细节资料未提供。