四个 npm 套件是不同的 SDK 吗？
不是。安装 sosoapi 或其别名之一：@sosoapi/cli、sosoapi-cli 或 sosoapi-mcp。每个别名使用完全相同版本的 CLI 和 MCP 实现。只需安装一个。
我该使用 HTTP、CLI 还是 MCP？
在服务器中使用 HTTP，用 CLI 进行 shell 自动化和检查 schema，或通过兼容 agent 使用 MCP。它们使用相同的公开 API 契约。MCP 还提供本地文件上传，以及为你处理媒体准备的图片 URL 发帖工具。不要让服务器凭证出现在浏览器代码中。
设置或 OAuth 同意会发布帖子吗？
不会。设置不会发布任何内容。OAuth 同意会在所选范围内授予持续访问权限，不会为每次写入要求新的浏览器批准。请告知 agent 何时等待审核，并在要求发布前检查账号、内容和时间。
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 服务仍自行决定收录、排名或引用哪些内容。请将这些结果与页面是否可访问分开检查。