四個 npm 套件是不同的 SDK 嗎？
不是。安裝 sosoapi 或其別名之一：@sosoapi/cli、sosoapi-cli 或 sosoapi-mcp。每個別名使用完全相同版本的 CLI 和 MCP 實作。只需安裝一個。
我該使用 HTTP、CLI 還是 MCP？
在伺服器中使用 HTTP，用 CLI 進行 shell 自動化和檢查 schema，或透過相容代理程式使用 MCP。它們使用相同的公開 API 契約。MCP 還提供本機檔案上傳，以及為您處理媒體準備的圖片 URL 發布貼文工具。不要讓伺服器憑證出現在瀏覽器程式碼中。
設定或 OAuth 同意會發布貼文嗎？
不會。設定不會發布任何內容。OAuth 同意會在所選範圍內授予持續存取權限，不會為每次寫入要求新的瀏覽器核准。請告知代理程式何時等待審核，並在要求發布前檢查帳號、內容和時間。
HTTP 200 或 202 表示已發布嗎？
不代表。請求可能已接受、已排程或仍在處理中。請儲存貼文 ID，並讀取同一則排程貼文，直到其結果確認已發布。若可取得永久連結，請一併提供，並分別回報各目標結果。
逾時後可以重試嗎？
先檢查既有操作。保留排程貼文 ID，對相同請求重複使用相同冪等鍵。變更承載內容就代表不同請求。若要重試、更新或取消既有貼文，請使用其目前版本，以及 SosoAPI 針對該狀態提供的操作。
為什麼用戶端裡缺少某個工具？
檢查設定、連結類型以及用戶端是否已重新載入伺服器。core 隱藏管理工具；HTTP 連結不含本機檔案上傳。工具參考列出可用性。更改設定不會改變帳號權限或資格。
遠端 MCP 可以上傳本機檔案嗎？
不可以。請使用本機 MCP，從允許的資料夾上傳檔案，或透過 HTTP 匯入公開媒體 URL。持續檢查匯入直到就緒，再一起使用已登記素材 ID 與標準 URL。已接受的匯入仍在進行中。
速率與方案限制為何？
請查看每個 schema 的欄位、列表和分頁限制。studio-api 對人工工作階段允許每位使用者每分鐘 240 個請求；該使用者的機器憑證另有每分鐘 480 個請求的獨立配額桶。請遵循 429 和 Retry-After。方案配額、平台限制和帳號資格相互獨立；大量執行前請讀取目前帳務和能力資訊。
Markdown 和 schema 在哪裡？
在指南、API 操作或 MCP 工具 URL 後加入 .md，即可取得 Markdown 版本。API 索引連結至公開 JSON 契約與 OpenAPI 3.1 文件。頁面索引請從 llms.txt 開始，兩種語言的完整參考資料請使用 llms-full.txt。這些檔案包含公開文件，不含帳號資料或憑證。
這些文件保證獲得搜尋收錄或 AI 引用嗎？
不保證。HTML 頁面、標準 URL、結構化中繼資料和 Markdown 有助於系統讀取文件。搜尋引擎和 AI 服務仍自行決定收錄、排名或引用哪些內容。請將這些結果與頁面是否可存取分開檢查。