用途:xurl 是 X(Twitter)开发者平台官方 CLI,用于在命令行操作 X API v2,既提供常用动作的快捷命令,也支持 curl 风格的原始端点访问,所有命令以 JSON 输出到 stdout。
主要能力:发帖、回复、引用、删除;搜索帖子、读取时间线与提及;点赞、转推、书签;关注、取关、屏蔽、静音;私信;图片与视频上传;访问任意 X API v2 端点;多应用/多账号工作流。支持 OAuth 2.0 PKCE 并自动刷新令牌。
安装(任选其一):curl -fsSL https://raw.githubusercontent.com/xdevplatform/xurl/main/install.sh | bash;brew install --cask xdevplatform/tap/xurl;npm install -g @xdevplatform/xurl;go install github.com/xdevplatform/xurl@latest。验证:xurl --help、xurl auth status。
使用方式:用户需在代理会话之外手动完成应用注册与授权,例如 xurl auth apps add my-app --client-id YOUR_CLIENT_ID --client-secret YOUR_CLIENT_SECRET、xurl auth oauth2 --app my-app、xurl auth default my-app。常用命令如 xurl post "Hello world!"、xurl search "QUERY" -n 10、xurl dm @handle "message"、xurl media upload path/to/file.mp4、xurl /2/users/me。
限制与安全:禁止在代理会话中读取、打印或上传 ~/.xurl,禁止内联密钥参数与 --verbose;凭据注册与轮换须由用户手动完成。X API 有速率限制,429 需等待重试;部分失败源于套餐或权限而非代码。Docker 中需注意 HOME 指向 /opt/data/home。具体收费与价格资料未提供。