xurl 是做什么的?
X API 的官方 CLI。
主上游仓库:https://github.com/xdevplatform/xurl
安装
Homebrew:
brew install --cask xdevplatform/tap/xurl
npm:
npm install -g @xdevplatform/xurl
Shell 脚本:
curl -fsSL https://raw.githubusercontent.com/xdevplatform/xurl/main/install.sh | bash
Go:
go install github.com/xdevplatform/xurl@latest
安全
- 切勿读取、打印、总结、上传或粘贴
~/.xurl到 LLM 上下文中。 - 切勿要求用户将客户端密钥、Bearer 令牌或 OAuth 令牌粘贴到聊天中。
- 在代理运行时切勿使用
--verbose;这可能导致认证头暴露。 - 不要在代理会话中使用内联秘密标志运行认证命令。
- 用户必须在代理会话之外,在其机器上手动注册应用凭据。
认证
检查当前状态:
xurl auth status
如果已注册应用,完成 OAuth 2.0:
xurl auth oauth2
多应用:
xurl auth apps list
xurl auth default my-app
xurl auth default my-app alice
xurl --app dev-app /2/users/me
注意事项:
xurl将应用配置和令牌存储在~/.xurl中。- X 开发者门户中的 OAuth 2.0 回调 URI 应设置为
http://localhost:8080/callback。 - 此处有意省略了内联秘密的应用注册示例。请务必在代理会话之外进行注册。
常用快捷命令
xurl post "Hello world!"
xurl reply 1234567890 "Nice post"
xurl quote 1234567890 "My take"
xurl delete 1234567890
xurl read 1234567890
xurl search "from:elonmusk" -n 10
xurl whoami
xurl user @XDevelopers
xurl timeline -n 20
xurl mentions -n 10
xurl like 1234567890
xurl unlike 1234567890
xurl repost 1234567890
xurl unrepost 1234567890
xurl bookmark 1234567890
xurl unbookmark 1234567890
xurl bookmarks -n 10
xurl likes -n 10
xurl follow @handle
xurl unfollow @handle
xurl following -n 20
xurl followers -n 20
xurl dm @handle "message"
xurl dms -n 10
xurl media upload path/to/file.mp4
xurl media status MEDIA_ID
POST_ID 也可以是完整的 X 状态 URL。
原始端点模式
GET:
xurl /2/users/me
POST JSON:
xurl -X POST /2/tweets -d '{"text":"Hello world!"}'
自定义头:
xurl -H "Content-Type: application/json" /2/tweets
选择认证类型:
xurl --auth oauth2 /2/users/me
xurl --auth oauth1 /2/tweets
xurl --auth app /2/users/me
选择 OAuth2 账户:
xurl --username alice /2/users/me
流式响应:
xurl /2/tweets/search/stream
xurl -s /2/users/me
快速检查
安装:
xurl version
认证:
xurl auth status
认证后的实时请求:
xurl whoami