WordPress SEO Publisher

通过 WordPress REST API 发布 SEO 优化文章，自动设置 RankMath Free 版 meta fields（SEO 标题、描述、焦点关键词）。

Requirements

• python3（无需额外 pip 依赖，仅使用标准库）
• WordPress 已安装 RankMath SEO Free
• WordPress 已创建 Application Password
• WordPress functions.php 中已注册 RankMath meta keys（见下方 WordPress 配置）

Directory Structure

scripts/
├── publish_wp_article.py       # 主发布脚本
docs/
├── wordpress-setup.php         # functions.php 代码片段（需手动添加到 WordPress）

Environment Variables

在 ~/.openclaw/workspace-marketing/.env 中配置：

WP_SITE_URL=https://你的域名
WP_USERNAME=WordPress用户名
WP_APP_PASSWORD=xxxx xxxx xxxx xxxx xxxx xxxx
WP_CATEGORY_ID=Articles分类的ID

执行方式

cd ~/.openclaw/workspace-marketing
export $(cat .env | grep "^WP_" | xargs)
python3 skills/wp-seo-publisher/scripts/publish_wp_article.py '\x3Cjson_data>'

JSON 参数定义

RankMath 免费版自动处理的 SEO 功能

以下功能 RankMath 会根据文章内容自动处理，无需通过 API 额外设置：

通过 API 主动设置的字段（3 个）

AI Agent 发布工作流

注意：

• 关键词挖掘阶段已独立，必须委托给 seo-keyword-researcher Skill 处理。
• 文章撰写与排版阶段已独立，必须委托给 seo-content-writer Skill 处理。

本 Skill (wp-seo-publisher) 仅负责「API 发布」与「日志记录」。

1. 读取输入 (Input)：前往目录 ~/.openclaw/workspace-marketing/seo/seo_articles/，寻找并读取最新时间戳且尚未发布的 JSON 文件（例如 2026-05-06_110000.json）。
2. 人工确认 (Approval Gate)：向用户展示即将发布的文章标题、slug 和 status，必须等待用户明确确认后才执行发布。如果用户未指定 status: "publish"，默认以 draft 模式发布。
3. 执行发布 (Execute)：将该 JSON 文件的内容作为参数，传递给 Python 脚本： python3 skills/wp-seo-publisher/scripts/publish_wp_article.py '\x3C读取到的 JSON 内容>'
4. 标记与记录 (Clean up)：
   • 防重复机制：发布成功后，必须将该 JSON 文件重命名，加上 _published 后缀（例如执行 mv 2026-05-06_110000.json 2026-05-06_110000_published.json）。
   • 更新日志：将发布成功的结果与 URL 追加写入 memory/wp-articles-log.md。此日志仅用于本 Skill 的防重复检查和发布审计，不应被其他 Skill 用作数据输入源。

JSON 组装范例

{
  "title": "Top 5 Benefits of Renting Robots for Corporate Events",
  "content": "\x3Ch2>Why More Companies Are Choosing Robot Rental\x3C/h2>\x3Cp>In today's competitive event landscape...\x3C/p>\x3Ch2>1. Cost Efficiency\x3C/h2>\x3Cp>Purchasing a service robot can cost...\x3C/p>\x3Ch2>2. Professional Setup & Support\x3C/h2>\x3Cp>When you rent from a professional provider...\x3C/p>\x3Ch2>3. Cutting-Edge Technology\x3C/h2>\x3Cp>Robot technology evolves rapidly...\x3C/p>\x3Ch2>4. Wow Factor for Guests\x3C/h2>\x3Cp>Nothing captures attention quite like...\x3C/p>\x3Ch2>5. Flexibility and Variety\x3C/h2>\x3Cp>Different events call for different robots...\x3C/p>\x3Ch2>Ready to Elevate Your Next Event?\x3C/h2>\x3Cp>Contact us today for a free consultation and quote. \x3Ca href='https://example.com/contact'>Get in touch →\x3C/a>\x3C/p>",
  "excerpt": "Discover the top 5 reasons why renting robots for corporate events saves money, impresses guests, and delivers cutting-edge experiences.",
  "slug": "benefits-renting-robots-corporate-events",
  "focus_keyword": "renting robots for corporate events",
  "seo_title": "Top 5 Benefits of Renting Robots for Corporate Events | Your Company",
  "seo_description": "Discover the top 5 reasons why renting robots for corporate events saves money, impresses guests, and delivers cutting-edge experiences.",
  "tags": ["robot rental", "corporate events", "service robots", "event technology"],
  "status": "draft"
}

发布记录格式（memory/wp-articles-log.md）

## 2026-05-07
- **Title**: Top 5 Benefits of Renting Robots for Corporate Events
- **URL**: https://example.com/benefits-renting-robots-corporate-events/
- **Focus Keyword**: renting robots for corporate events
- **Tags**: robot rental, corporate events, service robots, event technology
- **Status**: published

主题库（Agent 轮换使用）

1. Robot rental benefits for businesses
2. Industry applications: hospitality
3. Industry applications: retail
4. Industry applications: events & exhibitions
5. Industry applications: healthcare
6. Industry applications: education
7. Event planning with service robots
8. Robot technology trends and innovations
9. FAQ: robot rental process, pricing, setup
10. Cost analysis: buying vs renting robots
11. Customer engagement with robots
12. Future of service robotics in Hong Kong
13. How to choose the right robot for your event
14. Robot safety and insurance considerations
15. Success stories: robots at corporate events

WordPress 配置（一次性设置）

必要步骤

1. 安装 RankMath Free → Plugins → Add New → 搜索 Rank Math SEO
2. 创建 Application Password → Users → Profile → Application Passwords
3. 注册 meta keys → 将 docs/wordpress-setup.php 中的代码添加到主题 functions.php
4. 记录分类 ID → Posts → Categories → 找到 Articles 的 ID

返回值

成功时输出：

✅ Article published successfully!
  Post ID:        123
  URL:            https://example.com/your-article-slug/
  Status:         publish
  Focus Keyword:  your keyword

__RESULT_JSON__:{"success":true,"post_id":123,"url":"...","status":"publish",...}

失败时返回非零退出码，并输出错误信息。

注意事项

1. 首次使用建议用 status: "draft" 测试，在 WordPress 后台确认 RankMath 数据正确
2. 确保 WordPress 启用 HTTPS，否则 Application Password 不安全
3. 文章内容必须有实质价值，不要生成低质量 SEO spam
4. 每篇文章的 slug 必须唯一，避免冲突
5. focus_keyword 应与文章主题一致，这会影响 RankMath 的内容评分