SEO Workbench — OpenClaw / Claude Skill

一站式 SEO 工具台：从关键词规划到内容分析到转化率优化，全流程覆盖。

---

能力矩阵

能力	工具	输入	输出
内容 SEO 评分	analysis/seo_quality_rater.py	文章文本 + 关键词	0-100 分 + 6 维度细分
关键词密度/分布	analysis/keyword_analyzer.py	文章文本 + 目标关键词	密度%、段落级分布、聚类
可读性评分	analysis/readability_scorer.py	文章文本	Flesch 分数、年级水平、被动语态%
搜索意图分析	analysis/search_intent_analyzer.py	关键词 + SERP 数据	意图分类 + 置信度
CRO 着陆页审计	analysis/cro_checker.py	页面 HTML/URL	转化要素检查清单
关键词冲突检测	scripts/check_keyword_conflicts.py	CSV 布局表	冲突报告 + 整改建议
关键词布局规划	SKILL.md 工作流	站点信息	布局表 + 分配策略

快速开始

作为 OpenClaw Skill 使用

把 one-page-one-keyword/ 目录放到 ~/.openclaw/skills/seo-workbench/，下次 session 自动发现。

独立使用 Python 分析模块

cd one-page-one-keyword

# SEO 评分
python3 -c "
from analysis.seo_quality_rater import rate_seo_quality
result = rate_seo_quality(
    content='你的文章全文...',
    meta_title='页面标题',
    meta_description='Meta 描述',
    primary_keyword='目标关键词',
    secondary_keywords=['次要词1', '次要词2'],
    internal_link_count=5,
    external_link_count=3
)
print(f'Score: {result[\"overall_score\"]}/100')
"

# 关键词密度
python3 -c "
from analysis.keyword_analyzer import analyze_keywords
result = analyze_keywords(
    content='文章全文...',
    primary_keyword='目标关键词',
    secondary_keywords=['变体1'],
    target_density=1.5
)
print(f'Density: {result[\"primary_keyword\"][\"density\"]}%')
"

# 搜索意图
python3 -c "
from analysis.search_intent_analyzer import analyze_intent
result = analyze_intent(keyword='how to create a maze')
print(f'Intent: {result[\"primary_intent\"]}')
"

# 关键词冲突检测
python3 scripts/check_keyword_conflicts.py your-layout.csv

依赖

必需（stdlib only）：seo_quality_rater、search_intent_analyzer、cro_checker — 零依赖

可选：

• pip install textstat — 解锁 readability_scorer 的 Flesch 精确计算
• pip install scikit-learn numpy — 解锁 keyword_analyzer 的 TF-IDF 聚类

评分体系

SEO Quality Score (0-100)

维度	权重	说明
Content Quality	25	字数、深度、独特价值
Keyword Optimization	25	密度 1-2%、分布均匀、无堆砌
Meta Elements	15	Title 50-60 字符、Description 150-160 字符
Structure	15	H1-H6 层级、段落长度、列表使用
Links	10	内链 3-5+、外链 2-3+、锚文本质量
Readability	10	Flesch 60+、年级 8-10、被动语态 <20%

关键词密度参考

状态	密度	说明
too_low	<0.5%	需要增加
optimal	1.0-2.0%	✅ 理想范围
too_high	>3.0%	⚠️ 堆砌风险

核心原则

每个页面 = 1 个主关键词 + 2-5 个次要关键词

详见 one-page-one-keyword/references/seo-principles.md。

目录结构

one-page-one-keyword/
├── SKILL.md                          ← OpenClaw skill 入口
├── analysis/                         ← Python 分析模块
│   ├── seo_quality_rater.py          ← SEO 0-100 评分
│   ├── keyword_analyzer.py           ← 密度/分布/聚类
│   ├── readability_scorer.py         ← 可读性评分
│   ├── search_intent_analyzer.py     ← 搜索意图分类
│   └── cro_checker.py                ← CRO 着陆页审计
├── agents/                           ← Agent 角色定义
├── context/                          ← 项目 context 模板
├── references/                       ← SEO 原则文档
├── scripts/                          ← 冲突检测脚本
└── assets/                           ← 布局模板 CSV

版本历史

• v3.0 (2026-03-07) — 整合 SEO Machine 分析模块，升级为 SEO Workbench
• v2.0 — 基于 Kepano 最佳实践优化触发精准度
• v1.0 — 初始版本，关键词布局规划 + 冲突检测

来源

• 关键词原则：原创 one-page-one-keyword
• 分析模块：SEO Machine (Apache 2.0)

License

MIT