Search Optimization Agent

Provides expert SEO services including keyword research, content optimization, ranking tracking, technical audits, and competitor analysis using real data APIs.

SEO Agent — 搜索引擎优化专家

功能说明

专业 SEO 优化助手，提供关键词研究、内容优化、排名监控、技术 SEO 审计和竞品分析。集成真实 SEO API 数据，不是泛泛而谈的建议。

核心能力

1. 关键词研究 (Keyword Research)

输入：种子关键词、目标市场、行业
输出：关键词列表 + 指标数据

metrics:
  - search_volume: 月搜索量
  - keyword_difficulty: 难度 (0-100)
  - cpc: 点击成本
  - trend: 搜索趋势 (12 个月)
  - intent: 搜索意图 (信息/导航/交易/商业)

data_sources:
  - Google Keyword Planner API
  - Ahrefs API (备选)
  - SEMrush API (备选)
  - Google Trends API

使用示例：

用户：帮我研究"AI 工具"的关键词机会
Agent: 
  1. 调用 keyword_research API
  2. 输出 50 个相关关键词 + 指标
  3. 推荐 10 个低难度高价值关键词
  4. 提供内容建议

2. 内容优化 (Content Optimization)

输入：文章草稿、目标关键词
输出：优化建议 + 修改版本

on_page_factors:
  - title_tag: 标题标签 (50-60 字符)
  - meta_description: 描述标签 (150-160 字符)
  - h1_h2_h3: 标题结构
  - keyword_density: 关键词密度 (1-2%)
  - internal_links: 内链建议
  - image_alt: 图片 ALT 文本
  - url_structure: URL 优化
  - readability: 可读性评分

tools:
  - content_audit: 内容审计
  - keyword_placement: 关键词布局建议
  - meta_generator: 元标签生成
  - readability_checker: 可读性检查

使用示例：

用户：优化这篇关于"OpenClaw Skills"的文章 SEO
Agent:
  1. 分析当前内容（标题、结构、关键词密度）
  2. 输出优化建议清单
  3. 生成优化后的标题/描述
  4. 提供内链建议

3. 排名监控 (Rank Tracking)

输入：关键词列表、目标 URL、地理位置
输出：排名数据 + 趋势分析

tracking:
  - current_rank: 当前排名
  - rank_change: 排名变化 (日/周/月)
  - top_10_competitors: 前 10 竞品
  - featured_snippet: 是否获得精选摘要
  - local_pack: 是否进入本地包

alerts:
  - rank_drop: 排名下降>5 位
  - new_competitor: 新竞品进入前 10
  - featured_snippet_won: 获得精选摘要

4. 技术 SEO 审计 (Technical SEO Audit)

输入：网站 URL
输出：技术 SEO 报告 + 修复建议

audit_items:
  - crawlability: 可抓取性 (robots.txt, sitemap)
  - indexability: 可索引性 (noindex, canonical)
  - site_speed: 页面速度 (Core Web Vitals)
  - mobile_friendly: 移动端适配
  - https: HTTPS 配置
  - structured_data: 结构化数据 (Schema.org)
  - internal_linking: 内链结构
  - duplicate_content: 重复内容
  - broken_links: 死链检测
  - xml_sitemap: Sitemap 完整性

tools:
  - site_crawl: 网站爬取
  - speed_test: 速度测试 (PageSpeed Insights API)
  - mobile_test: 移动端测试
  - schema_validator: 结构化数据验证

使用示例：

用户：审计 mywebsite.com 的技术 SEO
Agent:
  1. 爬取网站（最多 100 页）
  2. 检测 Core Web Vitals
  3. 检查结构化数据
  4. 输出优先级修复清单（高/中/低）

5. 竞品分析 (Competitor Analysis)

输入：竞品域名、目标关键词
输出：竞品 SEO 策略分析

analysis:
  - top_keywords: 竞品排名靠前的关键词
  - backlink_profile: 外链数量/质量
  - content_gaps: 内容缺口（竞品有我们没有的）
  - traffic_estimate: 预估自然流量
  - top_pages: 流量最高的页面

tools:
  - competitor_keywords: 竞品关键词分析
  - backlink_analyzer: 外链分析
  - content_gap: 内容缺口分析
  - traffic_estimator: 流量预估

SEO 检查清单

发布前检查

• 目标关键词已研究（搜索量>100，难度<50）
• 标题标签包含关键词（50-60 字符）
• Meta 描述包含关键词（150-160 字符）
• H1 标签包含关键词（每页仅 1 个 H1）
• H2/H3 结构清晰，包含相关关键词
• URL 简短，包含关键词（<60 字符）
• 图片有 ALT 文本
• 内链到相关页面（3-5 个）
• 外链到权威来源（2-3 个）
• 移动端适配测试通过
• 页面加载速度<3 秒

技术 SEO 检查

• robots.txt 配置正确
• XML Sitemap 已提交 Google Search Console
• HTTPS 配置正确
• Canonical 标签设置
• 结构化数据（Schema.org）添加
• Core Web Vitals 达标（LCP<2.5s, FID<100ms, CLS<0.1）
• 无 404 错误
• 无重复内容问题

工具函数

keyword_research

def keyword_research(seed_keyword: str, location: str = "CN", language: str = "zh") -> dict:
    """
    关键词研究
    
    Args:
        seed_keyword: 种子关键词
        location: 目标地理位置 (CN/US/UK 等)
        language: 目标语言 (zh/en 等)
    
    Returns:
        {
            "keywords": [
                {
                    "keyword": "AI 工具",
                    "search_volume": 12000,
                    "difficulty": 45,
                    "cpc": 2.5,
                    "trend": [8000, 9000, 10000, ...],
                    "intent": "commercial"
                }
            ],
            "recommendations": ["低难度高价值关键词列表"]
        }
    """

content_optimize

def content_optimize(content: str, target_keyword: str) -> dict:
    """
    内容优化
    
    Args:
        content: 文章内容
        target_keyword: 目标关键词
    
    Returns:
        {
            "score": 75,  # SEO 评分 (0-100)
            "suggestions": [
                {"type": "title", "issue": "标题未包含关键词", "fix": "在标题中加入'AI 工具'"},
                {"type": "density", "issue": "关键词密度过低", "fix": "增加 2-3 处关键词"}
            ],
            "optimized_version": "优化后的内容"
        }
    """

technical_audit

def technical_audit(url: str) -> dict:
    """
    技术 SEO 审计
    
    Args:
        url: 网站 URL
    
    Returns:
        {
            "score": 68,  # 技术 SEO 评分
            "issues": {
                "high": ["Core Web Vitals 不达标", "移动端适配问题"],
                "medium": ["缺少结构化数据", "内链不足"],
                "low": ["图片 ALT 文本缺失"]
            },
            "fix_priority": ["修复 LCP", "添加 Schema", "优化图片"]
        }
    """

SEO 最佳实践

关键词策略

1. 长尾关键词优先 — 难度低，转化率高

   • ❌ "AI 工具"（难度 65，搜索量 50000）
   • ✅ "OpenClaw Skills 安装教程"（难度 25，搜索量 500）

2. 搜索意图匹配 — 信息型 vs 交易型

   • 信息型：教程、指南、对比 → 博客文章
   • 交易型：购买、价格、评测 → 产品页面

3. 关键词布局 — 自然分布，避免堆砌

   • 标题、H1、首段、结尾
   • 密度 1-2%，不要超过 3%

内容策略

1. E-E-A-T 原则 — Google 排名核心

   • Experience（经验）
   • Expertise（专业性）
   • Authoritativeness（权威性）
   • Trustworthiness（可信度）

2. 内容深度 — 2000+ 字长文排名更好

   • 全面覆盖主题
   • 包含案例、数据、图表
   • 定期更新（Google 喜欢新鲜内容）

3. 内部链接 — 传递权重

   • 每篇文章链接 3-5 篇相关内容
   • 使用描述性锚文本
   • 建立内容集群（Topic Cluster）

相关文件

• Google Search Console
• Google Keyword Planner
• Ahrefs
• SEMrush
• Moz

触发词

• 自动：检测 SEO、关键词、排名、优化相关关键词
• 手动：/seo-agent, /keyword-research, /seo-audit
• 短语：SEO 优化、关键词研究、排名监控、技术审计

Usage

1. Install the skill
2. Configure as needed
3. Run with OpenClaw