xurl 是做什麼的？
使用 xurl 進行 X API 相關工作。快捷指令回傳 JSON；原始模式可用於任何 v2 端點。
認證
~/.xurl儲存 token；請使用xurl auth status檢查認證狀態，而非直接讀取該檔案。- 透過提示傳遞機密資訊給認證指令，不要內嵌在指令中，以免留存在 shell 歷史紀錄中。
--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
原始 API
xurl /2/users/me
xurl -X POST /2/tweets -d '{"text":"Hello world!"}'
xurl '/2/tweets/search/recent?query=openclaw&max_results=10'
當快捷指令不涵蓋某個端點時，請使用原始模式。對於複雜的 JSON，將 payload 存放在暫存檔案中。
輸出與錯誤
- 成功時輸出 JSON 到 stdout。
- API/認證/網路錯誤時回傳非零退出碼。
- 401/403：認證、權限範圍或應用程式不符；請檢查
xurl auth status。 - 429：已達速率限制；請暫緩。
- 媒體上傳失敗：請檢查檔案類型/大小及媒體處理狀態。