r16-voltagent-seo-content-marketing-agent-skills

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

📈 SEO & Content Marketing Agent Skills

📈 SEO与内容营销Agent技能

Skill by ara.so — Marketing Skills collection.
This skill suite provides specialized SEO and content marketing capabilities derived from the VoltAgent/awesome-agent-skills framework. It includes 10 domain-specific commands and 5 multi-step workflows for keyword research, technical SEO audits, competitor analysis, content strategy, and link building.
ara.so开发的技能——营销技能合集。
该技能套件基于VoltAgent/awesome-agent-skills框架,提供专业的SEO和内容营销能力。它包含10个领域专属命令和5个多步骤工作流,覆盖关键词研究、技术SEO审计、竞品分析、内容策略和外链建设。

What This Skill Does

该技能的功能

  • Keyword Research — Cluster keywords, score opportunities, map search intent
  • Content Audits — Quality scoring, duplication detection, cannibalization analysis
  • Technical SEO — Crawl budget, Core Web Vitals, schema markup validation
  • Competitor Analysis — Backlink gaps, topic gaps, SERP feature opportunities
  • Content Strategy — AI-generated briefs, editorial calendars, refresh workflows
  • Local SEO — NAP consistency, GBP optimization, citation audits
  • Link Building — Prospect discovery, outreach automation, authority building
  • 关键词研究 — 关键词聚类、机会评分、搜索意图映射
  • 内容审计 — 质量评分、重复内容检测、关键词 cannibalization(自竞争)分析
  • 技术SEO — 抓取预算、Core Web Vitals、Schema标记验证
  • 竞品分析 — 外链缺口、主题缺口、SERP功能机会
  • 内容策略 — AI生成brief、编辑日历、内容更新工作流
  • 本地SEO — NAP一致性检查、GBP优化、引用审计
  • 外链建设 — 潜在合作方挖掘、 outreach( outreach指外链开发中的沟通)自动化、权威度建设

Installation

安装

bash
undefined
bash
undefined

Clone the skill suite

克隆技能套件

Install in Claude Code skills directory

安装到Claude Code技能目录

mkdir -p ~/.claude/skills/ cp -r r16-voltagent-awesome-agent-skills-seo ~/.claude/skills/seo-marketing/
mkdir -p ~/.claude/skills/ cp -r r16-voltagent-awesome-agent-skills-seo ~/.claude/skills/seo-marketing/

Or copy the SKILL.md directly

或者直接复制SKILL.md文件

cp SKILL.md ~/.claude/skills/seo-marketing.md

**Register the skill in your agent session:**

```bash
cp SKILL.md ~/.claude/skills/seo-marketing.md

**在Agent会话中注册技能:**

```bash

In Claude Code or compatible agent environment

在Claude Code或兼容的Agent环境中执行

/read ~/.claude/skills/seo-marketing/SKILL.md
undefined
/read ~/.claude/skills/seo-marketing/SKILL.md
undefined

Core Commands

核心命令

Keyword Research

关键词研究

Analyze keyword opportunities with clustering, intent mapping, and difficulty scoring.
bash
undefined
通过聚类、意图映射和难度评分分析关键词机会。
bash
undefined

Basic keyword research

基础关键词研究

/keyword-research "sustainable fashion"
/keyword-research "sustainable fashion"

With advanced options

高级选项

/keyword-research "sustainable fashion"
--country US
--language en
--volume-min 100
--difficulty-max 50
--intent commercial,informational
--output json

**Output structure:**
- Primary keyword metrics (volume, CPC, difficulty)
- Keyword clusters by topic/intent
- SERP feature opportunities
- Seasonality trends
- Competitive landscape scoring
/keyword-research "sustainable fashion"
--country US
--language en
--volume-min 100
--difficulty-max 50
--intent commercial,informational
--output json

**输出结构:**
- 核心关键词指标(搜索量、CPC、难度)
- 按主题/意图划分的关键词聚类
- SERP功能机会
- 季节性趋势
- 竞争格局评分

Content Audit

内容审计

Full-site content quality analysis with actionable recommendations.
bash
undefined
全站内容质量分析及可执行建议。
bash
undefined

Basic content audit

基础内容审计

/content-audit https://example.com
/content-audit https://example.com

Scoped audit with filters

带筛选条件的定向审计

/content-audit https://example.com
--scope /blog
--min-words 300
--check-duplicates
--check-cannibalization
--output markdown

**Audit includes:**
- Thin content detection (<300 words)
- Duplicate content fingerprinting
- Keyword cannibalization matrix
- Content quality scores (readability, structure, entities)
- Orphan page identification
- Internal linking opportunities
/content-audit https://example.com
--scope /blog
--min-words 300
--check-duplicates
--check-cannibalization
--output markdown

**审计内容包括:**
- 低质内容检测(少于300字)
- 重复内容识别
- 关键词自竞争矩阵
- 内容质量评分(可读性、结构、实体)
- 孤立页面识别
- 内链优化机会

Technical SEO Audit

技术SEO审计

Comprehensive technical health check with Core Web Vitals.
bash
undefined
包含Core Web Vitals的全面技术健康检查。
bash
undefined

Full technical audit

完整技术审计

/technical-seo https://example.com
/technical-seo https://example.com

Specific checks

指定检查项

/technical-seo https://example.com
--checks crawlability,mobile,speed,schema
--include-sitemap
--check-robots
--verify-https

**Checks performed:**
- Crawlability (robots.txt, noindex, canonicals)
- Core Web Vitals (LCP, FID, CLS)
- Mobile-friendliness (viewport, tap targets)
- Schema markup validation
- Sitemap integrity
- HTTPS/security headers
- Redirect chains
- Broken links
/technical-seo https://example.com
--checks crawlability,mobile,speed,schema
--include-sitemap
--check-robots
--verify-https

**执行的检查:**
- 可抓取性(robots.txt、noindex、canonical标签)
- Core Web Vitals(LCP、FID、CLS)
- 移动端适配(视口、点击目标)
- Schema标记验证
- 站点地图完整性
- HTTPS/安全头
- 重定向链
- 失效链接

Competitor Gap Analysis

竞品缺口分析

Identify content and backlink opportunities vs. competitors.
bash
undefined
识别与竞品相比的内容和外链机会。
bash
undefined

Competitor gap analysis

竞品缺口分析

/competitor-gap
--target https://example.com
--competitors https://competitor1.com,https://competitor2.com
--type backlinks,content,features
/competitor-gap
--target https://example.com
--competitors https://competitor1.com,https://competitor2.com
--type backlinks,content,features

Backlink gap only

仅外链缺口分析

/competitor-gap
--target example.com
--competitors competitor1.com,competitor2.com
--type backlinks
--min-dr 30
--output csv

**Analysis includes:**
- Backlink gap (unique referring domains)
- Topic gap (competitor content not covered)
- SERP feature gap (featured snippets, PAA, images)
- Keyword gap (ranking keywords you're missing)
- Content depth comparison
/competitor-gap
--target example.com
--competitors competitor1.com,competitor2.com
--type backlinks
--min-dr 30
--output csv

**分析内容包括:**
- 外链缺口(独特引用域名)
- 主题缺口(竞品覆盖但我方未覆盖的内容)
- SERP功能缺口(精选摘要、PAA、图片)
- 关键词缺口(竞品排名但我方未排名的关键词)
- 内容深度对比

SEO Content Brief Generation

SEO内容Brief生成

AI-generated content briefs optimized for target keywords.
bash
undefined
针对目标关键词优化的AI生成内容Brief。
bash
undefined

Generate content brief

生成内容Brief

/content-brief "how to start a sustainable fashion brand"
/content-brief "how to start a sustainable fashion brand"

With custom parameters

自定义参数

/content-brief "how to start a sustainable fashion brand"
--word-count 2500
--competitors 5
--include-nlp-terms
--include-questions
--outline-depth 3
--output markdown

**Brief includes:**
- Target keyword and variants
- Search intent analysis
- Recommended word count
- H2/H3 outline structure
- NLP entities to include
- People Also Ask questions
- Related searches
- Image/media recommendations
- Internal linking suggestions
- Meta title/description templates
/content-brief "how to start a sustainable fashion brand"
--word-count 2500
--competitors 5
--include-nlp-terms
--include-questions
--outline-depth 3
--output markdown

**Brief内容包括:**
- 目标关键词及变体
- 搜索意图分析
- 推荐字数
- H2/H3大纲结构
- 需要包含的NLP实体
- People Also Ask问题
- 相关搜索
- 图片/媒体建议
- 内链建议
- 标题/描述模板

SERP Monitoring

SERP监控

Track rankings with volatility alerts and optimization tips.
bash
undefined
跟踪排名,提供波动预警和优化建议。
bash
undefined

Setup SERP monitoring

设置SERP监控

/serp-monitor setup
--domain example.com
--keywords keywords.csv
--frequency daily
--competitors 3
/serp-monitor setup
--domain example.com
--keywords keywords.csv
--frequency daily
--competitors 3

Generate ranking report

生成排名报告

/serp-monitor report
--period 30d
--show-volatility
--show-features
--output dashboard

**Monitoring features:**
- Daily rank tracking (desktop + mobile)
- SERP volatility detection
- Featured snippet tracking
- CTR opportunity scoring
- Position change alerts
- Competitor movement tracking
/serp-monitor report
--period 30d
--show-volatility
--show-features
--output dashboard

**监控功能:**
- 每日排名跟踪(桌面+移动端)
- SERP波动检测
- 精选摘要跟踪
- CTR机会评分
- 排名变化预警
- 竞品排名变动跟踪

Link Prospecting

外链潜在合作方挖掘

Discover high-quality backlink opportunities with outreach templates.
bash
undefined
发现高质量外链机会,并提供沟通模板。
bash
undefined

Find link prospects

寻找外链潜在合作方

/link-prospecting
--topic "sustainable fashion"
--min-da 30
--max-da 70
--types blog,resource,directory
--country US
--limit 100
/link-prospecting
--topic "sustainable fashion"
--min-da 30
--max-da 70
--types blog,resource,directory
--country US
--limit 100

With outreach templates

带沟通模板

/link-prospecting
--topic "sustainable fashion"
--min-da 30
--generate-templates
--personalization high
--output csv

**Prospect scoring:**
- Domain Authority / Domain Rating
- Relevance score (topical alignment)
- Traffic estimates
- Outreach difficulty
- Contact information
- Pre-written outreach templates
/link-prospecting
--topic "sustainable fashion"
--min-da 30
--generate-templates
--personalization high
--output csv

**潜在合作方评分:**
- 域名权威度(Domain Authority/Domain Rating)
- 相关性评分(主题匹配度)
- 流量预估
- 沟通难度
- 联系信息
- 预写沟通模板

Page Speed SEO Analysis

页面速度SEO分析

Diagnose speed issues mapped to ranking impact.
bash
undefined
诊断影响排名的速度问题。
bash
undefined

Page speed SEO analysis

页面速度SEO分析

/page-speed-seo https://example.com/page
/page-speed-seo https://example.com/page

With specific metrics

指定指标

/page-speed-seo https://example.com/page
--device mobile
--metrics lcp,fid,cls,fcp,ttfb
--check-render-blocking
--check-images
--output report

**Analysis includes:**
- Core Web Vitals scoring
- Render-blocking resources
- Image optimization opportunities
- JavaScript execution time
- CSS delivery optimization
- Third-party script impact
- Server response time (TTFB)
- Ranking impact estimation
/page-speed-seo https://example.com/page
--device mobile
--metrics lcp,fid,cls,fcp,ttfb
--check-render-blocking
--check-images
--output report

**分析内容包括:**
- Core Web Vitals评分
- 阻塞渲染资源
- 图片优化机会
- JavaScript执行时间
- CSS交付优化
- 第三方脚本影响
- 服务器响应时间(TTFB)
- 排名影响预估

Local SEO Audit

本地SEO审计

NAP consistency, GBP optimization, and citation building.
bash
undefined
NAP一致性检查、GBP优化和引用建设。
bash
undefined

Local SEO audit

本地SEO审计

/local-seo
--business "Example Coffee Shop"
--location "Seattle, WA"
--check-gbp
--check-citations
--check-reviews
/local-seo
--business "Example Coffee Shop"
--location "Seattle, WA"
--check-gbp
--check-citations
--check-reviews

Citation discovery

引用挖掘

/local-seo citations
--business "Example Coffee Shop"
--location "Seattle, WA"
--find-opportunities
--check-consistency
--output spreadsheet

**Audit includes:**
- Google Business Profile completeness
- NAP consistency across web
- Citation building opportunities
- Review sentiment analysis
- Local pack ranking factors
- Schema markup for local business
- Competitor local presence
/local-seo citations
--business "Example Coffee Shop"
--location "Seattle, WA"
--find-opportunities
--check-consistency
--output spreadsheet

**审计内容包括:**
- Google Business Profile完整性
- 全网NAP一致性
- 引用建设机会
- 评论情感分析
- 本地包排名因素
- 本地商家Schema标记
- 竞品本地存在感

Content Calendar Generation

内容日历生成

Data-driven editorial calendar from search demand.
bash
undefined
基于搜索需求的数据驱动型编辑日历。
bash
undefined

Generate content calendar

生成内容日历

/content-calendar
--topics "sustainable fashion,eco-friendly clothing"
--period 3months
--frequency 2-per-week
--include-seasonality
--include-trends
--output calendar
/content-calendar
--topics "sustainable fashion,eco-friendly clothing"
--period 3months
--frequency 2-per-week
--include-seasonality
--include-trends
--output calendar

With keyword research integration

整合关键词研究

/content-calendar
--seed-keywords keywords.csv
--period 6months
--posts-per-month 8
--mix informational:70,commercial:30
--output google-sheets

**Calendar includes:**
- Topic selection by search volume
- Seasonal trend alignment
- Publishing date recommendations
- Target keyword for each piece
- Content type (guide, listicle, how-to)
- Estimated effort (hours)
- Priority scoring
/content-calendar
--seed-keywords keywords.csv
--period 6months
--posts-per-month 8
--mix informational:70,commercial:30
--output google-sheets

**日历内容包括:**
- 按搜索量选择主题
- 季节性趋势匹配
- 发布日期建议
- 每篇内容的目标关键词
- 内容类型(指南、清单、教程)
- 预估工作量(小时)
- 优先级评分

Workflows (Multi-Step)

工作流(多步骤)

Full SEO Sprint

完整SEO冲刺

12-step comprehensive SEO audit and action plan.
bash
/workflows:full-seo-sprint https://example.com \
  --scope full \
  --include-competitors 3 \
  --output-format report
Workflow steps:
  1. Technical SEO audit
  2. On-page content audit
  3. Keyword research & gap analysis
  4. Competitor analysis
  5. Backlink profile audit
  6. SERP feature opportunities
  7. Content cannibalization check
  8. Internal linking optimization
  9. Schema markup recommendations
  10. Speed & Core Web Vitals
  11. Action plan generation (prioritized)
  12. Progress tracking setup
12步全面SEO审计和行动计划。
bash
/workflows:full-seo-sprint https://example.com \
  --scope full \
  --include-competitors 3 \
  --output-format report
工作流步骤:
  1. 技术SEO审计
  2. 页面内内容审计
  3. 关键词研究与缺口分析
  4. 竞品分析
  5. 外链档案审计
  6. SERP功能机会
  7. 关键词自竞争检查
  8. 内链优化
  9. Schema标记建议
  10. 速度与Core Web Vitals
  11. 生成优先级行动计划
  12. 设置进度跟踪

Launch SEO Checklist

上线前SEO检查清单

Pre-launch SEO validation workflow.
bash
/workflows:launch-seo https://staging.example.com \
  --production-url https://example.com \
  --check-redirects \
  --check-canonicals \
  --verify-sitemap
Checklist includes:
  • Robots.txt validation
  • Sitemap generation & submission
  • Canonical tag verification
  • Hreflang implementation (if multilingual)
  • 301 redirect mapping
  • Structured data validation
  • Meta tags audit
  • Mobile responsiveness
  • Page speed baseline
  • Analytics/tracking setup
上线前SEO验证工作流。
bash
/workflows:launch-seo https://staging.example.com \
  --production-url https://example.com \
  --check-redirects \
  --check-canonicals \
  --verify-sitemap
检查清单包括:
  • Robots.txt验证
  • 站点地图生成与提交
  • Canonical标签验证
  • Hreflang实施(多语言站点)
  • 301重定向映射
  • 结构化数据验证
  • Meta标签审计
  • 移动端响应性
  • 页面速度基线
  • 分析/跟踪设置

Content Refresh Workflow

内容更新工作流

Identify and optimize underperforming content.
bash
/workflows:content-refresh https://example.com \
  --period 12months \
  --traffic-drop-threshold 30% \
  --ranking-drop-threshold 5
Workflow steps:
  1. Identify declining pages (traffic/rankings)
  2. Analyze SERP changes
  3. Competitor content analysis
  4. Content gap identification
  5. Generate refresh recommendations
  6. Create updated outlines
  7. Track post-refresh performance
识别并优化表现不佳的内容。
bash
/workflows:content-refresh https://example.com \
  --period 12months \
  --traffic-drop-threshold 30% \
  --ranking-drop-threshold 5
工作流步骤:
  1. 识别流量/排名下滑的页面
  2. 分析SERP变化
  3. 竞品内容分析
  4. 内容缺口识别
  5. 生成更新建议
  6. 创建更新大纲
  7. 跟踪更新后表现

Authority Building Campaign

权威度建设活动

End-to-end link building and digital PR.
bash
/workflows:authority-building \
  --domain example.com \
  --target-dr 50 \
  --duration 6months \
  --budget 5000
Campaign phases:
  1. Competitor backlink analysis
  2. Link-worthy asset ideation
  3. Prospect list building
  4. Outreach template creation
  5. Campaign execution tracking
  6. Follow-up automation
  7. Link acquisition monitoring
  8. Impact measurement
端到端外链建设和数字PR。
bash
/workflows:authority-building \
  --domain example.com \
  --target-dr 50 \
  --duration 6months \
  --budget 5000
活动阶段:
  1. 竞品外链分析
  2. 值得外链的资产构思
  3. 潜在合作方列表构建
  4. 沟通模板创建
  5. 活动执行跟踪
  6. 跟进自动化
  7. 外链获取监控
  8. 效果衡量

AI Content Pipeline

AI内容流水线

Automated keyword-to-publish content workflow.
bash
/workflows:ai-content-pipeline \
  --keywords keywords.csv \
  --output-folder ./content \
  --review-before-publish \
  --seo-optimize
Pipeline stages:
  1. Keyword selection & clustering
  2. Search intent analysis
  3. Brief generation
  4. Content drafting (AI-assisted)
  5. SEO optimization pass
  6. Readability enhancement
  7. Fact-checking & citations
  8. Meta data generation
  9. Internal linking suggestions
  10. Publishing/scheduling
从关键词到发布的自动化内容工作流。
bash
/workflows:ai-content-pipeline \
  --keywords keywords.csv \
  --output-folder ./content \
  --review-before-publish \
  --seo-optimize
流水线阶段:
  1. 关键词选择与聚类
  2. 搜索意图分析
  3. Brief生成
  4. AI辅助内容撰写
  5. SEO优化
  6. 可读性提升
  7. 事实核查与引用
  8. Meta数据生成
  9. 内链建议
  10. 发布/排期

Configuration

配置

Create a configuration file for persistent settings:
json
{
  "seo_config": {
    "default_country": "US",
    "default_language": "en",
    "api_keys": {
      "serp_api": "${SERP_API_KEY}",
      "ahrefs": "${AHREFS_API_KEY}",
      "semrush": "${SEMRUSH_API_KEY}",
      "screaming_frog": "${SCREAMING_FROG_API_KEY}"
    },
    "thresholds": {
      "thin_content_words": 300,
      "keyword_difficulty_high": 60,
      "min_domain_authority": 20,
      "core_web_vitals": {
        "lcp_good": 2.5,
        "fid_good": 100,
        "cls_good": 0.1
      }
    },
    "output": {
      "default_format": "markdown",
      "progress_bars": true,
      "color_output": true
    }
  }
}
Save as
~/.claude/skills/seo-marketing/config.json
创建配置文件以保存持久化设置:
json
{
  "seo_config": {
    "default_country": "US",
    "default_language": "en",
    "api_keys": {
      "serp_api": "${SERP_API_KEY}",
      "ahrefs": "${AHREFS_API_KEY}",
      "semrush": "${SEMRUSH_API_KEY}",
      "screaming_frog": "${SCREAMING_FROG_API_KEY}"
    },
    "thresholds": {
      "thin_content_words": 300,
      "keyword_difficulty_high": 60,
      "min_domain_authority": 20,
      "core_web_vitals": {
        "lcp_good": 2.5,
        "fid_good": 100,
        "cls_good": 0.1
      }
    },
    "output": {
      "default_format": "markdown",
      "progress_bars": true,
      "color_output": true
    }
  }
}
保存为
~/.claude/skills/seo-marketing/config.json

Environment Variables

环境变量

Set these for API integrations:
bash
undefined
设置以下变量用于API集成:
bash
undefined

SERP data

SERP数据

export SERP_API_KEY="your_key_here"
export SERP_API_KEY="your_key_here"

SEO tool APIs

SEO工具API

export AHREFS_API_KEY="your_key_here" export SEMRUSH_API_KEY="your_key_here" export MOZ_API_KEY="your_key_here"
export AHREFS_API_KEY="your_key_here" export SEMRUSH_API_KEY="your_key_here" export MOZ_API_KEY="your_key_here"

Crawling

抓取工具

export SCREAMING_FROG_API_KEY="your_key_here"
export SCREAMING_FROG_API_KEY="your_key_here"

Analytics

分析工具

export GOOGLE_ANALYTICS_CREDENTIALS="/path/to/credentials.json" export GOOGLE_SEARCH_CONSOLE_CREDENTIALS="/path/to/credentials.json"
undefined
export GOOGLE_ANALYTICS_CREDENTIALS="/path/to/credentials.json" export GOOGLE_SEARCH_CONSOLE_CREDENTIALS="/path/to/credentials.json"
undefined

Common Patterns

常见模式

Pattern 1: New Site SEO Setup

模式1:新站点SEO设置

bash
undefined
bash
undefined

1. Run pre-launch checklist

1. 运行上线前检查清单

/workflows:launch-seo https://newsite.com
--production-ready-check
/workflows:launch-seo https://newsite.com
--production-ready-check

2. Setup baseline tracking

2. 设置基线跟踪

/serp-monitor setup
--domain newsite.com
--keywords initial-keywords.csv
/serp-monitor setup
--domain newsite.com
--keywords initial-keywords.csv

3. Generate first content batch

3. 生成首批内容

/content-calendar
--topics "core topics"
--period 3months
--posts-per-month 8
undefined
/content-calendar
--topics "core topics"
--period 3months
--posts-per-month 8
undefined

Pattern 2: Declining Traffic Investigation

模式2:流量下滑排查

bash
undefined
bash
undefined

1. Run full technical audit

1. 运行完整技术审计

/technical-seo https://example.com
--scope full
/technical-seo https://example.com
--scope full

2. Check for algorithmic issues

2. 检查算法影响

/content-audit https://example.com
--check-quality
--check-thin-content
/content-audit https://example.com
--check-quality
--check-thin-content

3. Analyze competitor gains

3. 分析竞品增长

/competitor-gap
--target example.com
--competitors competitor1.com,competitor2.com
/competitor-gap
--target example.com
--competitors competitor1.com,competitor2.com

4. Create recovery plan

4. 创建恢复计划

/workflows:content-refresh https://example.com
--period 6months
undefined
/workflows:content-refresh https://example.com
--period 6months
undefined

Pattern 3: Content Scale-Up

模式3:内容规模化

bash
undefined
bash
undefined

1. Research keyword opportunities

1. 研究关键词机会

/keyword-research "industry topic"
--volume-min 500
--difficulty-max 40
--output csv
/keyword-research "industry topic"
--volume-min 500
--difficulty-max 40
--output csv

2. Generate content calendar

2. 生成内容日历

/content-calendar
--seed-keywords keywords.csv
--period 6months
--posts-per-month 16
/content-calendar
--seed-keywords keywords.csv
--period 6months
--posts-per-month 16

3. Setup automated pipeline

3. 设置自动化流水线

/workflows:ai-content-pipeline
--keywords keywords.csv
--review-before-publish
undefined
/workflows:ai-content-pipeline
--keywords keywords.csv
--review-before-publish
undefined

Pattern 4: Authority Building

模式4:权威度建设

bash
undefined
bash
undefined

1. Analyze current backlink profile

1. 分析当前外链档案

/competitor-gap
--target example.com
--competitors competitor1.com
--type backlinks
/competitor-gap
--target example.com
--competitors competitor1.com
--type backlinks

2. Find link prospects

2. 寻找外链潜在合作方

/link-prospecting
--topic "your niche"
--min-da 30
--limit 200
/link-prospecting
--topic "your niche"
--min-da 30
--limit 200

3. Launch campaign

3. 启动活动

/workflows:authority-building
--domain example.com
--target-dr 50
--duration 3months
undefined
/workflows:authority-building
--domain example.com
--target-dr 50
--duration 3months
undefined

Structured Output Format

结构化输出格式

All commands return structured output following this pattern:
╔══════════════════════════════════════════════════╗
║  [COMMAND NAME]  —  [TARGET]                     ║
╠══════════════════════════════════════════════════╣
║  [PROGRESS BAR]                                  ║
╚══════════════════════════════════════════════════╝

┌─────────────────────┬──────────┬──────────┬──────────┐
│ Metric              │ Current  │ Target   │ Status   │
├─────────────────────┼──────────┼──────────┼──────────┤
│ [Metric rows...]                                     │
└─────────────────────┴──────────┴──────────┴──────────┘

🔴 Critical Issues (Fix Immediately)
  • Issue 1 with impact details
  • Issue 2 with impact details

🟠 High Priority (This Week)
  • Issue 3 with impact details

🟡 Medium Priority (This Month)
  • Issue 4 with impact details

🟢 Low Priority / Enhancements
  • Issue 5 with impact details

Next Steps:
  1. [Recommended action]
  2. [Recommended action]

Suggested Follow-up Commands:
  /command-name [args]
所有命令返回的结构化输出遵循以下模式:
╔══════════════════════════════════════════════════╗
║  [COMMAND NAME]  —  [TARGET]                     ║
╠══════════════════════════════════════════════════╣
║  [PROGRESS BAR]                                  ║
╚══════════════════════════════════════════════════╝

┌─────────────────────┬──────────┬──────────┬──────────┐
│ Metric              │ Current  │ Target   │ Status   │
├─────────────────────┼──────────┼──────────┼──────────┤
│ [Metric rows...]                                     │
└─────────────────────┴──────────┴──────────┴──────────┘

🔴 严重问题(立即修复)
  • 问题1及影响详情
  • 问题2及影响详情

🟠 高优先级(本周处理)
  • 问题3及影响详情

🟡 中优先级(本月处理)
  • 问题4及影响详情

🟢 低优先级/优化项
  • 问题5及影响详情

下一步:
  1. [建议操作]
  2. [建议操作]

推荐后续命令:
  /command-name [args]

Troubleshooting

故障排除

API Rate Limits

API速率限制

If you encounter rate limiting:
bash
undefined
如果遇到速率限制:
bash
undefined

Add delay between requests

在请求间添加延迟

/keyword-research "topic" --rate-limit 1req/sec
/keyword-research "topic" --rate-limit 1req/sec

Use cached data when available

尽可能使用缓存数据

/serp-monitor report --use-cache --cache-max-age 24h
undefined
/serp-monitor report --use-cache --cache-max-age 24h
undefined

Large Site Audits

大型站点审计

For sites with 10k+ pages:
bash
undefined
针对10k+页面的站点:
bash
undefined

Use sampling for initial audit

使用抽样进行初始审计

/content-audit https://example.com
--sample-size 1000
--sample-method stratified
/content-audit https://example.com
--sample-size 1000
--sample-method stratified

Or scope to specific sections

或者定向到特定板块

/content-audit https://example.com
--scope /blog,/products
--exclude /category,/tag
undefined
/content-audit https://example.com
--scope /blog,/products
--exclude /category,/tag
undefined

Missing Data Sources

数据源缺失

If API keys aren't configured:
bash
undefined
如果未配置API密钥:
bash
undefined

Run with mock data for testing

使用模拟数据进行测试

/keyword-research "topic" --mock-mode
/keyword-research "topic" --mock-mode

Or use limited free data

或者使用有限的免费数据

/competitor-gap
--target example.com
--competitors competitor.com
--data-source free
undefined
/competitor-gap
--target example.com
--competitors competitor.com
--data-source free
undefined

Slow Performance

性能缓慢

Speed up analysis:
bash
undefined
加速分析:
bash
undefined

Reduce competitor count

减少竞品数量

/competitor-gap --competitors competitor1.com --max-competitors 1
/competitor-gap --competitors competitor1.com --max-competitors 1

Skip expensive checks

跳过耗时检查

/technical-seo https://example.com
--skip crawl,backlinks
--fast-mode
/technical-seo https://example.com
--skip crawl,backlinks
--fast-mode

Parallel processing

并行处理

/content-audit https://example.com --parallel 4
undefined
/content-audit https://example.com --parallel 4
undefined

Integration Examples

集成示例

Export to Google Sheets

导出到Google Sheets

bash
/keyword-research "topic" \
  --output google-sheets \
  --sheet-id "${GOOGLE_SHEET_ID}" \
  --credentials "${GOOGLE_CREDENTIALS_PATH}"
bash
/keyword-research "topic" \
  --output google-sheets \
  --sheet-id "${GOOGLE_SHEET_ID}" \
  --credentials "${GOOGLE_CREDENTIALS_PATH}"

Scheduled Reporting

定时报告

bash
undefined
bash
undefined

Setup daily ranking report via cron

通过cron设置每日排名报告

0 8 * * * /usr/local/bin/claude-agent
"/serp-monitor report --email team@example.com"
undefined
0 8 * * * /usr/local/bin/claude-agent
"/serp-monitor report --email team@example.com"
undefined

CI/CD Pre-Deploy Checks

CI/CD上线前检查

bash
undefined
bash
undefined

In deployment pipeline

在部署流水线中执行

/workflows:launch-seo https://staging.example.com
--production-url https://example.com
--fail-on-critical
--output ci-report
undefined
/workflows:launch-seo https://staging.example.com
--production-url https://example.com
--fail-on-critical
--output ci-report
undefined

Best Practices

最佳实践

  1. Start with Technical Foundation — Fix crawlability and indexing before optimizing content
  2. Prioritize by Impact — Use color-coded severity (🔴🟠🟡🟢) to focus on high-ROI fixes
  3. Validate Before Scaling — Test content strategy with small batch before full calendar
  4. Track Everything — Setup monitoring before making changes to measure impact
  5. Iterate Based on Data — Review reports weekly, adjust strategy monthly
  1. 先搭建技术基础 — 在优化内容前修复可抓取性和索引问题
  2. 按影响优先级处理 — 使用颜色编码的严重程度(🔴🟠🟡🟢)聚焦高ROI修复项
  3. 验证后再规模化 — 在完整日历前用小批量测试内容策略
  4. 跟踪所有数据 — 在进行更改前设置监控以衡量影响
  5. 基于数据迭代 — 每周查看报告,每月调整策略

Additional Resources

额外资源

  • VoltAgent/awesome-agent-skills — Source framework
  • SEO tool API documentation (Ahrefs, SEMrush, Moz)
  • Google Search Central guidelines
  • Core Web Vitals optimization guides

License: MIT — Free to use, modify, and distribute.

许可证: MIT — 可免费使用、修改和分发。