# 为使用此助手的人设置 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，并选择其 工作区／操作。ChatGPT 自订应用取决于 其套餐与开发者模式可用性。重复使用正常运作的本地或远端 若已设置连接。 X 支持原创文字与链接。每个 组织 共用 10 个 Free X 额度 一次，或每个 Pro 计费周期 100。纯文字费用为 1；含 URL 的 Post 费用为 10。请读取 `sosoapi_get_x_usage` 并附上 workspace_id，再规划 X 使用量。 不会自动收取超额费用；结果不明的发布会保留其额度 预留，必须先核对状态才能再次发送。 ## 2. 不使用 API key 登录 第一次需验证的 MCP 调用会开启现有浏览器登录及 agent 同意流程。当事人可使用 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 错误不代表成功。仅使用以下来源的路由与schema 内嵌契约；切勿凭空创建名称或绕过缺少的能力。 ## 3. 链接本人自己的社交账号 从 SosoAPI 信息获取已验证的 组织 与 工作区。 绝不猜测标识符，也不暗中替换为其他工作区。如果 若有多个合适品牌，请询问本人预期使用哪一个。 现有连接健康时请重复使用，否则执行 `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-hans/docs/quickstart - 支持范围：Instagram、Threads、Facebook Pages、YouTube，以及 X 原创 文字／链接。格式与权限依账号而异；其他平台不在 不能只因本人提出要求就视为可用。