xurl

• 您需要 AI 代理或自動化腳本來在 X 上發佈推文、回覆或引用貼文。
• 您想要以程式化方式搜尋最近的貼文、讀取時間軸或監控提及。
• 您需要管理社交圖譜操作（追蹤、取消追蹤、封鎖、靜音）或透過腳本傳送私訊。
• 您想要上傳媒體（圖片、影片）並將其附加到貼文，而無需編寫自訂 API 客戶端程式碼。

• 您需要與舊版 X API v1.1 端點互動——xurl 僅支援 v2。
• 您處於沙盒或共享環境中，將憑證持久化儲存至 ~/.xurl 並不安全或可行。
• 您需要圖形化或無程式碼介面來管理您的 X 帳號。

預先備妥的單行指令涵蓋發文、回覆、引用、刪除、搜尋、按讚、轉發、書籤、追蹤、封鎖、靜音、傳送私訊及上傳媒體等功能。日常任務無需自行建構原始 API 請求內容。

除了快捷指令之外，xurl 也可作為通用的 X API 客戶端使用。透過 xurl /2/some/endpoint 搭配 -X、-d 和 -H 旗標，即可存取任何 v2 端點，就像使用 curl 一樣，但驗證部分會自動處理。

註冊多個 X 應用程式，並為每個應用程式驗證多個 OAuth 2.0 帳號。使用 xurl auth default 在它們之間切換，或透過 --app 和 --username 旗標針對個別請求進行覆蓋。

使用 xurl media upload 上傳圖片或影片，然後將返回的 media_id 直接附加到貼文或回覆中。影片處理狀態可透過 xurl media status --wait 輪詢查詢。

已知的串流端點（例如 /2/tweets/search/stream、/2/tweets/sample/stream）會被自動偵測並正確處理。任何端點皆可透過 -s 旗標強制進入串流模式。

憑證儲存於本機的 ~/.xurl 中，無需以內嵌方式傳遞。此工具強制執行嚴格的「禁止內嵌密鑰」政策，讓您在 AI 代理或 LLM 工作流程中使用時更加安全，有效降低提示詞／上下文內容洩漏的風險。

代理人可以使用 xurl search 搜尋特定主題的貼文，透過 xurl read 讀取相關內容，接著回覆或對最相關的結果按讚——全程在單一串聯工作流程中完成，每個步驟均以結構化 JSON 處理。

使用 xurl media upload 上傳已準備好的圖片，從 JSON 回應中擷取 media_id，並立即將其附加至新貼文——實現全自動化的富媒體發布流程。

使用 xurl mentions、xurl timeline、xurl followers 和 xurl dms，定期檢查提及、首頁時間軸、新追蹤者及私訊，以驅動監控儀表板或通知機器人。

分別註冊開發與正式環境的應用程式，各自獨立進行驗證，並透過 xurl auth default 或每次請求的 --app 參數在兩者之間切換——完全不會混用憑證。