xurl

xurl

使用 xurl 進行 X API 的相關操作。快捷指令會傳回 JSON；原始模式 (raw mode) 則適用於任何 v2 API 端點。

金鑰與機密安全

• 切勿讀取、列印、摘要、上傳或檢查 ~/.xurl。
• 切勿要求使用者在對話中貼上 Token 或機密。
• 請勿執行內置機密參數的身份驗證指令。
• 在 Agent 對話階段 (session) 中切勿使用 --verbose，這可能會洩漏身份驗證標頭 (auth headers)。
• 使用 xurl auth status 檢查身份驗證狀態。

常見快捷指令

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

影片可能需要處理時間；請輪詢 (poll) media status 確認狀態。

身份驗證與 App 管理

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 (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'

當快捷指令無法涵蓋目標端點時，請使用原始模式。若 JSON 載荷 (payload) 較為複雜，建議先存放在暫存檔中。

輸出與錯誤處理

• 成功時，由標準輸出 (stdout) 傳回 JSON。
• 發生 API、身份驗證或網路錯誤時，結束代碼 (exit code) 為非零值。
• 401/403：身份驗證、權限範圍 (scope) 或 App 設定不符合；請執行 xurl auth status 檢查。
• 429：觸發頻率限制 (rate limited)；請退避重試。
• 媒體上傳失敗：請檢查檔案類型、大小以及媒體處理狀態。