publish-blog

/digital-marketing-pro:publish-blog

脚本位置。 如果你的宿主未设置 ${CLAUDE_PLUGIN_ROOT}，脚本位于此插件的 scripts/ 文件夹中，与 skills/ 相邻。请使用 Python 3.10 或更高版本运行：python；如果找不到 python，则使用 python3（macOS 和许多 Linux 系统）。

用途

将经过全面优化的博客文章发布到品牌的 CMS（WordPress 或 Webflow），并设置 SEO 元数据、分类和标签、特色图片，以及可选的定时发布。包含发布前的质量检查，用于评估内容得分和品牌语气一致性；还包括发布后的验证，以确认线上 URL 可访问且渲染正常。此功能旨在作为内容工作流的最后一步，在执行所有优化检查后，将草稿从就绪状态转为正式上线。

执行关卡（强制 — 不可跳过）

1. 在触及任何线上系统之前，先将完整预览——收件人／支出／变更／合规性——作为 执行摘要 呈现。
2. 用户必须输入 yes（或明确表示批准的等效内容）。任何其他输入——含糊、暗示、部分批准或未提供批准——都会取消本次运行。
3. 遇到含糊输入时，绝不继续。执行失败后，绝不自动重试；重新运行前必须由人工审核失败原因。
4. 只有用户输入 yes 后，才记录批准：python "${CLAUDE_PLUGIN_ROOT}/scripts/approval-manager.py" --brand {slug} --action create-approval --data '{"type":"publish-blog","platform":"<platform>","content_summary":"<one line from the Execution Summary>","risk_level":"<tier>"}'，然后运行 python "${CLAUDE_PLUGIN_ROOT}/scripts/approval-manager.py" --brand {slug} --action approve --id {approval_id}。如果任一命令报错，请停止并报告错误；绝不要通过其他工具绕过。此记录可证明针对本次操作执行了批准步骤，但无法证明是谁输入了 yes。
5. 执行。通过 connector_executor.py 发送的写入请求需要 --approval-id，且只有匹配的、未使用且未过期的记录才会触发（参见 /digital-marketing-pro:execute-action）。通过已连接的 MCP 服务工具进行的写入不受该代码检查约束：此类写入依赖用户输入的 yes 和宿主的权限提示。之后运行 python "${CLAUDE_PLUGIN_ROOT}/scripts/approval-manager.py" --brand {slug} --action mark-executed --id {approval_id} --data '{"execution_result":"success"}'（或 failure）。

所需输入

用户必须提供（或将收到提示填写）以下内容：

• 博客内容：完整的博客文章草稿或待润色的粗略草稿——标题、正文、所有内嵌图片或嵌入内容，以及引用块或提示框
• 目标 CMS 平台：要使用的发布平台——WordPress 或 Webflow，且必须已连接相应的 MCP 服务
• 发布日期：立即发布，或指定日期、时间和时区；定时发布使用平台原生的排期功能
• 分类和标签：用于组织内容和提升可发现性的内容分类和分类法标签；也可以根据内容分析和现有分类法自动推荐
• 特色图片：用于生成图片的文件路径、URL 或描述——将作为主图和社交分享缩略图（Open Graph 和 Twitter Card）
• SEO 元数据：主要关键词、次要关键词、meta 标题（50-60 个字符）、meta 描述（150-160 个字符）；也可以根据内容分析和关键词策略请求自动生成
• 作者署名：如果作者不同于 CMS 中配置的默认品牌作者，请提供作者姓名和简介链接
• Slug 偏好：自定义 URL slug，或根据标题自动生成，并进行关键词优化和停用词移除
• 内链：指定文章中要链接到的站内页面，或允许根据现有网站内容自动发现链接机会
• 社交分享文案：自定义 Open Graph 标题和描述，用于社交媒体预览；也可以根据 meta 标题和描述自动生成
• 内容格式：文章格式——标准文章、清单文章、操作指南、案例研究或思想领导力文章——决定 Schema 标记类型和结构要求
• 摘要：用于归档页面、RSS Feed 和社交卡片的 1-2 句摘要，也可以根据开头段落自动生成
• 相关文章：可选——指定要在文章末尾作为相关内容链接的文章，或根据分类和主题重合度自动发现
• CTA 区块：可选——要添加到文章末尾的自定义行动号召区块（订阅简报、试用产品、内容升级、预约咨询）

流程

1. 加载品牌上下文：读取 ~/.claude-marketing/brands/_active-brand.json 获取当前品牌 slug，然后加载 ~/.claude-marketing/brands/{slug}/profile.json。应用品牌语气、目标市场的合规规则（skills/context-engine/compliance-rules.md）和行业背景。同时检查 ~/.claude-marketing/brands/{slug}/guidelines/_manifest.json 中是否有指南——如果存在，则加载相关限制。检查 ~/.claude-marketing/sops/ 中是否有代理机构的标准操作流程（SOP）。如果没有品牌，请询问：“先设置品牌吗（/digital-marketing-pro:brand-setup）？”——或者使用默认设置继续。
2. 验证 CMS 连接：检查已连接的 CMS MCP 服务（wordpress 或 webflow），并确认它与用户指定的平台一致。如果未连接，请指导用户先配置 MCP 服务，并提供相关设置链接。
3. 评估内容质量：对博客草稿运行 content-scorer.py，评估可读性（Flesch-Kincaid 年级水平）、结构（标题层级、段落长度、列表使用情况）、深度（字数与主题复杂度是否匹配）和吸引力。标出发布前需要修正的问题。
4. 评估品牌语气一致性：运行 brand-voice-scorer.py，验证内容是否符合品牌的语气、词汇和信息传达指南。如果分数低于 profile.json 中定义的品牌最低阈值，请提出具体修改建议。
5. 优化 SEO：确保主要关键词出现在标题、H1、前 100 个词、URL slug 和元描述中。确认元描述为 150-160 个字符，元标题为 50-60 个字符。检查内部链接机会、图片 alt 文本和标题中的关键词使用情况。验证结构化数据标记是否兼容内容类型（文章、操作指南、FAQ）。
6. 按平台 API 格式整理内容：根据目标 CMS 的要求组织内容负载——参阅 skills/context-engine/platform-publishing-specs.md，了解字段映射、HTML 格式、图片处理、分类/标签分类法 ID、特色图片上传、Open Graph 元字段，以及平台特定的注意事项，例如 WordPress 自定义字段或 Webflow CMS 集合结构。
7. 运行合规检查：验证内容是否符合品牌目标市场的监管要求，包括披露声明、联盟链接免责声明、医疗或金融免责声明，以及对引用的第三方内容或图片进行版权归属标注。
8. 创建审批记录：通过 approval-manager.py --action create-approval 创建记录，并在 --data JSON 中包含风险等级——{"type":"publish-blog","platform":"<platform>","content_summary":"...","risk_level":"medium"}。没有 --risk-level 标志；确切命令请参阅上方的执行门槛。生成发布前摘要，显示标题、URL slug、发布时间、SEO 分数、品牌语气分数、内容质量分数、分类、标签、特色图片预览和合规状态。
9. 展示发布前摘要：显示完整摘要，供用户审核和批准。突出显示内容评分、SEO 分析或合规检查中的任何警告。并排展示文章在搜索结果和社交分享卡片中的预览。等待用户明确确认后再继续。
10. 通过 CMS MCP 执行发布：获得批准后，通过已连接的 MCP 服务将格式化后的内容负载发送至 CMS。如果指定了未来的发布时间，则安排发布。确认 API 响应表明操作成功。
11. 验证线上 URL：发布后，通过 CMS API 获取线上 URL，并验证其返回 200 状态。确认标题、元描述、特色图片、规范 URL 和 Open Graph 标签均正确呈现。检查页面是否未被 robots.txt 或 noindex 标签屏蔽。
12. 验证结构化数据标记：确认已发布页面包含正确的结构化数据（Article、HowTo、FAQ 或 BreadcrumbList），并通过验证，符合搜索结果富媒体摘要的展示条件。
13. 提交至搜索引擎：如果品牌已连接 Google Search Console，则提交新 URL 以加快收录。记录提交时间戳。
14. 记录执行并保存洞察：运行 execution-tracker.py，记录发布事件的时间戳、平台、URL、分数和分类。保存一条关于已发布内容的洞察——包括主题、关键词、效果预测——供未来内容策略参考并进行内容差距分析。

输出

包含以下内容的结构化发布确认：

• 已发布 URL：博客文章可访问的正式发布或定时发布 URL，并确认规范 URL 正确
• SEO 评分：内容 SEO 评分及细项——关键词位置、元标题和描述质量、内链数量、图片替代文本覆盖率、标题结构和 URL 别名优化
• 品牌语调评分：品牌调性契合度评分，并说明语气、词汇、信息传达一致性，以及优化期间所做的调整
• 内容质量评分：可读性等级（Flesch-Kincaid）、结构评估（标题层级、段落平衡）、字数和互动潜力评级
• 发布前检查清单结果：每项质量关卡的通过/失败状态——内容评分、品牌语调、SEO 优化、合规审查和平台格式验证
• 发布详情：平台、发布状态（已发布或定时发布及日期）、作者、分类、标签、特色图片确认、规范 URL 和 Open Graph 预览
• 社交分享预览：文章在 Facebook、Twitter/X 和 LinkedIn 上的分享呈现效果——包括 Open Graph 图片、标题和描述的显示效果
• 合规状态：验证是否已根据品牌所在市场的法规加入所有必需的免责声明、披露和署名
• 结构化数据标记验证：应用的结构化数据类型、验证状态，以及该内容格式是否符合富媒体摘要展示资格
• 搜索引擎提交：通过 Google Search Console 提交的索引请求状态（如果已连接）及提交时间戳
• 性能基线：初始指标快照——页面加载时间、Core Web Vitals 分数和抓取状态，作为发布后性能监控的基线
• 已关联的相关文章：文章末尾关联的相关内容列表，包含标题和 URL，以促进站内流量
• CTA 区块确认：文章末尾呈现的行动号召区块，包含类型、文案和目标 URL
• 执行日志条目：带时间戳的发布操作记录，包含审计跟踪和性能追踪所需的全部元数据

使用的 Agent

• content-creator — 内容质量评分、SEO 优化、品牌语调对齐、关键词位置、元描述撰写、内链建议、结构化数据标记指导和社交分享文案生成
• execution-coordinator — 审批工作流、CMS API 执行、发布后验证、正式发布 URL 验证、执行日志记录，以及内容策略洞察收集