TweetAPI 唯讀工作流程
在保持操作唯讀、憑證儲存在伺服器端且明確使用配額的前提下，使用 TweetAPI 存取公開的 Twitter/X 資料。
執行安全邊界
- 僅允許擷取公開資料或公開文件的操作。
- 不得發文、回覆、刪除、按讚、轉推、書籤、跟隨、取消跟隨，或變更個人檔案、清單、社群狀態。
- 不得存取私訊、收件匣、通知、私人帳戶分析、帳單、API 金鑰管理、管理介面或內部端點。
- 不得執行 Twitter/X 登入或自動化會話。
- 絕不要求、接受、儲存或轉發密碼、Cookie、
authToken、ct0、TOTP 驗證碼、代理憑證或私訊內容。 - 絕不呼叫需要上述任何機密資訊的端點，即使該端點出現在更廣泛的公開 API 文件中。
- 切勿僅以 HTTP 方法作為安全性的充分證據。應確認操作的效果及必要欄位。
- 不得聲稱與 X Corp. 有關聯。TweetAPI 是第三方服務。
如果請求的任務跨越此邊界，請說明被排除的操作，並提供一個唯讀的替代方案。不要因為更廣泛的 TweetAPI 產品支援更多操作，就削弱此邊界。
選擇執行路徑
當使用者希望代理程式檢查文件或執行有限的公開資料查詢時，請使用代管的 MCP 伺服器。優先採用其 OAuth 流程，以免 API 金鑰進入對話中。在設定用戶端或呼叫即時工具之前，請先閱讀 references/hosted-mcp.md。
在修改應用程式時，請使用伺服器端 REST 或官方 SDK。在撰寫整合程式碼之前，請先閱讀 references/integration.md。
對於純粹的文件查詢，請直接閱讀權威的公開來源，不要發出即時資料請求。每當需要最新的端點名稱、參數、回應欄位或安裝說明時，請務必參閱 references/sources.md。
遵循工作流程
- 識別請求是純文件查詢、即時查詢，還是應用程式整合。
- 在選擇端點或工具之前，先根據安全邊界檢查操作。
- 查閱最新的公開文件，而非依賴複製的端點目錄。
- 對於代理程式使用，選擇 MCP OAuth；對於應用程式程式碼，選擇伺服器端 API 金鑰。
- 在發出即時請求之前，先聲明這將消耗配額。
- 最多進行一次即時工具呼叫，並預設僅擷取一頁資料。
- 回傳任何分頁游標，而非自動跟隨它。在索取下一頁前請先詢問。
- 僅將 HTTP 2xx 回應視為成功。清楚呈現驗證、配額和驗證失敗的資訊。
- 使用模擬或測試裝置驗證應用程式的變更。除非使用者明確授權，否則不要在設定或測試期間消耗即時配額。
控制配額與分頁
每次即時資料請求都會消耗配額。重試和後續頁面可能消耗更多配額。
- 不要自動分頁。
- 不要默默地重試即時請求。
- 不要僅僅為了證明配置正確而執行即時「煙霧測試」。
- 在擷取第一頁後停止，並揭露回傳的游標。
- 如果使用者明確要求多頁的應用程式行為，請實作一個可設定的上限，用於控制頁數、項目數和總請求數。切勿使用無界限的分頁輔助工具。
保護憑證
- 將
TWEETAPI_API_KEY儲存在僅限伺服器的環境變數或機密管理程式中。 - 絕不將其嵌入瀏覽器程式碼、行動應用程式套件、原始碼控制系統、日誌、範例或提示詞中。
- 僅在文件範例中使用
YOUR_API_KEY作為佔位符。 - 對於相容的代理程式用戶端，優先使用 OAuth，端點為
https://mcp.tweetapi.com/mcp。 - 在記錄回應資料之前，如果其中可能包含敏感的使用者輸入內容，請先進行遮蔽處理。
確保來源準確性
公開的產品文件涵蓋的範圍比此技能更廣。請勿推斷每個記錄在案的端點在這裡都允許使用。請勿自行編造 OpenAPI URL、Postman 集合、SDK 方法或 MCP 工具名稱。請從來源參考文件中驗證最新細節。
當來源之間存在衝突時，請報告衝突，並在解決之前避免進行即時呼叫。