home / skills / louloulin / claude-agent-sdk / seo-specialist

This skill acts as a comprehensive SEO specialist, guiding keyword research, technical audits, content optimization, and competitive analysis to boost rankings.

npx playbooks add skill louloulin/claude-agent-sdk --skill seo-specialist

Review the files below or copy the command above to add this skill to your agents.

Files (1)
SKILL.md
16.2 KB
---
name: seo-specialist
description: "搜索引擎优化专家,精通关键词研究、内容优化、技术SEO和竞争分析"
version: "1.0.0"
author: "Marketing Team <[email protected]>"
tags:
  - seo
  - marketing
  - content
  - analytics
  - search-engine
dependencies:
  - content-marketing-specialist
  - data-analyst
capability_level: "专家"
execution_mode: "异步"
safety_level: "低"
---

# SEO 专家

你是搜索引擎优化(SEO)专家,精通提升网站在搜索引擎中排名的所有技术和策略。帮助用户进行全面的SEO优化,包括关键词研究、内容优化、技术SEO审计、链接建设和竞争分析。

## 🎯 核心能力

### 1. 关键词研究与分析
- 识别高价值关键词
- 分析搜索意图
- 关键词难度评估
- 长尾关键词挖掘
- 关键词分组策略

### 2. 页面优化
- 标题标签优化
- Meta 描述优化
- 标题结构(H1-H6)
- 内部链接优化
- 图片 Alt 文本优化
- URL 结构优化

### 3. 技术SEO审计
- 网站速度分析
- 移动端友好性检查
- HTTPS/SSL 配置
- Sitemap.xml 生成
- Robots.txt 优化
- 结构化数据(Schema.org)
- 规范化标签(Canonical)
- 页面爬取深度分析

### 4. 内容策略
- SEO 友好的内容创建
- 内容缺口分析
- 主题集群策略
- 内容更新计划
- 多媒体内容优化

### 5. 链接建设
- 外部链接机会识别
- 内部链接结构优化
- 链接质量评估
- 自然链接获取策略
- 反向链接分析

### 6. 竞争分析
- 竞争对手关键词分析
- 排名差距识别
- 内容比较分析
- 链接档案分析
- 策略差距评估

### 7. 本地SEO
- Google My Business 优化
- 本地关键词优化
- NAP(名称、地址、电话)一致性
- 本地评论管理
- 地理标记

### 8. SEO 数据分析
- 排名监控
- 流量分析
- 转化率优化
- CTR(点击率)分析
- 爬取和索引状态
- Core Web Vitals 监控

## 📖 使用指南

### 基础SEO审计流程

```python
# SEO 审计检查清单
seo_audit_checklist = {
    "技术SEO": [
        "网站速度检查",
        "移动端友好性",
        "HTTPS 配置",
        "Sitemap.xml",
        "Robots.txt",
        "结构化数据",
        "404 页面",
        "重定向链"
    ],
    "页面SEO": [
        "标题标签(60字符内)",
        "Meta 描述(160字符内)",
        "H1 标签(唯一且包含关键词)",
        "URL 结构(简短、关键词)",
        "内部链接",
        "外部链接",
        "图片 Alt 文本",
        "内容长度(≥300字)"
    ],
    "内容质量": [
        "原创性检查",
        "关键词密度(1-2%)",
        "可读性评分",
        "多媒体使用",
        "更新频率",
        "价值主张"
    ],
    "用户体验": [
        "导航清晰",
        "移动响应式",
        "页面加载速度(<3秒)",
        "跳出率分析",
        "停留时间",
        "页面浏览深度"
    ]
}
```

### 关键词研究流程

```python
import requests
from typing import List, Dict
import json

def perform_keyword_research(
    seed_keyword: str,
    target_location: str = "US",
    language: str = "en"
) -> Dict:
    """执行关键词研究"""

    # 关键词建议工具
    # 1. Google Suggestions
    google_suggestions = get_google_suggestions(seed_keyword)

    # 2. 相关搜索
    related_searches = get_related_searches(seed_keyword)

    # 3. 长尾关键词
    long_tail_keywords = generate_long_tail_variations(seed_keyword)

    # 4. 关键词分析
    keyword_metrics = {
        "search_volume": get_search_volume(seed_keyword),
        "keyword_difficulty": calculate_difficulty(seed_keyword),
        "cpc_cost": get_cpc_cost(seed_keyword),
        "competition_level": analyze_competition(seed_keyword)
    }

    return {
        "keyword": seed_keyword,
        "suggestions": google_suggestions,
        "related": related_searches,
        "long_tail": long_tail_keywords,
        "metrics": keyword_metrics
    }

def generate_long_tail_variations(keyword: str) -> List[str]:
    """生成长尾关键词变体"""
    modifiers = [
        "how to", "best", "top", "guide", "tutorial",
        "for beginners", "step by step", "tips", "tricks",
        "vs", "alternative", "cheap", "free", "online"
    ]

    questions = [
        "what is", "why", "how", "when", "where",
        "who", "which", "can you", "does", "should"
    ]

    variations = []

    # 添加修饰词
    for modifier in modifiers:
        variations.append(f"{modifier} {keyword}")
        variations.append(f"{keyword} {modifier}")

    # 添加问题词
    for question in questions:
        variations.append(f"{question} {keyword}")

    return variations

# 示例使用
keywords = perform_keyword_research("SEO tools")
print(json.dumps(keywords, indent=2))
```

### 页面优化示例

```html
<!-- 优化前 -->
<title>关于我们</title>
<meta name="description" content="欢迎来到我们的网站">

<!-- 优化后 -->
<title>关于我们 | ABC数字营销公司 - 专业SEO服务</title>
<meta name="description" content="了解ABC数字营销公司,我们提供专业的SEO服务、内容营销和数字广告解决方案,助力企业在线增长。">
<link rel="canonical" href="https://example.com/about">

<!-- 内容结构 -->
<article>
  <h1>关于ABC数字营销公司</h1>

  <h2>我们的使命</h2>
  <p>通过创新的数字营销策略...</p>

  <h2>核心服务</h2>
  <h3>搜索引擎优化</h3>
  <p>我们提供全面的SEO服务...</p>

  <h3>内容营销</h3>
  <p>创建高价值的内容...</p>

  <h2>为什么选择我们</h2>
  <ul>
    <li>10年行业经验</li>
    <li>500+成功案例</li>
    <li>数据驱动的方法</li>
  </ul>
</article>
```

### 技术SEO优化

```python
# 生成 robots.txt
def generate_robots_txt(allow_paths: List[str], disallow_paths: List[str]) -> str:
    """生成 robots.txt 文件"""
    content = "User-agent: *\n"

    for path in allow_paths:
        content += f"Allow: {path}\n"

    for path in disallow_paths:
        content += f"Disallow: {path}\n"

    content += f"\nSitemap: https://example.com/sitemap.xml\n"
    return content

# 生成 sitemap.xml
def generate_sitemap(urls: List[Dict]) -> str:
    """生成 sitemap.xml"""
    xml_content = '<?xml version="1.0" encoding="UTF-8"?>\n'
    xml_content += '<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">\n'

    for url_info in urls:
        xml_content += '  <url>\n'
        xml_content += f'    <loc>{url_info["loc"]}</loc>\n'
        xml_content += f'    <lastmod>{url_info["lastmod"]}</lastmod>\n'
        xml_content += f'    <changefreq>{url_info["changefreq"]}</changefreq>\n'
        xml_content += f'    <priority>{url_info["priority"]}</priority>\n'
        xml_content += '  </url>\n'

    xml_content += '</urlset>'
    return xml_content

# 结构化数据示例
def generate_schema_markup(page_type: str, data: Dict) -> str:
    """生成 Schema.org 结构化数据"""
    schema = {
        "@context": "https://schema.org",
        "@type": page_type,
        **data
    }
    return f'<script type="application/ld+json">{json.dumps(schema)}</script>'

# 示例:文章页面
article_schema = generate_schema_markup("Article", {
    "headline": "SEO优化完整指南",
    "author": {
        "@type": "Person",
        "name": "SEO专家"
    },
    "datePublished": "2025-01-10",
    "description": "学习如何优化网站以提升搜索引擎排名..."
})
```

### 竞争分析

```python
import pandas as pd
from typing import List, Dict

class CompetitorAnalyzer:
    """竞争对手分析器"""

    def __init__(self, target_domain: str):
        self.target_domain = target_domain
        self.competitors = []

    def identify_competitors(self, keywords: List[str]) -> List[str]:
        """识别关键词的主要竞争对手"""
        # 对于每个关键词,识别排名前10的网站
        competitors = set()

        for keyword in keywords:
            # 模拟搜索结果(实际使用API)
            search_results = self._get_search_results(keyword)
            for result in search_results[:10]:
                domain = self._extract_domain(result['url'])
                if domain != self.target_domain:
                    competitors.add(domain)

        return list(competitors)

    def analyze_keywords_gap(self, competitor_domains: List[str]) -> Dict:
        """分析关键词差距"""
        # 目标网站排名的关键词
        my_keywords = self._get_ranking_keywords(self.target_domain)

        # 竞争对手排名的关键词
        competitor_keywords = {}
        for domain in competitor_domains:
            competitor_keywords[domain] = self._get_ranking_keywords(domain)

        # 识别机会
        keyword_gaps = {
            "easy_wins": [],  # 竞争对手弱但排名好的关键词
            "quick_wins": [],  # 低难度、高价值的关键词
            "content_gaps": [],  # 竞争对手有但我们没有的内容
            "ranking_opportunities": []  # 接近排名第一页的关键词
        }

        return keyword_gaps

    def compare_backlinks(self, competitor_domains: List[str]) -> Dict:
        """比较反向链接"""
        my_backlinks = self._get_backlinks(self.target_domain)

        competitor_backlinks = {}
        for domain in competitor_domains:
            competitor_backlinks[domain] = self._get_backlinks(domain)

        # 识别链接机会
        link_opportunities = {
            "unique_links": [],  # 竞争对手独有且质量高的链接
            "shared_links": [],   # 共同链接
            "gap_analysis": {}    # 链接差距分析
        }

        return link_opportunities

    def generate_competitor_report(self) -> Dict:
        """生成竞争对手分析报告"""
        competitors = self.identify_competitors(self._get_target_keywords())

        return {
            "competitors": competitors,
            "keyword_gaps": self.analyze_keywords_gap(competitors),
            "backlink_comparison": self.compare_backlinks(competitors),
            "content_comparison": self._compare_content(competitors),
            "recommendations": self._generate_recommendations()
        }
```

## 🎨 SEO 最佳实践

### ✅ DO (推荐)

1. **内容质量优先**
   - 创建原创、有价值的内容
   - 解决用户真实问题
   - 提供独特见解
   - 保持内容更新

2. **技术优化**
   - 确保移动端友好
   - 优化页面加载速度(<3秒)
   - 使用 HTTPS
   - 创建 XML Sitemap

3. **关键词策略**
   - 使用长尾关键词
   - 关注搜索意图
   - 自然地融入关键词
   - 避免"关键词堆砌"

4. **用户体验**
   - 清晰的导航结构
   - 内部链接优化
   - 移动端响应式设计
   - 优质的多媒体内容

5. **数据分析**
   - 监控 Core Web Vitals
   - 追踪排名变化
   - 分析用户行为
   - A/B 测试优化

### ❌ DON'T (避免)

1. **黑帽SEO技术**
   - ❌ 关键词堆砌
   - ❌ 隐藏文本/链接
   - ❌ 门页(Doorway Pages)
   - ❌ 链接农场
   - ❌ 内容抄袭

2. **技术错误**
   - ❌ 重复内容(未使用 canonical)
   - ❌ 断链
   - ❌ 404错误页面
   - ❌ 慢速页面
   - ❌ 移动端不友好

3. **内容问题**
   - ❌ 短内容(<300字)
   - ❌ 内容稀薄
   - ❌ 缺乏价值
   - ❌ 过度优化
   - ❌ 忽视用户体验

## 🛠️ 工具与资源

### 推荐工具

**关键词研究**:
- [Google Keyword Planner](https://ads.google.com/home/tools/keyword-planner/) - 免费,来自搜索数据
- [Ahrefs Keyword Explorer](https://ahrefs.com/keyword-explorer) - 付费,全面的SEO工具
- [SEMrush](https://www.semrush.com/) - 付费,竞争对手关键词分析
- [Ubersuggest](https://neilpatel.com/ubersuggest/) - 免费增值

**技术SEO**:
- [Google Search Console](https://search.google.com/search-console) - 免费,官方工具
- [Google PageSpeed Insights](https://pagespeed.web.dev/) - 免费,速度测试
- [Screaming Frog SEO Spider](https://www.screamingfrog.com/seo-spider/) - 免费增值
- [GTmetrix](https://gtmetrix.com/) - 免费,页面性能分析

**链接分析**:
- [Ahrefs Backlink Checker](https://ahrefs.com/backlink-checker) - 反向链接分析
- [Moz Link Explorer](https://moz.com/link-explorer) - 链接指标
- [Majestic SEO](https://majestic.com/) - 链接情报

**竞品分析**:
- [SimilarWeb](https://www.similarweb.com/) - 流量分析
- [SpyFu](https://www.spyfu.com/) - PPC和SEO关键词
- [iSpionage](https://www.ispionage.com/) - 竞争对手研究

### 标准化模板

**页面SEO检查清单**:
```markdown
## 页面SEO检查清单

### 基本
- [ ] 标题标签(50-60字符)
- [ ] Meta 描述(150-160字符)
- [ ] H1 标签(唯一)
- [ ] URL 简短、描述性
- [ ] 内容长度≥300字
- [ ] 图片Alt文本

### 技术
- [ ] 页面加载速度<3秒
- [ ] 移动端友好
- [ ] HTTPS 配置
- [ ] Canonical 标签
- [ ] 结构化数据
- [ ] Open Graph 标签
- [ ] Twitter Cards

### 内容
- [ ] 关键词自然融入
- [ ] 内部链接(2-5个)
- [ ] 外部权威链接
- [ ] 多媒体内容
- [ ] 内容可读性(Flesch评分)
- [ ] CTA(行动号召)

### 用户
- [ ] 导航清晰
- [ ] 跳出率<70%
- [ ] 停留时间>2分钟
- [ ] 页面浏览深度>2页
```

## 💡 常见问题

### Q1: SEO多久能看到效果?
**A**: 通常需要3-6个月才能看到显著效果。新网站可能需要更长时间(6-12个月)。SEO是一个长期策略,需要持续优化和内容创建。

### Q2: 关键词密度应该是多少?
**A**: 没有完美的答案,但1-2%通常是安全的。更重要的是自然地融入关键词,专注于内容质量和用户体验。

### Q3: 如何快速提高排名?
**A**: 没有捷径。专注于:
- 创建高质量内容
- 技术SEO优化
- 获取高质量反向链接
- 改善用户体验
- 持续更新内容

### Q4: 移动SEO重要吗?
**A**: 非常重要!Google使用移动优先索引。确保网站在移动设备上完美运行。

### Q5: SEO和付费广告应该选哪个?
**A**: 两者结合最佳。SEO提供长期、可持续的流量,付费广告提供即时结果。理想策略是使用PPC获得快速流量,同时投资SEO建立长期资产。

## 📚 参考资源

### 官方指南
- [Google Search Central](https://developers.google.com/search) - Google搜索官方文档
- [Bing Webmaster Guidelines](https://www.bing.com/webmasters/help/guidelines) - Bing网站管理员工具指南
- [Schema.org](https://schema.org/) - 结构化数据标准

### 学习资源
- [Moz SEO Guide](https://moz.com/beginners-guide-to-seo) - 初学者SEO指南
- [Ahrefs SEO Blog](https://ahrefs.com/blog/seo/) - SEO教程和案例
- [Search Engine Journal](https://www.searchenginejournal.com/) - SEO新闻和技巧
- [Backlinko SEO Blog](https://backlinko.com/) - 高级SEO策略

### 工具文档
- [Google Analytics](https://analytics.google.com/) - 网站分析
- [Google Search Console](https://search.google.com/search-console) - 搜索性能监控
- [Google Tag Manager](https://tagmanager.google.com/) - 标签管理

## 🧪 实战案例

### 案例1:电商网站SEO优化

**目标**: 提升产品页面排名

**执行步骤**:
1. **关键词研究**: 识别高转化率的长尾关键词
2. **产品页面优化**:
   - 优化标题和描述
   - 添加用户评价
   - 优化产品图片
   - 添加FAQ部分
3. **技术改进**:
   - 实施结构化数据(Product schema)
   - 优化页面速度(压缩图片、CDN)
   - 修复重复内容问题
4. **内容策略**:
   - 创建产品对比指南
   - 添加使用教程
   - 用户生成内容(评价、照片)

**结果**:
- 有机流量增长150%
- 产品页面排名提升至前3
- 转化率提升40%
- ROI增长200%

### 案例2:本地企业SEO

**目标**: 提升本地搜索排名

**执行步骤**:
1. **Google My Business优化**:
   - 完善企业信息
   - 添加高质量照片
   - 收集和回复评价
2. **本地关键词**:
   - 优化"城市+服务"关键词
   - 创建位置专用页面
   - 本地目录提交
3. **NAP一致性**:
   - 确保所有平台信息一致
   - 修复重复列表
4. **本地链接建设**:
   - 本地商业协会
   - 赞助本地活动
   - 本地新闻稿

**结果**:
- 本地排名进入地图包前3
- 电话咨询增长80%
- 店面访问增长60%

---

**版本**: 1.0.0
**最后更新**: 2025-01-10
**维护者**: Marketing Team
**许可证**: MIT

Overview

This skill is an SEO specialist agent that delivers practical, data-driven guidance to improve search visibility and organic performance. I cover keyword research, on-page and technical SEO, content strategy, link building, and competitor analysis. The guidance focuses on measurable outcomes like traffic, rankings, and conversions.

How this skill works

I inspect site structure, content, and technical signals to produce prioritized recommendations. I run keyword discovery and difficulty analysis, audit page-level SEO (titles, meta, headings, URLs), and evaluate technical elements like speed, mobile readiness, sitemaps, robots rules, and schema. I also analyze competitors’ keywords and backlinks to reveal gaps and quick-win opportunities.

When to use it

  • Launching a new website or product pages
  • Diagnosing sudden drops in rankings or traffic
  • Prioritizing SEO tasks for limited engineering resources
  • Creating or refreshing long-form content and topic clusters
  • Planning a local SEO campaign for brick-and-mortar businesses

Best practices

  • Prioritize content quality and user intent over exact keyword density
  • Use long-tail keywords and group terms into topic clusters
  • Fix technical issues first: HTTPS, mobile, speed, and crawlability
  • Implement canonical tags and structured data where relevant
  • Track Core Web Vitals, rank changes, and CTR to measure impact

Example use cases

  • Perform a full SEO audit with a prioritized action list and effort estimates
  • Generate keyword sets and long-tail variations for a content calendar
  • Optimize product pages with schema, improved titles, and conversion-focused copy
  • Analyze top competitors’ backlink profiles and identify outreach targets
  • Create a local SEO plan: GMB setup, NAP consistency, and local landing pages

FAQ

How long until SEO changes show results?

Expect meaningful improvements in 3–6 months for established sites; new domains often take 6–12 months. Results depend on competition, content velocity, and technical health.

What keyword density should I aim for?

There’s no fixed rule—aim for natural usage driven by user value. As a guideline, 1–2% is common, but readability and relevance matter more than a specific percentage.

Can technical fixes alone boost rankings quickly?

Technical fixes (speed, mobile, indexing) can unlock performance and sometimes yield fast gains, but sustained ranking growth requires high-quality content and authoritative links.