xurl は何をしますか?
X API の公式 CLI。
主な上流リポジトリ: https://github.com/xdevplatform/xurl
インストール
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
Go:
go install github.com/xdevplatform/xurl@latest
安全性
~/.xurlを LLM コンテキストに読み込んだり、表示、要約、アップロード、貼り付けたりしないでください。- クライアントシークレット、ベアラートークン、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 でも構いません。
Raw エンドポイントモード
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