xurl 是一个用于向 X(Twitter)API 发起已认证请求的命令行工具,支持人类与智能体友好的快捷命令,也支持以 curl 风格直接访问任意 v2 端点。所有命令均将 JSON 输出到标准输出,输出结构与 X API v2 响应一致,错误也以 JSON 返回(并以非零退出码结束)。
安装方式包括:brew install --cask xdevplatform/tap/xurl;npm install -g @xdevplatform/xurl;curl -fsSL https://raw.githubusercontent.com/xdevplatform/xurl/main/install.sh | bash(安装到 ~/.local/bin);go install github.com/xdevplatform/xurl@latest。
使用前必须先完成认证,可用 xurl auth status 检查。注册应用凭据须由用户在智能体之外手动完成,随后运行 xurl auth oauth2 认证。多应用可用 xurl auth default prod-app 或 xurl --app dev-app /2/users/me 切换。令牌以 YAML 持久化到 ~/.xurl,每个应用令牌相互隔离,不得通过智能体读取该文件。
主要快捷命令:发帖 xurl post "Hello world!";回复 xurl reply POST_ID "Nice post!";引用 xurl quote POST_ID "My take";删除 xurl delete POST_ID;读取 xurl read POST_ID;搜索 xurl search "QUERY" -n 10;自身信息 xurl whoami;用户查询 xurl user @handle;时间线 xurl timeline -n 20;提及 xurl mentions -n 10;点赞/取消 xurl like/unlike POST_ID;转推/取消 xurl repost/unrepost POST_ID;书签/取消 xurl bookmark/unbookmark POST_ID;列出书签/点赞 xurl bookmarks -n 10、xurl likes -n 10;关注/取关 xurl follow/unfollow @handle;关注列表 xurl following -n 20;粉丝 xurl followers -n 20;屏蔽/静音 xurl block/unblock/mute/unmute @handle;私信 xurl dm @handle "message"、xurl dms -n 10;媒体上传 xurl media upload path/to/file.mp4、状态 xurl media status MEDIA_ID。POST_ID 位置也可粘贴完整帖子 URL,用户名前导 @ 可省略。
原生访问:xurl /2/users/me(GET);xurl -X POST /2/tweets -d '{"text":"Hello world!"}';xurl -X DELETE /2/tweets/1234567890;-H 设置头部;-s 强制流式,已知流式端点包括 /2/tweets/search/stream、/2/tweets/sample/stream、/2/tweets/sample10/stream。
安全要求:绝不在智能体会话中使用 --verbose/-v,以及 --bearer-token、--consumer-key、--consumer-secret、--access-token、--token-secret、--client-id、--client-secret 等敏感参数;不要让用户粘贴凭据;凭据须由用户在本机手动填写。
限制与说明:X API 按端点限流,429 需等待重试,写端点限制更严;OAuth 2.0 令牌作用域较宽,特定操作 403 可能因缺少作用域,需重新认证;OAuth 2.0 令牌过期自动刷新;命令需用户 ID 时会自动调用 /2/users/me。