用途：在 Weaverse Studio 之外通过认证 REST API 读写项目、页面、主题设置和翻译，用于批量编辑、AI/自动化内容流水线、草稿→发布流程以及定时或版本化内容变更。基础地址为 https://studio.weaverse.io/api/v1/content，机器可读规范见 GET https://studio.weaverse.io/api/v1/content/openapi.json（OpenAPI 3.1，无需认证）。
主要能力：读取项目、页面、主题设置、版本、草稿和翻译单元；实时 PATCH 页面条目与主题设置；以草稿暂存后发布、定时或丢弃；创建自定义页面或资源模板页；批量删除页面；管理项目生命周期（创建/复制/删除/设置）；读写按语言翻译；上传图片/视频到 Shopify 并引用其 CDN URL。
使用方式：除 openapi.json 外所有端点需 Bearer 令牌，Authorization: Bearer <WEAVERSE_API_KEY>，密钥从 Studio 的 Account/Settings → API Keys 获取，存入环境变量，勿硬编码或作为查询参数。作用域包括 content:read、content:write、content:publish、content:delete、project:manage、translations:read/write。核心实时更新流程：先 GET /projects 找项目，GET /projects/:projectId/languages 选语言，GET 页面并保留 updatedAt，再 PATCH 页面（每请求最多 100 项，条目需 id 与 data，新条目需新 id 和 type），携带 expectedUpdatedAt 防并发。草稿流程按 pageId 寻址，PUT 保存草稿（≤200 项），POST /publish-versions/:versionId 发布。
适用场景：向现有项目推送 AI 生成或翻译文案、跨页批量编辑、读取内容做差异对比、新增类型化条目、创建页面、暂存后发布/定时/丢弃、恢复版本、读写翻译、创建或复制项目、批量删除页面、上传媒体。
限制：密钥仅限单个店铺，跨店铺请求返回 403/404；缺失作用域返回 403 INSUFFICIENT_SCOPE；委托 MCP OAuth 令牌写入必须携带修订令牌，否则 428；页面过期返回 409 STALE_PAGE，需重读后重试；恢复版本需 content:publish 与 content:delete 及 confirm 字符串；定时发布会在 publishAt 自动生效；翻译写入仅影响 Translation 行，项目默认语言不可作为目标；部分端点细节见 references/endpoints.md 与 references/portable-text.md，辅助脚本为 scripts/weaverse_content_api.mjs（零依赖，Node 18+）。