xurl は何をしますか？
xurl を X API の作業に使用します。ショートカットコマンドは JSON を返します。raw モードは任意の v2 エンドポイントで機能します。
認証
~/.xurlにトークンが保存されています。xurl auth statusを使用して認証状態を確認し、直接読み取らないでください。- シークレットはインラインではなく、プロンプトを介して認証コマンドに渡すことで、シェルの履歴に残らないようにします。
--verboseを指定すると、ツールの出力に認証ヘッダーが表示されます。
共通ショートカット
xurl post "Hello world!"
xurl reply POST_ID "Nice."
xurl quote POST_ID "My take"
xurl delete POST_ID
xurl read POST_ID
xurl search "query" -n 20
xurl whoami
xurl user @handle
xurl timeline -n 20
xurl mentions -n 10
xurl like POST_ID
xurl unlike POST_ID
xurl repost POST_ID
xurl unrepost POST_ID
xurl bookmark POST_ID
xurl unbookmark POST_ID
xurl followers -n 20
xurl following -n 20
xurl follow @handle
xurl unfollow @handle
xurl block @handle
xurl unblock @handle
xurl mute @handle
xurl unmute @handle
xurl dm @handle "message"
xurl dms -n 10
POST_ID には完全な https://x.com/<user>/status/<id> URL を使用できます。
メディア
xurl media upload image.jpg
xurl media upload clip.mp4
xurl media status MEDIA_ID
xurl post "caption" --media-id MEDIA_ID
動画は処理に時間がかかる場合があります。media status で状態を確認してください。
認証/アプリ管理
xurl auth status
xurl auth apps list
xurl auth default
xurl auth default APP_NAME USERNAME
xurl auth apps remove APP_NAME
リクエストごと:
xurl --app APP_NAME /2/users/me
xurl --auth oauth2 /2/users/me
Raw API
xurl /2/users/me
xurl -X POST /2/tweets -d '{"text":"Hello world!"}'
xurl '/2/tweets/search/recent?query=openclaw&max_results=10'
ショートカットがエンドポイントをカバーしていない場合は raw モードを使用します。複雑な JSON の場合はペイロードを一時ファイルに保存します。
出力とエラー
- 成功時は JSON が標準出力に出力されます。
- API/認証/ネットワークエラー時はゼロ以外の終了コードが返されます。
- 401/403: 認証、スコープ、またはアプリの不一致。
xurl auth statusで確認してください。 - 429: レート制限があります。バックオフしてください。
- メディアアップロードの失敗: ファイルの種類/サイズ、およびメディア処理の状態を確認してください。