AI元描述撰写器

为什么需要这个技能

在优化页面时，元描述（meta description）往往是最先被搜索引擎展示的部分。它直接出现在搜索结果标题下方，对点击率的影响往往高于页面正文里的某一段文案。然而，大多数团队在写元描述时面临两个难题：

• 人工撰写效率低：不同页面需要不同的描述，复制粘贴容易导致描述重复。
• 难以兼顾长度限制：Google 对 meta description 的截断没有固定规则，过长的文本会被省略号截断，过短又无法传达足够信息。

本技能用于自动生成符合 SEO 规范且长度可控的元描述，减少人工迭代次数。

技能的核心能力

技能的核心逻辑基于 OpenAI Chat Completions API，并在生成后通过两套外部系统验证效果：

• 生成阶段：将页面内容与目标关键词传入模型，输出一段针对点击优化的短文本。
• 长度控制：内置 token 感知截断 机制。模型输出会按照 token 边界进行截断，避免在随机字符处断裂。
• Yoast SEO 集成：通过 REST API 字段校验元描述是否符合 Yoast 对长度、关键词使用和可读性的要求。
• SERP 预览验证：借助 Google SERP Preview 模拟搜索结果中实际展示的片段，确认描述不会被意外截断。

典型调用流程如下：

1. 向 /chat/completions 发起请求，附带页面标题、正文摘要或结构化数据作为上下文。
2. 对模型返回的文本执行 token 截断，将长度限制在安全范围内。
3. 将结果写入 Yoast SEO 的对应字段，通过 REST API 校验是否触发警告。
4. 将生成的描述提交到 SERP 预览工具，检查关键词位置、显示长度和吸引力。

适用边界与注意事项

• 依赖上游 API：技能需要可用的 OpenAI API Key，调用频率受上游账户额度限制。
• 模型输出不保证稳定：不同 prompt 或上下文可能导致生成质量波动，建议配合关键词约束或多轮采样。
• SERP 展示具有动态性：Google 会根据用户查询、设备和搜索历史调整展示片段，预览结果不能保证在所有场景下一致。
• 不自动发布：技能本身只负责生成和验证文案，最终写入数据库或页面仍需通过你的内容发布流程完成。
• Yoast 兼容性：不同版本的 Yoast SEO 对字段长度的判定标准略有差异，建议在集成时先在测试环境验证字段行为。