流程
从编辑器里的一次点击，到公开页的 head。
整条路径都在记者的浏览器中完成。平台只负责保存四个字段并在公开页输出——与它已有的任何字段一样。
01
文章编辑器
记者点击按钮时，脚本读取标题、导语与正文。
02
SEO GEM
返回六个标题；确认之后返回元描述、关键词与结构化数据。
03
四个字段
CMS 随文章保存，并通过自己的 API 返回给前端。
04
公开页
文章 head 中的 title、description、keywords 与 JSON-LD。
启动需要什么
三件事。仅此而已。
这就是全部清单。如果你们的 CMS 已有 SEO 字段，则只剩第一项与第三项。
01
编辑器中的 script 标签
在文章创建与编辑页加入一行。你们 CMS 的所有差异都是该标签的属性——没有定制代码。
02
文章上的四个字段
SEO 标题、元描述、关键词，以及一个用于 Schema.org 的字段。若不存在，像其他字段一样新增并开放给前端。
03
在 head 中输出
前端把这四个字段输出到文章 head。前三个是普通 meta 标签，第四个是结构化数据块。
实际样子
全部工作都在编辑页。
脚本会在 SEO 标题字段上方插入一个按钮和一个面板。页面其他部分不受影响，也绝不会阻塞保存。
<!-- 放在文章创建与编辑页 -->
<script src="https://…/cms-embed.js"
data-api-key="贵门户的密钥"
data-language="zh"
data-editor-type="ckeditor"
data-field-title='[name="heading"]'
data-field-seo-title='[name="seo_title"]'
data-field-meta-desc='[name="meta_description"]'
data-field-keywords='[name="keywords"]'
data-field-schema='[name="schema_org"]'></script>CMS 之间的差异通过属性解决，而不是代码：字段选择器、编辑器类型、语言与文章网址。正因如此，同一段脚本能运行在两套完全不同的系统中——一套基于 CKEditor，一套基于 TinyMCE。若使用第三种编辑器，我们提供适配器，标签保持不变。
四个字段
从 CMS 进入 Google 能理解的 head。
工具给出的长度短于字段上限，始终留有余量。
| CMS 中的字段 | 文章页上的输出 | 工具给出 · 字段接受 |
|---|---|---|
| SEO 标题 | <title> | 最多 75 · 80 字符 |
| 元描述 | <meta name="description"> | 最多 160 · 180 字符 |
| 关键词 | <meta name="keywords"> | 最多 300 · 300 字符 |
| Schema.org | 以 JSON-LD NewsArticle 取代通用块 | 数 KB · textarea |
工具写入的结构化数据包含标题、描述、语言、栏目、发布与修改时间、作者、带标志的出版方、图片、规范网址、关键词，以及取自正文的主题与实体。此后每次保存文章，脚本都会自行刷新修改时间并同步标题、图片与网址——无需任何一次服务调用。
分工
第一篇文章之前，谁做什么。
你们这边
- 文章创建与编辑页上的 script 标签
- 文章上的四个 SEO 字段，保存并开放给前端
- 在公开页 head 中输出这四个字段
- 带测试账号的 staging，用于上线前联合验证
我们这边
- 贵门户的密钥与允许来源配置
- 面向贵市场的语言包，含输出语言校验
- 用于结构化数据的出版方信息——名称、标志、域名
- 在任何人改动你们 CMS 之前，先搭建复刻你们编辑器结构的测试页
- staging 上的联合测试：从标题到公开页的完整流程，约半小时
- 来自 Search Console 与 GA4 的按篇、按栏目效果报告
工具不做什么
边界比你预期的更窄。
不碰文章正文
读取标题、导语与正文；只写入四个 SEO 字段。正文与其他所有字段保持原样。
不阻塞编辑部
若服务无响应，保存与发布照常工作。字段保持原样，记者会看到重试按钮。
不混用门户数据
密钥按门户发放并据此隔离数据。你们编辑部的标题选择历史不会影响任何其他用户的建议。
不收集读者数据
工具看不到门户访客。文章正文由外部 AI 服务商按商业条款处理，这些条款排除将内容用于模型训练。
常见问题
技术团队会问的问题。
实际工作量有多大？
按规格，CMS 侧约一个工作日：两个编辑页上的标签、文章上的四个字段，以及这些字段在 head 中的输出。随后在 staging 上联合测试半小时。在两套不同 CMS 中都是如此。
需要服务端集成吗？
不需要。你们这边不会调用我们的服务，代码里也没有我们的库。一切都发生在记者的浏览器中、编辑页上。
如果我们已经有 SEO 字段呢？
那更好——大部分工作可以省掉。把这些字段的选择器发给我们，直接按现状使用。
支持哪些编辑器？
CKEditor 4 与 5、TinyMCE 5 及以上可立即使用。若使用其他编辑器，请告知具体是哪一种，我们会提供适配器；集成的其余部分不变。
下一步
把你们的编辑器结构发给我们。
我们回寄一个测试页。
在任何人改动你们的 CMS 之前，我们会搭建一个复刻你们编辑器结构的页面，并在其上跑完整流程。之后联合测试才会迁到你们的 staging。