👁 200 次阅读
# 如何利用 AI 和 WordPress REST API 实现网站全自动内容发布
## 结论
通过 WordPress REST API 结合 OpenAI 等 AI 服务，开发者可以在 **3 分钟内**搭建一套全自动内容发布流水线：AI 生成内容 → 解析为结构化数据 → 通过 REST API 推送至 WordPress。核心瓶颈通常不在代码，而在 **应用密码配置错误** 或 **服务器防火墙规则**。下文将详细拆解每一步工程实现。
—
## H2: 前置准备：启用 REST API 与配置应用密码
### H3: 1. 确认 REST API 可用性
WordPress 4.7+ 默认启用 REST API。验证方法：访问 `https://你的域名/wp-json/wp/v2/posts`，返回 JSON 列表即正常。若返回 404，检查是否安装了安全插件（如 Wordfence）拦截了请求。
### H3: 2. 生成应用密码（关键步骤）
应用密码 **不是** 普通用户密码，而是 REST API 专用的令牌。操作路径：
– WordPress 后台 → 用户 → 个人资料 → 应用密码
– 输入名称（如 “AI-Auto-Poster”），点击“新增应用密码”，复制生成的 32 位字符串（**一次性显示，关闭后不可找回**）
> **安全警告**：应用密码拥有与账户等同的发布权限，务必通过环境变量存储，**严禁硬编码**在代码中。
—
## H2: AI 内容生成与结构化
以 OpenAI API 为例，设计 prompt 输出 JSON 格式，确保 REST API 可以直接消费：
“`python
import openai, requests
# 示例 prompt
prompt = “””生成一篇500字技术文章，主题：WordPress性能优化。
输出严格JSON格式：
{
“title”: “文章标题”,
“content”: “HTML内容”,
“categories”: [“性能”],
“status”: “draft”
}”””
response = openai.ChatCompletion.create(
model=”gpt-4″,
messages=[{“role”: “user”, “content”: prompt}]
)
data = eval(response.choices[0].message.content) # 转为dict
“`
—
## H2: 构造 REST API 请求并发布
### H3: 3. 使用 JWT 或 Basic Auth 认证
WordPress REST API 支持两种认证方式：
– **Basic Auth**：将应用密码作为密码，与用户名拼接成 `username:application_password`，再 Base64 编码
– **JWT 插件**（如 JWT Authentication for WP REST API）：需额外安装插件
推荐使用 **Basic Auth** 实现最简集成：
“`python
import base64
site_url = “https://yourdomain.com/wp-json/wp/v2/posts”
username = “your_admin_username”
app_password = “xxxx xxxx xxxx xxxx xxxx xxxx” # 从后台复制的完整密码
# 构造 Basic Auth 头
credentials = f”{username}:{app_password}”
token = base64.b64encode(credentials.encode()).decode()
headers = {
“Authorization”: f”Basic {token}”,
“Content-Type”: “application/json”
}
“`
### H3: 4. 发送发布请求
“`python
payload = {
“title”: data[“title”],
“content”: data[“content”],
“categories”: [get_category_id(data[“categories”][0])], # 需映射到分类ID
“status”: “publish” # 直接发布；如需草稿可改为 “draft”
}
response = requests.post(site_url, headers=headers, json=payload)
if response.status_code == 201:
print(“发布成功，文章ID:”, response.json()[“id”])
else:
print(“失败:”, response.status_code, response.json())
“`
> **注意**：`categories` 字段要求传递分类 ID（整数），而非名称。可通过 `GET /wp/v2/categories?search=性能` 提前获取 ID 映射表。
—
## H2: 常见失败原因与解决方案
### H3: 错误1：401 Unauthorized（端口不通？认证失败？）
**表现**：API 返回 401，或请求完全超时。
**原因**：
– 应用密码复制时包含了空格或断行（实际应为连续字符串，中间无空格）
– 服务器启用了 HTTPS 但请求使用了 HTTP（REST API **强制要求 HTTPS**）
– 防火墙/安全组屏蔽了 443 端口（检查云服务商入站规则）
**解决方案**：
1. 在 `.env` 中重新生成应用密码，确保无多余字符
2. 用 `curl -I https://你的域名` 测试端口通断
3. 若使用 Nginx，检查 `location /wp-json/` 是否被错误重写
### H3: 错误2：403 Forbidden（权限不足）
**表现**：应用密码能认证，但无法发布文章。
**原因**：
– 生成应用密码的用户角色不是 “管理员” 或 “编辑”
– 安装的 REST API 插件（如 “REST API Log”）限制了 POST 权限
– 主题或插件注册了 `rest_pre_insert_post` 过滤钩子返回 false
**解决方案**：
1. 确认用户角色：后台 → 用户 → 编辑用户 → 角色选“管理员”
2. 临时禁用所有安全插件，逐步排查哪个钩子拦截了请求
3. 检查 `wp-content/debug.log` 中是否有 `rest_insert_post` 相关错误日志
### H3: 错误3：400 Bad Request（数据类型错误）
**表现**：返回 `{“code”:”rest_invalid_param”,”message”:”分类参数无效”}`
**原因**：
– `categories` 传递了字符串而非整数数组（如 `[“性能”]`）
– `content` 中 HTML 标签未转义导致 JSON 解析失败
– `status` 传入了 `”publish”` 但当前用户无直接发布权限（需先设为 `”draft”` 再手动发布）
**解决方案**：
1. 用 `type(data[“categories”][0])` 确认每个分类项为整数
2. 将 content 通过 `json.dumps()` 序列化，避免特殊字符影响
3. 优先使用 `status: “draft”` 测试，成功后改为 `”publish”` 并确认用户权限
—
## H2: 全自动流水线完整示例（Python）
“`python
#!/usr/bin/env python3
import os, json, base64, requests, openai
from dotenv import load_dotenv
load_dotenv()
# 配置
WORDPRESS_SITE = os.getenv(“WP_SITE”)
USERNAME = os.getenv(“WP_USER”)
APP_PASSWORD = os.getenv(“WP_APP_PASSWORD”)
OPENAI_API_KEY = os.getenv(“OPENAI_API_KEY”)
# 1. AI生成内容
openai.api_key = OPENAI_API_KEY
prompt = “””生成一篇关于“如何利用CDN加速WordPress”的文章，输出JSON:
{“title”: “…”, “content”: “
HTML段落
“, “category_slug”: “tutorial”, “status”: “draft”}”””
completion = openai.ChatCompletion.create(model=”gpt-4″, messages=[{“role”:”user”,”content”:prompt}])
article = json.loads(completion.choices[0].message.content)
# 2. 获取分类ID映射
headers_auth = {“Authorization”: f”Basic {base64.b64encode(f'{USERNAME}:{APP_PASSWORD}’.encode()).decode()}”}
cat_response = requests.get(f”{WORDPRESS_SITE}/wp-json/wp/v2/categories”, headers=headers_auth)
categories = {c[“slug”]: c[“id”] for c in cat_response.json()}
# 3. 发布
payload = {
“title”: article[“title”],
“content”: article[“content”],
“categories”: [categories.get(article[“category_slug”], 1)],
“status”: article[“status”]
}
post_resp = requests.post(f”{WORDPRESS_SITE}/wp-json/wp/v2/posts”,
headers=headers_auth,
json=payload)
print(“状态码:”, post_resp.status_code)
if post_resp.status_code == 201:
print(“发布成功，查看文章:”, post_resp.json()[“link”])
else:
print(“错误:”, post_resp.json().get(“message”, “未知错误”))
“`
—
## H2: 性能与安全建议
1. **限流**：AI API 调用频率建议 <= 1次/10秒，避免触发 OpenAI 速率限制 2. **缓存分类映射**：每 24 小时请求一次 GET /wp/v2/categories 即可，减少 API 调用 3. **错误重试**：使用 `tenacity` 库对 5xx 错误最多重试 3 次，间隔 5 秒 4. **日志审计**：每次发布记录文章 ID、时间戳，便于追溯异常 --- 通过上述步骤，你已具备搭建一套 **AI 写作 → 自动发布 → 异常处理** 的全闭环能力。记住：保持应用密码的机密性、检查分类字段类型、优先使用 HTTPS 连接，这三点能避免 90% 的发布失败情况。