twitter-cli

twitter-cli skill 總覽

twitter-cli skill 能做什麼

twitter-cli 是一個以終端機為優先的 Twitter/X skill，可用來讀取時間軸、書籤、搜尋結果、個人檔案與推文詳情；在完成驗證後，也支援發文與其他寫入操作。它特別適合想用 CLI 流程取代網頁版的使用者，尤其是在 Social Media 研究、帳號監看與輕量發佈這些情境。

誰適合使用它

如果使用者想從命令列檢視 Twitter/X 資料、自動化例行讀取，或產生可供下游處理的結構化輸出，就適合用 twitter-cli skill。當目標是快速擷取與終端機輸出，而不是完整的社群媒體儀表板時，它會是很合適的選擇。

這個 skill 為什麼不一樣

最大的採用關鍵在於驗證。twitter-cli 不一定需要 API keys 就能運作，但寫入操作會依賴有效的瀏覽器 cookies；如果只提供部分環境變數，執行也可能失敗。也就是說，twitter-cli 的安裝決策，核心其實在於：使用者能否順利完成驗證，以及他們需要的是唯讀還是讀寫權限。

如何使用 twitter-cli skill

安裝 twitter-cli

用以下指令安裝 twitter-cli skill：
npx skills add public-clis/twitter-cli --skill twitter-cli

安裝之後，實際上要判斷的 twitter-cli install 條件，是目標環境是否有 Python 3.10+、uv 或 pipx。這個 repo 的設定方式本來就是 Python CLI 安裝流程，不是瀏覽器擴充功能，也不是代管服務。

先從驗證開始

在進行任何真正的 twitter-cli usage 之前，先檢查狀態。這個 repo 的流程很明確：先確認憑證存在，再往下做。

常見的第一步檢查：
twitter status --yaml

如果 status 顯示未驗證，請先引導使用者透過瀏覽器 cookie 擷取，或其他支援的驗證路徑完成登入，再嘗試發文、回覆或按讚。這一點很重要，因為 twitter-cli 的寫入操作，最常卡住採用的地方就是驗證不完整。

把任務拆成好的提示詞

一個好的 twitter-cli guide 提示詞，應該清楚說明：

• 目標動作：讀取、搜尋、發文、回覆、引用、按讚、轉推、追蹤或查找
• 目標物件：username、tweet ID、關鍵字、list，或 timeline 類型
• 輸出格式：終端機畫面、--yaml 或 --json
• 任何限制：日期範圍、搜尋分頁、完整文字，或是否排除轉推

範例需求長相：
「用 twitter-cli 搜尋 open source LLM，範圍選 Latest，回傳 --yaml，並整理前 5 筆結果的作者與 URLs。」

先看這些檔案

如果想快速讀 repo，請優先看：

• SKILL.md：指令與驗證規則
• README.md：功能範圍與範例
• SCHEMA.md：結構化輸出格式
• AGENTS.md：開發與測試脈絡
• twitter_cli/cli.py 與 twitter_cli/auth.py：命令入口與登入行為

twitter-cli skill 常見問題

twitter-cli 只適合讀 Twitter/X 嗎？

不是。twitter-cli skill 同時支援讀取與寫入，但寫入操作對驗證品質更敏感，可能需要瀏覽器 cookies，而不只是環境變數。

我需要 API keys 嗎？

一般來說，基本的 twitter-cli 流程不需要 API keys。這個 repo 的設計重點是以瀏覽器 cookies 驗證搭配 CLI 存取，對想快速做 Social Media 操作、又不想先建立 developer app 的使用者特別實用。

什麼情況下不適合用 twitter-cli？

如果使用者需要高流量自動化、保證穩定的 API，或不是以終端機為主的工作流程，就不建議用 twitter-cli。如果帳號無法在支援的瀏覽器中完成驗證，或任務需要無人值守的寫入存取，它也不太適合。

它適合新手嗎？

如果任務很簡單，而且使用者能在支援的瀏覽器中登入 X，那它算是適合新手。最大的入門陷阱，是在憑證還沒確認前就以為指令一定能跑；先驗證，再下指令，會容易很多。

如何改善 twitter-cli skill

給出最小但完整的目標

最好的 twitter-cli 輸出，通常來自精準的輸入：who、what、how many。像「找出 @example 最近談 AI agents 的貼文」會比「搜尋 Twitter」更好，因為這樣 skill 才能選對命令路徑，也能減少雜訊。

先講清楚輸出限制

如果你希望更好的 twitter-cli usage，請先說明你要完整推文文字、結構化輸出，還是精簡的終端機摘要。例如，--yaml 很適合要把結果再拿去解析；而豐富表格輸出則更適合互動式檢視。

說明驗證與環境限制

請告訴系統這個 session 是否已登入、是否有可用的瀏覽器 cookies，以及使用者能不能開啟支援的瀏覽器。這些限制對 twitter-cli install 與執行路徑的影響，通常比推文內容本身還大。

從結果品質調整，不要只改指令形式

如果第一次跑出來的結果不對，優先補強提示詞中的搜尋詞、作者篩選、時間區間或輸出格式，而不是整個重寫需求。對 twitter-cli skill 來說，最大的改善通常來自縮小範圍，以及把想要的資料形狀講清楚。