用途:xurl 是操作 X(Twitter)API 的命令行工具,同时提供面向人和智能体的快捷命令,以及可访问任意 v2 端点的 curl 风格原始模式,所有命令返回 JSON。
主要能力:发帖、回复、引用、删除帖子;读取帖子与搜索近期帖子;查看自身资料与任意用户;获取首页时间线与提及;点赞、转推、书签及其撤销;关注、屏蔽、静音等社交图谱操作;发送与列出私信;上传媒体并查询处理状态。原始模式支持 GET/POST/PUT/PATCH/DELETE、自定义请求头和流式端点(-s 强制)。
安装:macOS 可用 brew install --cask xdevplatform/tap/xurl;也可 npm install -g @xdevplatform/xurl;或脚本 curl -fsSL https://raw.githubusercontent.com/xdevplatform/xurl/main/install.sh | bash;Go 可用 go install github.com/xdevplatform/xurl@latest。
用法:使用前须完成认证,先运行 xurl auth status 检查。注册应用与填写凭据须由用户在智能体会话之外手动完成,之后运行 xurl auth oauth2。常用命令如 xurl post "Hello world!"、xurl reply POST_ID "Nice post!"、xurl search "QUERY" -n 10、xurl whoami。POST_ID 位置可直接粘贴完整帖子 URL,用户名前导 @ 可选。多应用可用 xurl auth default APP [USER]、xurl --app NAME 或 --username/-u 切换。
限制与安全:禁止读取、打印、上传或向模型上下文发送 ~/.xurl 及其副本;禁止要求用户在对话中粘贴凭据;禁止在智能体会话中使用内联密钥参数(--bearer-token、--consumer-key、--consumer-secret、--access-token、--token-secret、--client-id、--client-secret);禁止使用 --verbose/-v,以免泄露认证头与令牌。API 有按端点的速率限制,写入端点更严格,遇 429 需等待重试;OAuth 2.0 令牌自动刷新,若某操作返回 403 可能缺少所需范围,可重新运行 xurl auth oauth2。出错时返回非零退出码,错误信息以 JSON 输出到 stdout。令牌以 YAML 保存在 ~/.xurl,各应用凭据与令牌相互隔离。缺失信息:具体定价、收费与额度未提供。