AgentSkillsCN

wordpress-seo-optimizer

WordPress 文章 SEO 优化技能。当用户需要对已发布的 WordPress 文章进行 SEO 优化时,可使用此技能,包括:获取文章列表、分析文章内容、依据 SEO 最佳实践优化标题与内容、更新文章(需手动确认)。适用场景:当用户提及“WordPress 文章 SEO 优化”、“优化文章标题”、“根据 SEO 指南优化内容”、“批量优化 WordPress 文章”或类似需求时。

SKILL.md
--- frontmatter
name: wordpress-seo-optimizer
description: WordPress文章SEO优化技能。当用户需要对已发布的WordPress文章进行SEO优化时使用此技能,包括:获取文章列表、分析文章内容、根据SEO最佳实践优化标题和内容、更新文章(需手动确认)。使用场景:用户提及"WordPress文章SEO优化"、"优化文章标题"、"根据SEO指南优化内容"、"批量优化WordPress文章"或类似需求时。

WordPress文章SEO优化技能

此技能提供了一套完整的WordPress文章SEO优化工作流程,包括获取文章、分析内容、应用SEO优化建议和更新文章。

凭证配置

使用此技能前需要提供WordPress站点凭证:

  • SITE_URL: WordPress站点URL(如 https://example.com
  • USERNAME: WordPress管理员用户名
  • PASSWORD: WordPress应用程序密码或登录密码

重要提示:凭证不会存储在代码中,每次使用时由用户提供或从环境变量读取。

工作流程

步骤1:获取文章列表

使用 scripts/wordpress_client.py 中的 get_posts_list 函数获取需要优化的文章:

python
from scripts.wordpress_client import get_posts_list

result = get_posts_list(
    site_url="https://example.com",
    username="admin",
    password="your_password",
    post_status="publish",  # 或 "draft", "pending"
    number=10,
    offset=0,
    search=None,  # 可选:搜索关键词
    category_id=None  # 可选:分类ID筛选
)

返回结果包含:

  • success: 是否成功
  • posts: 文章列表
  • count: 文章数量

每篇文章包含:

  • post_id: 文章ID
  • title: 标题
  • content: 内容
  • excerpt: 摘要
  • categories: 分类
  • tags: 标签
  • custom_fields: 自定义字段

步骤2:获取文章详情

使用 get_article_detail 函数获取单篇文章的完整信息:

python
from scripts.wordpress_client import get_article_detail

detail = get_article_detail(
    site_url="https://example.com",
    username="admin",
    password="your_password",
    post_id=123
)

步骤3:应用SEO优化,使用AI大模型对文章的原始内容做SEO优化

参考以下SEO指南进行优化:

3.1 标题优化(SEO审计要点)

  • 长度控制:50-60个字符,确保在搜索结果完整显示
  • 关键词位置:核心关键词前置
  • 唯一性:每个页面标题唯一
  • 吸引力:表述具备吸引力,能提升点击率
  • 品牌名:通常置于标题末尾

3.2 元描述优化

  • 长度控制:150-160个字符
  • 关键词:包含核心关键词
  • 行动号召:加入明确的行动号召语句
  • 价值传达:清晰传达页面核心价值

3.3 内容优化

  • 关键词密度:核心关键词出现在文本前100词内
  • 标题层级:H1→H2→H3依次递进,每页仅一个H1
  • 内容深度:质量优于竞品页面,精准匹配用户搜索意图
  • E-E-A-T:体现体验、专业性、权威性、可信度

3.4 程序化SEO策略

参考 programmatic-seo.md 了解:

  • 12大程序化SEO实战方案
  • 模板方案、精选方案、对比方案等
  • 本地化、人群细分策略
  • 质量审核标准

3.5 技术SEO要点

参考 seo-audit.md 了解:

  • 可抓取性与可索引性检查
  • 网站速度与核心网页指标
  • 移动端适配性
  • 规范化处理
  • 内部链接架构

步骤4:更新文章(需手动确认)

重要:更新文章前必须向用户展示优化后的内容,并获得手动确认。

使用 update_article 函数更新文章:

python
from scripts.wordpress_client import update_article

result = update_article(
    site_url="https://example.com",
    username="admin",
    password="your_password",
    post_id=123,
    title="优化后的标题",  # 可选
    content="<p>优化后的内容</p>",  # 可选
    excerpt="优化后的摘要",  # 可选
    tags=["标签1", "标签2"],  # 可选
    seo_title="SEO标题",  # 可选
    seo_keywords="SEO关键词",  # 可选
    seo_description="SEO描述"  # 可选
)

更新前检查清单

  • 向用户展示优化前后的对比
  • 获得用户明确确认
  • 验证标题长度(50-60字符)
  • 验证元描述长度(150-160字符)
  • 检查H1标签唯一性
  • 检查关键词位置
  • 确认内容质量提升

批量优化工作流

当需要批量优化多篇文章时:

python
from scripts.wordpress_client import get_posts_list, get_article_detail, update_article

# 配置凭证
SITE_URL = "https://example.com"
USERNAME = "admin"
PASSWORD = "your_password"

# 获取文章列表
posts_result = get_posts_list(
    site_url=SITE_URL,
    username=USERNAME,
    password=PASSWORD,
    post_status="publish",
    number=10
)

if posts_result['success']:
    for post in posts_result['posts']:
        post_id = post['post_id']

        # 获取文章详情
        detail = get_article_detail(SITE_URL, USERNAME, PASSWORD, post_id)

        if detail['success']:
            # 分析并优化内容
            optimized_title = optimize_title(detail['title'])
            optimized_content = optimize_content(detail['content'])
            optimized_excerpt = optimize_excerpt(detail['excerpt'])

            # 展示给用户确认
            show_preview_and_confirm(detail, optimized_title, optimized_content, optimized_excerpt)

            # 用户确认后更新
            if user_confirmed():
                update_article(
                    site_url=SITE_URL,
                    username=USERNAME,
                    password=PASSWORD,
                    post_id=post_id,
                    title=optimized_title,
                    content=optimized_content,
                    excerpt=optimized_excerpt
                )

常见SEO问题检查

标题问题

  • ❌ 标题重复
  • ❌ 标题过长(被截断)
  • ❌ 标题过短(浪费机会)
  • ❌ 关键词堆砌

内容问题

  • ❌ 内容单薄
  • ❌ 缺少H1标签或多个H1
  • ❌ 标题层级混乱
  • ❌ 关键词缺失

技术问题

  • ❌ 缺少元描述
  • ❌ 缺少规范标签
  • ❌ 内部链接不足
  • ❌ 图片缺少alt文本

错误处理

当操作失败时,检查:

  1. 凭证错误:验证用户名和密码是否正确
  2. 网络问题:检查站点URL是否可访问
  3. 权限问题:确认用户具有编辑文章的权限
  4. SSL问题:如遇证书错误,WordPressPublisher 默认不验证SSL

参考文件

注意事项

  1. 备份数据:批量更新前建议备份WordPress数据库
  2. 渐进式更新:先测试少量文章,确认效果后再批量处理
  3. 保留价值:不要删除原有的优质内容,在现有基础上优化
  4. 关键词研究:优化前进行关键词研究,确保目标关键词有价值
  5. 用户体验优先:SEO优化应服务于用户体验,而非牺牲可读性