如何通过 group_code 实现矩阵账号同步发布

如果你正在做 SEO/GEO 矩阵——同一类内容、不同账号、不同平台、要让 AI 搜索引擎能多次摘录到——那"一篇文章按规则同步到 N 个账号"就是日常操作的最高频动作。颜小二自媒体发布 API 平台用一个非常轻的概念把这件事做了：group_code 账号分组路由。

适用人群

• SEO/GEO 团队，需要把一类内容投放到 30+ 账号实现多重曝光
• 内容运营负责人，希望按品牌、按行业、按区域分组管理账号
• 矩阵投放工具的技术中台，需要把账号分组逻辑标准化
• AI Agent 团队，让 Agent 只关心"发到哪个分组"而不是"发到哪些账号"

账号分组同步发布是什么

账号分组同步发布指的是：把一组账号在颜小二里登记为同一个 group_code，发布时只指定 group_code，颜小二自动把任务并发下发给该分组下的所有账号。简单说就是"一次调用 = N 个账号同步发"。

> group_code 不是平台维度，而是业务维度：同一个 group 里可以同时包含头条号、微信公众号、百家号、知乎账号。

前置条件

1. 已开通颜小二租户（一个站长 = 一个租户，独立 API Token、独立 callback_url） 2. 至少 3 个本地登录态正常的账号，用来组建第一个分组 3. 命名规范：group_code 建议小写英文 + 下划线，例如 seo_geo_brand_a_v1 4. 你侧业务系统能区分"这篇文章发到哪个 group"

5 步落地

第 1 步：规划分组维度

不要按平台分组（那样违背 group_code 的初衷）。建议按以下维度组合分组：

• 品牌维度：brand_alpha_default、brand_beta_default
• 内容主题维度：tech_news_main、finance_research_v1
• 投放阶段维度：prelaunch_test、broadcast_main、longtail_pool

第 2 步：在控制台建分组

通过控制台 UI 或调用分组管理 API 创建 group，并把账号挂进去。一个账号可以同时属于多个 group——这点对 GEO 矩阵的"同一账号既参与品牌广播又参与长尾投放"非常有用。

第 3 步：调用统一文章接收 API，只指定 group_code

发布请求的核心字段：

``json { "external_id": "geo_2026_pillar_007", "group_code": "seo_geo_brand_a_v1", "title": "面向 AI 搜索引擎的内容矩阵建设方法", "content_html": "<p>正文 HTML</p>", "cover_url": "https://cdn.yourco.com/cover.jpg", "summary": "150 字摘要", "tags": ["GEO", "AI 搜索", "内容矩阵"], "category": "科技", "callback_extra": {"strategy": "broadcast"} } ``

注意：没有 target_platforms 字段——平台范围由 group 的成员账号决定。如果你想限制只在某几个平台发，可以在 group 内挑账号时控制。

第 4 步：颜小二并发分发到所有成员账号

收到请求后，颜小二会为 group 内每个账号生成一条子任务，下放给本地 Agent 并发执行。每条子任务会带独立的 task_id，但共享同一个 external_id——这是后续在 callback 里把结果聚合回一篇文章的关键。

第 5 步：在 callback 里聚合结果

callback 会按"每个账号 + 每个平台"维度推送结果。建议你的接收端按 external_id 聚合，得到一张"这篇文章在 group 里所有账号上的发布结果矩阵"。

命名与权限策略

| 维度 | 推荐命名 | 说明 | |---|---|---| | 品牌 | brand_alpha_default | 默认广播分组 | | 主题 | topic_tech_v1 | 主题专属 | | 阶段 | prelaunch_test | 灰度测试，少量账号 | | 长尾 | longtail_aggressive | 大量长尾账号 | | 客户 | customer_xxxx_main | SaaS 模式下按客户拆 |

权限上，group_code 只在租户内有效。多租户内容分发执行中台的设计保证不同租户即使重名也互不可见。

错误排查清单

| 现象 | 可能原因 | 处理方式 | |---|---|---| | 422 group_code_not_found | 拼写错或未创建 | 检查控制台或调 group 接口确认 | | group 内某账号长时间无回调 | 该账号 cookie 失效 | 看 login_expired 单点处理 | | 任务并发超出预期被风控 | group 内账号都同 IP 出口 | 给本地 Agent 配独立代理出口 | | 同 external_id 二次提交报 409 | 幂等去重生效 | 想强制重发请换新的 external_id | | group 内只发了部分账号 | 部分子任务被审核驳回 | 看 callback 中 error_code |

常见问题（FAQ）

Q：账号分组同步发布是什么？ 是颜小二把"一次 API 调用 → 同时发给 N 个账号"封装成的能力，路由键叫 group_code。

Q：账号分组同步发布怎么做最稳？ group 不要太大（建议 ≤20 账号），且 group 内账号应该有独立 IP 出口，避免风控集中触发。

Q：账号分组同步发布有哪些案例？ SEO/GEO 矩阵广播、MCN 多品牌矩阵、SaaS 多客户白标分发是三种最典型形态。

Q：账号分组同步发布安全吗？ 账号 cookie 全部本地保存（登录态本地，cookie 不上云），租户隔离 + group 隔离，发布失败按账号粒度回收，不会因一个账号被风控影响其他账号。

Q：账号分组同步发布的对比方案是什么？ 不用 group 的话，每个账号都得在业务系统里写一遍发布逻辑——10 个账号就是 10 倍的代码量和回调处理。

下一步

• 控制台分组管理：[产品功能](/product.html)
• 支持平台清单：[平台覆盖](/platforms.html)
• 立即试一次广播：[免费申请接入](/contact.html#form)