用途:xurl 是调用 X(Twitter)API 的 CLI 工具,提供人类与智能体友好的快捷命令,也支持原始 curl 风格访问任意 v2 端点,全部命令以 JSON 输出到 stdout。
安装:可用 Homebrew(brew install --cask xdevplatform/tap/xurl)、npm(npm install -g @xdevplatform/xurl)、安装脚本(curl -fsSL https://raw.githubusercontent.com/xdevplatform/xurl/main/install.sh | bash,安装到 ~/.local/bin)或 Go(go install github.com/xdevplatform/xurl@latest)。使用前须认证,可用 xurl auth status 检查。
主要能力:支持发帖、回复、引用、删除、读取、搜索、查看个人资料与用户、时间线、提及、点赞/取消、转推/取消、书签管理、关注/取关、拉黑/取消、静音/取消、私信发送与列表、媒体上传与状态查询;应用管理包括列出、切换默认应用与用户、按请求指定 --app,以及用 xurl /2/users/me 等原始方式调用 v2 端点,流式端点可自动识别或用 -s 强制。
使用方式:认证后直接运行快捷命令,例如 xurl post "Hello world!"、xurl reply POST_ID "Nice post!"、xurl search "QUERY" -n 10、xurl media upload photo.jpg、xurl post "Check this out" --media-id MEDIA_ID。任意位置可用完整帖子 URL 代替 POST_ID,用户名前导 @ 可省略。常用全局参数有 --app、--auth、--username/-u、--trace/-t。
限制与安全:凭证注册与含内联密钥的认证命令必须由用户在智能体/LLM 会话之外手动完成,禁止读取、打印或上传 ~/.xurl,禁止在智能体会话中使用 --verbose/-v 以及 --bearer-token、--consumer-key、--consumer-secret、--access-token、--token-secret、--client-id、--client-secret 等敏感参数。X API 有按端点的速率限制,写接口更严格,遇 429 需等待重试;403 可能是令牌缺少作用域,可重新执行 xurl auth oauth2。OAuth 2.0 令牌过期会自动刷新。费用与具体配额暂未提供。