WordPress Publisher

通过 REST API 直接向 WordPress 站点发布内容，完整支持 Gutenberg 区块格式、自动分类选择、SEO 标签生成及预览功能。

完整工作流概览

1. CONNECT    → 与 WordPress 站点完成身份认证
2. ANALYZE    → 加载站点分类，并分析内容以匹配最合适的分类
3. GENERATE   → 基于内容生成 SEO 优化的标签
4. CONVERT    → 将 Markdown/HTML 转换为 Gutenberg 区块
5. PREVIEW    → 创建草稿并验证渲染效果
6. PUBLISH    → 发布或定时发布文章
7. VERIFY     → 确认线上文章渲染正确无误

第 1 步：连接配置

获取凭据

请用户提供以下信息：

• WordPress 站点 URL（例如：https://example.com）
• WordPress 用户名
• 应用密码（非常规登录密码）

如何创建应用密码

指导用户操作：

1. 进入 WordPress 后台 → 用户 → 个人资料
2. 滚动至 应用密码 区域
3. 输入名称：Claude Publisher
4. 点击 添加新应用密码
5. 复制生成的密码（仅显示一次，含空格）

测试连接

from scripts.wp_publisher import WordPressPublisher

wp = WordPressPublisher(
    site_url="https://example.com",
    username="admin",
    password="xxxx xxxx xxxx xxxx xxxx xxxx"  # 应用密码
)

# 测试连接
user_info = wp.test_connection()
print(f"已登录用户：{user_info['name']}")

第 2 步：加载并选择分类

自动从站点加载分类

# 从 WordPress 站点获取全部分类
categories = wp.get_categories_with_details()

# 返回示例：
# [
#   {'id': 1, 'name': 'Uncategorized', 'slug': 'uncategorized', 'count': 5},
#   {'id': 2, 'name': 'Tutorials', 'slug': 'tutorials', 'count': 12},
#   {'id': 3, 'name': 'Cloud Hosting', 'slug': 'cloud-hosting', 'count': 8},
# ]

智能分类选择

系统将分析内容并自动推荐最匹配的分类：

# 分析内容并推荐最佳分类
suggested_category = wp.suggest_category(
    content=article_content,
    title=article_title,
    available_categories=categories
)

# 或由用户从可用选项中手动选择
print("可用分类：")
for cat in categories:
    print(f"  [{cat['id']}] {cat['name']} ({cat['count']} 篇文章)")

分类选择逻辑

1. 精确匹配 — 标题或内容中包含该分类名称
2. 关键词匹配 — 分类 slug 与主题关键词一致
3. 父级分类回退 — 若无匹配项，则回退至更宽泛的父分类
4. 新建分类 — 若无合适分类，则在用户确认后新建（需用户批准）

第 3 步：生成 SEO 优化标签

自动标签生成

生成有助于提升 Google 搜索可见性的标签：

# 基于内容分析生成标签
tags = wp.generate_seo_tags(
    content=article_content,
    title=article_title,
    max_tags=10
)

# 返回示例：
# ['n8n hosting', 'workflow automation', 'self-hosted n8n', 
#  'affordable hosting', 'docker deployment', 'node.js hosting']

标签生成规则

1. 主关键词 — 始终作为首个标签
2. 次级关键词 — 包含 2–3 个相关术语
3. 长尾关键词 — 包含 3–4 个具体短语
4. 实体标签 — 包含正文中提及的产品/品牌名称
5. 主题标签 — 包含更宽泛的类别术语

在 WordPress 中获取或创建标签

# 获取或创建所有标签，返回标签 ID 列表
tag_ids = wp.get_or_create_tags(tags)

第 4 步：将内容转换为 Gutenberg 区块

Markdown 转 Gutenberg

from scripts.content_to_gutenberg import convert_to_gutenberg

# 转换 Markdown 内容
gutenberg_content = convert_to_gutenberg(markdown_content)

支持的转换类型

表格转换（AI 内容的关键环节）

表格将被转换为符合 Gutenberg 规范的结构：

# 输入 Markdown：
| Feature | Plan A | Plan B |
|---------|--------|--------|
| Price   | $10    | $20    |

# 输出 Gutenberg：


  
Feature
Plan A
Plan B
  
Price
$10
$20

第 5 步：发布前预览

创建草稿用于预览

# 首先创建为草稿
result = wp.create_draft(
    title="Article Title",
    content=gutenberg_content,
    categories=[category_id],
    tags=tag_ids,
    excerpt="自动生成或自定义摘要"
)

post_id = result['post_id']
preview_url = result['preview_url']
edit_url = result['edit_url']

验证预览效果

# 获取预览页面以验证渲染结果
preview_content = wp.fetch_preview(post_id)

# 检查潜在问题
issues = wp.validate_rendered_content(preview_content)
if issues:
    print("发现问题：")
    for issue in issues:
        print(f"  - {issue}")

预览检查清单

• 标题显示正确
• 所有标题层级（H2/H3/H4）均正常渲染
• 表格按预期格式渲染
• 列表正确显示（项目符号和编号列表）
• 代码块具备语法高亮
• 图片正常加载（如存在）
• 链接可点击
• 分类显示正确
• 标签在文章中显示

第 6 步：发布文章

发布草稿

# 经预览确认后发布
result = wp.publish_post(post_id)
live_url = result['live_url']

或一次性创建并发布

# 单次调用完成全流程发布
result = wp.publish_content(
    title="Article Title",
    content=gutenberg_content,
    category_names=["Cloud Hosting"],  # 按名称传入，自动解析为 ID
    tag_names=["n8n", "hosting", "automation"],
    status="publish",  # 或 "draft"、"pending"、"private"、"future"
    excerpt="面向 SEO 的自定义摘要",
    slug="custom-url-slug"
)

定时发布

# 设置未来发布时间
from datetime import datetime, timedelta

publish_date = datetime.now() + timedelta(days=1)
result = wp.publish_content(
    title="Scheduled Post",
    content=content,
    status="future",
    date=publish_date.isoformat()
)

第 7 步：验证已发布文章

检查线上文章

# 验证已发布的文章
verification = wp.verify_published_post(post_id)

print(f"线上地址：{verification['url']}")
print(f"状态：{verification['status']}")
print(f"分类：{verification['categories']}")
print(f"标签：{verification['tags']}")

常见问题与修复方案

完整示例工作流

from scripts.wp_publisher import WordPressPublisher
from scripts.content_to_gutenberg import convert_to_gutenberg

# 1. 连接
wp = WordPressPublisher(
    site_url="https://xcloud.host",
    username="admin",
    password="xxxx xxxx xxxx xxxx"
)

# 2. 加载分类并选择最优匹配
categories = wp.get_categories_with_details()
best_category = wp.suggest_category(content, title, categories)

# 3. 生成 SEO 标签
tags = wp.generate_seo_tags(content, title, max_tags=10)

# 4. 转换为 Gutenberg 区块
gutenberg_content = convert_to_gutenberg(markdown_content)

# 5. 创建草稿并预览
draft = wp.create_draft(
    title="7 Best n8n Hosting Providers in 2026",
    content=gutenberg_content,
    categories=[best_category['id']],
    tags=wp.get_or_create_tags(tags)
)
print(f"预览地址：{draft['preview_url']}")

# 6. 经验证后发布
result = wp.publish_post(draft['post_id'])
print(f"已发布：{result['live_url']}")

快速参考

API 端点

文章状态

必需文件

• scripts/wp_publisher.py — 主发布器类
• scripts/content_to_gutenberg.py — Markdown/HTML 转换器
• references/gutenberg-blocks.md — 区块格式参考文档

错误处理

最佳实践

1. 始终先预览 — 先创建草稿、验证无误后再发布
2. 使用应用密码 — 切勿使用常规 WordPress 登录密码
3. 选择恰当分类 — 有利于网站组织架构与 SEO 优化
4. 生成相关标签 — 提升 Google 搜索可发现性
5. 校验 Gutenberg 区块 — 确保区块结构符合规范
6. 摘要长度控制在 160 字符以内 — 最适合搜索引擎摘要展示
7. 使用描述性 slug — 在 URL 中包含主关键词