# 為使用此助理的人設定 SosoAPI 使用本人既有的助理，並保留原始工作、內容與 此對話中的媒體參照。為其已連結的帳號使用同一個 SosoAPI MCP 社群帳號。重複使用現有連結，或選擇本機或託管存取 見下方。設定不會發布貼文。本人登入並選擇 在他們的瀏覽器中授權。絕不輸入他們的憑證或核准同意 為他們。Free 無需信用卡。 ## 1. 連結此助理 先檢查目前宿主及現有 SosoAPI 設定。重複使用 正常工作的連結；不要退出登入、覆寫設定或建立另一個 不要只因重新開啟此指南就重建連線。 對於本機 shell，檢查 Node.js 20 或更高版本及 npx 是否可用。使用 既有支援的執行環境。若缺少，請以淺白 語言；不要自動進行需要權限提升或全域系統變更的操作。 Claude Code： ```sh claude mcp add sosoapi -e SOSOAPI_TOOL_PROFILE=core -- npx -y sosoapi ``` Codex： ```sh codex mcp add sosoapi --env SOSOAPI_TOOL_PROFILE=core -- npx -y sosoapi ``` 登記伺服器後，請檢查您能否在此呼叫其工具 對話。如宿主需要重新連結或重新啟動，請告知本人哪一 應採取的操作。在工具可正常運作前，請勿宣稱連線已就緒。 新連結使用現有 28 個工具的 core 設定進行日常發布， 媒體、留言與洞察。應重複使用正常運作的 full 設定檔連線。 如果缺少所需管理操作，請說明 full 設定檔 是否可用；隱藏工具不會授予或撤銷權限。 對於支援自訂 MCP 應用程式的 ChatGPT 等純瀏覽器用戶端，加入此 遠端 MCP URL，並選擇帶自動用戶端註冊的 OAuth： `https://gqeshlawtcexsapabaui.supabase.co/functions/v1/remote-mcp` 無需貼上 API key、client ID 或 client secret。本人登入 至 SosoAPI，並選擇其 Workspaces／操作。ChatGPT 自訂應用程式取決於 其方案與開發人員模式可用性。重複使用正常運作的本機或遠端 若已設定連線。 X 支援原創文字與連結。每個 Organization 共用 10 個 Free X 額度 一次，或每個 Pro 帳務週期 100。純文字費用為 1；含 URL 的 Post 費用為 10。請讀取 `sosoapi_get_x_usage` 並附上 workspace_id，再規劃 X 使用量。 不會自動收取超額費用；結果不明的發布會保留其額度 預留，必須先核對狀態才能再次傳送。 ## 2. 不使用 API key 登入 第一次需驗證的 MCP 呼叫會開啟既有瀏覽器登入及代理程式 同意流程。本人可使用 Google，或註冊並驗證電子郵件。 讓他們選擇工作空間，並決定助理是否只能準備 內容，還是也能排程和發布。不要要求他們複製憑證。 發布同意在所選範圍內持續有效，並非強制的 為每則貼文顯示核准頁面。日常發布貼文保持關閉 key 管理權限。 電子郵件註冊和登入使用後端安全驗證，無需 核取方塊交由本人完成。如驗證失敗，回報實際 錯誤並使用可用的重試操作；不要要求本人尋找或點選 CAPTCHA 驗證框。現有 **Continue with Google** 選項也可使用 如果本人想使用 Google；Google 可能要求其自行完成身分驗證。 讓本人選擇帳號並核准存取權。 保留目前登入/核准連結及其回傳目標；不要替換 以單純註冊 URL 取代它，或未告知就切換為既有維護者身分。 一次登入錯誤，不足以證明所有登入方式皆不可用。 僅暫停需要本人身分或同意的步驟。在他們 完成它、完成安裝檢查，並準備原始草稿，且不得 虛構帳號或工作空間。說明已就緒的部分以及唯一的 下一步所需操作。登入後，重新讀取已驗證身分的資訊並復原 同一任務。不要停用 CAPTCHA、使用管理員註冊 API、索取權杖， 或在實際流程完成前宣稱帳號／連線已就緒。 如果 MCP 工具需要宿主重新載入，此助理也可使用本機 CLI 助理。執行 `npx -y sosoapi auth status` 先；使用 `npx -y sosoapi auth login` 僅在需要登入時。絕不讀取 憑證檔案或輸出權杖。如果登入開啟了錯誤的瀏覽器使用者設定檔，請停止 先停止該待處理登入，再開始新的 `npx -y sosoapi auth login --no-open`. 本人使用預期的使用者設定檔開啟新輸出的連結，並確認 核准前確認已登入身分。絕不讓兩個個人資料爭用同一連結。 使用 `--help` 先確認已安裝 CLI 中存在此復原旗標； 若不存在，請說明版本限制，不要憑空編造可用的旗標。 CLI 可檢查其內嵌契約： ```sh npx -y sosoapi api contract --summary npx -y sosoapi api contract --route /studio-api/scheduled-posts/ ``` CLI 請求語法為 `sosoapi api post < request.json`. 使用檔案工具撰寫 JSON；不要將使用者內容插入 shell 命令。讀取 http_status 和回應內容，不要只看程序退出 代碼。API 錯誤不代表成功。僅使用以下來源的路由與結構描述 內嵌契約；切勿憑空建立名稱或繞過缺少的能力。 ## 3. 連結本人自己的社群帳號 從 SosoAPI 資訊取得已驗證的 Organization 與 Workspace。 絕不猜測識別碼，也不暗中替換為其他工作空間。如果 若有多個合適品牌，請詢問本人預期使用哪一個。 既有連線健康時請重複使用，否則執行 `npx -y sosoapi connect ` （instagram、threads、facebook、youtube 或 x） 或向本人提供 https://app.sosoapi.ai/connect. 由本人完成平台 同意流程並在瀏覽器中審核確切帳號。回傳後， 重新讀取帳號和發布能力。連結回調並非 發布已獲允許的證明。重複使用原始草稿；不要要求 本人複製內部識別碼或重新建立內容。 ## 4. 完成原本的貼文工作 使用本人的現有請求，或詢問他們想宣傳什麼。不要 虛構測試貼文。展示確切目標帳號、內容、媒體和 第一次提交前的本地日期／時間。時區 未知。讀取目前帳號能力資訊；個人 Instagram 帳號或缺少 平台權限可能需要受支援的帳號類型或重新連結。 X 僅接受原創文字與連結；media 保持空白。X 媒體、回覆、 不支援引用、轉發和討論串發布。 對支援媒體的目標，請在排程前完成登記：本機檔案請使用 sosoapi_upload_asset 在允許的資料夾內；外部 URL 請使用 sosoapi_import_asset_url 並使用 include_asset=true 檢查 sosoapi_get_asset_import_status，直到 限定範圍的匯入就緒。已就緒的 asset.id 會成為 media.asset_id，而 asset.asset_url 成為 media.url；無需另行呼叫 get_asset。 維持相同的匯入識別，遵循重試指引，並在終端狀態停止 失敗。請求成功不代表解碼／匯入已完成。 如進度停滯，先使用該匯入的 job_id 讀取 sosoapi_job_status，再 再次等待。待處理工作可能已包含執行錯誤。服務 設定錯誤需要營運人員處理，而不是再次匯入、新建社群 要求本人提供連結或權限。回報阻礙因素，不要聲稱 圖片已就緒。 一起使用回傳的已登記素材 ID 與標準媒體 URL。切勿 以原始外部 URL 或暫時預覽 URL 替代進行排程。 只有檢查工作空間和識別後，才重複使用現有已就緒素材。 若需要參考性預覽，請使用 sosoapi_get_scheduled_post_eligibility； 此為選用功能，不會取代標準建立／執行驗證。 使用標準排程貼文 工具。一則貼文對應一個目標。重試時重複使用相同的 idempotency_key 完全相同的請求；變更後的草稿是新請求。逾時後， 在採取其他操作前讀取現有貼文。絕不要盲目重送 結果不明的平台寫入。更新、取消與明確重試使用 目前版本及伺服器提供的操作資格。 結果必須區分： - 已排程：已接受指定時間；尚未發布。 - 進行中或核對中：最終結果尚未確認；不要重送。 - 已發布：平台支持的終端結果確認該確切貼文； 在可用時回傳上線連結。 - 失敗或需要注意：說明已知情況與下一個允許操作； 僅在本人必須重新授權時，重新連結受影響的帳號。 多個目標請分別回報。不要將整項工作稱為 僅部分平台成功時，不得宣稱全部成功。若為未來排程，請回傳 貼文 ID 與已接受時間；不要讓對話一直等待到 到期時間或建立輪詢迴圈。回來後，請重新讀取同一批貼文。 本人也可以在以下位置重新查看確切結果 https://app.sosoapi.ai/scheduled-posts/, 使用實際回傳的 ID 由 SosoAPI 提供。該頁需要本人以已授權身分登入。自訂 環境，請改用其明確設定的應用程式來源。 不要承諾喚醒已關閉的助理，或傳送尚 尚未設定和驗證。 ## 參考資料 - 供人閱讀的快速入門： https://app.sosoapi.ai/start - 產品指南： https://sosoapi.ai/zh-tw/docs/quickstart - 支援範圍：Instagram、Threads、Facebook Pages、YouTube，以及 X 原創 文字／連結。格式與權限依帳號而異；其他平台不在 不能只因本人提出要求就視為可用。