Back to Details

fabled-packer-redeem-seo-content-marketing-suite

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

FabledPackerRedeem SEO & Content Marketing Suite

FabledPackerRedeem SEO与内容营销套件

Skill by ara.so — Marketing Skills collection.
A comprehensive SEO and content marketing automation toolkit providing 10 specialized commands and 5 multi-step workflows for keyword research, technical audits, content optimization, and competitive analysis.
由ara.so开发的技能——营销技能合集。
这是一套全面的SEO和内容营销自动化工具包，提供10个专业命令和5个多步骤工作流，涵盖关键词研究、技术审计、内容优化和竞品分析。

What This Project Does

项目功能

FabledPackerRedeem is a command-line skill suite that provides:
  • Keyword Research: Deep clustering, opportunity scoring, SERP intent mapping
  • Technical SEO Audits: Crawl budget, Core Web Vitals, schema markup validation
  • Content Analysis: Quality scoring, duplication detection, cannibalization reports
  • Competitive Intelligence: Backlink gaps, topic gaps, featured snippet opportunities
  • Content Optimization: AI-generated briefs, NLP term extraction, automated pipelines
  • Monitoring & Tracking: Rank tracking, volatility alerts, CTR optimization
All commands provide structured output with progress tracking, prioritized action plans, and follow-up recommendations.
FabledPackerRedeem是一个命令行技能套件，提供以下功能：
  • 关键词研究：深度聚类、机会评分、SERP意图映射
  • 技术SEO审计：抓取预算、Core Web Vitals、Schema标记验证
  • 内容分析：质量评分、重复内容检测、关键词 cannibalization（自竞争）报告
  • 竞品情报：反向链接差距、主题差距、特色摘要机会
  • 内容优化：AI生成brief、NLP术语提取、自动化流水线
  • 监控与追踪：排名追踪、波动警报、CTR优化
所有命令均提供结构化输出，包含进度追踪、优先级行动计划和后续建议。

Installation

安装

Quick Install

快速安装

bash
undefined
bash
undefined

Clone the repository

克隆仓库

git clone https://github.com/FabledPackerRedeem/r05-jqueryscript-awesome-claude-code-seo.git cd r05-jqueryscript-awesome-claude-code-seo
git clone https://github.com/FabledPackerRedeem/r05-jqueryscript-awesome-claude-code-seo.git cd r05-jqueryscript-awesome-claude-code-seo

Install as Claude Code skill

安装为Claude Code技能

mkdir -p ~/.claude/skills/ cp -r . ~/.claude/skills/fabled-packer-redeem-seo/
mkdir -p ~/.claude/skills/ cp -r . ~/.claude/skills/fabled-packer-redeem-seo/

Register the skill (in Claude Code session)

注册技能（在Claude Code会话中）

/read ~/.claude/skills/fabled-packer-redeem-seo/SKILL.md
undefined
/read ~/.claude/skills/fabled-packer-redeem-seo/SKILL.md
undefined

Manual Integration

手动集成

For non-Claude Code environments, source the commands directly:
bash
undefined
对于非Claude Code环境，可直接导入命令：
bash
undefined

Add to your shell profile

添加到shell配置文件

export SEO_SKILLS_PATH="$HOME/.seo-skills" source "$SEO_SKILLS_PATH/commands.sh"
undefined
export SEO_SKILLS_PATH="$HOME/.seo-skills" source "$SEO_SKILLS_PATH/commands.sh"
undefined

Core Commands

核心命令

/keyword-research

/keyword-research

Performs deep keyword analysis with clustering and opportunity scoring.
Usage:
bash
/keyword-research <target_keyword> [--depth deep|medium|quick] [--output json|md|csv]
Example:
bash
/keyword-research "content marketing tools" --depth deep --output md
Output Structure:
╔══════════════════════════════════════════════════╗
║  Keyword Research  —  "content marketing tools"  ║
╠══════════════════════════════════════════════════╣
║  Fetching SERP data …     [██████████] 100% ✓    ║
║  Clustering keywords …    [██████████] 100% ✓    ║
║  Scoring opportunities …  [██████████] 100% ✓    ║
╚══════════════════════════════════════════════════╝

Primary Keyword: "content marketing tools"
Monthly Volume: 18,100
Difficulty: 62/100
Intent: Commercial Investigation

┌──────────────────────────────┬────────┬────────┬──────────┬──────────┐
│ Keyword                      │ Volume │ Diff.  │ Intent   │ Priority │
├──────────────────────────────┼────────┼────────┼──────────┼──────────┤
│ content marketing tools      │ 18,100 │ 62     │ Comm.    │ 🔴 High  │
│ best content marketing tools │  5,400 │ 58     │ Comm.    │ 🟠 High  │
│ free content marketing tools │  2,900 │ 45     │ Comm.    │ 🟡 Med   │
│ content marketing software   │  8,900 │ 68     │ Comm.    │ 🔴 High  │
└──────────────────────────────┴────────┴────────┴──────────┴──────────┘

Action Plan:
  ✓ Target primary keyword with pillar content (2,500+ words)
  ✓ Create comparison post for "best content marketing tools"
  ✓ Build resource page for "free content marketing tools"

Next Steps: /content-brief "content marketing tools"
执行深度关键词分析，包含聚类和机会评分。
用法：
bash
/keyword-research <target_keyword> [--depth deep|medium|quick] [--output json|md|csv]
示例：
bash
/keyword-research "content marketing tools" --depth deep --output md
输出结构：
╔══════════════════════════════════════════════════╗
║  Keyword Research  —  "content marketing tools"  ║
╠══════════════════════════════════════════════════╣
║  Fetching SERP data …     [██████████] 100% ✓    ║
║  Clustering keywords …    [██████████] 100% ✓    ║
║  Scoring opportunities …  [██████████] 100% ✓    ║
╚══════════════════════════════════════════════════╝

Primary Keyword: "content marketing tools"
Monthly Volume: 18,100
Difficulty: 62/100
Intent: Commercial Investigation

┌──────────────────────────────┬────────┬────────┬──────────┬──────────┐
│ Keyword                      │ Volume │ Diff.  │ Intent   │ Priority │
├──────────────────────────────┼────────┼────────┼──────────┼──────────┤
│ content marketing tools      │ 18,100 │ 62     │ Comm.    │ 🔴 High  │
│ best content marketing tools │  5,400 │ 58     │ Comm.    │ 🟠 High  │
│ free content marketing tools │  2,900 │ 45     │ Comm.    │ 🟡 Med   │
│ content marketing software   │  8,900 │ 68     │ Comm.    │ 🔴 High  │
└──────────────────────────────┴────────┴────────┴──────────┴──────────┘

Action Plan:
  ✓ Target primary keyword with pillar content (2,500+ words)
  ✓ Create comparison post for "best content marketing tools"
  ✓ Build resource page for "free content marketing tools"

Next Steps: /content-brief "content marketing tools"

/content-audit

/content-audit

Full-site content quality analysis with duplication and cannibalization detection.
Usage:
bash
/content-audit <domain> [--scope full|blog|category] [--min-words 300] [--output md]
Example:
bash
/content-audit example.com --scope full --min-words 500 --output md
Configuration:
bash
undefined
全站点内容质量分析，包含重复内容和关键词自竞争检测。
用法：
bash
/content-audit <domain> [--scope full|blog|category] [--min-words 300] [--output md]
示例：
bash
/content-audit example.com --scope full --min-words 500 --output md
配置：
bash
undefined

Set audit parameters via environment variables

通过环境变量设置审计参数

export SEO_AUDIT_CRAWL_DELAY=1000 # ms between requests export SEO_AUDIT_MAX_PAGES=5000 export SEO_AUDIT_USER_AGENT="SEO-Audit-Bot/1.0" export SEO_AUDIT_RESPECT_ROBOTS=true

**Output:**
Content Audit Summary:
Pages Analyzed: 1,204 Avg. Word Count: 847 Duplicate Content: 23 pages (1.9%) Keyword Cannibalization: 14 clusters
┌─────────────────────┬──────────┬─────────┬──────────────┐ │ Issue │ Count │ Impact │ Action │ ├─────────────────────┼──────────┼─────────┼──────────────┤ │ Thin content (<300) │ 187 │ 🔴 High │ Expand/301 │ │ Missing title │ 24 │ 🔴 High │ Add titles │ │ Missing meta desc │ 302 │ 🟠 Med │ Add meta │ │ Duplicate content │ 23 │ 🟠 Med │ Canonical │ │ Broken images │ 45 │ 🟡 Low │ Fix/replace │ └─────────────────────┴──────────┴─────────┴──────────────┘
undefined
export SEO_AUDIT_CRAWL_DELAY=1000 # 请求间隔毫秒数 export SEO_AUDIT_MAX_PAGES=5000 export SEO_AUDIT_USER_AGENT="SEO-Audit-Bot/1.0" export SEO_AUDIT_RESPECT_ROBOTS=true

**输出：**
Content Audit Summary:
Pages Analyzed: 1,204 Avg. Word Count: 847 Duplicate Content: 23 pages (1.9%) Keyword Cannibalization: 14 clusters
┌─────────────────────┬──────────┬─────────┬──────────────┐ │ Issue │ Count │ Impact │ Action │ ├─────────────────────┼──────────┼─────────┼──────────────┤ │ Thin content (<300) │ 187 │ 🔴 High │ Expand/301 │ │ Missing title │ 24 │ 🔴 High │ Add titles │ │ Missing meta desc │ 302 │ 🟠 Med │ Add meta │ │ Duplicate content │ 23 │ 🟠 Med │ Canonical │ │ Broken images │ 45 │ 🟡 Low │ Fix/replace │ └─────────────────────┴──────────┴─────────┴──────────────┘
undefined

/technical-seo

/technical-seo

Comprehensive technical SEO audit covering crawlability, indexability, and performance.
Usage:
bash
/technical-seo <domain> [--include sitemap,robots,schema,vitals] [--output json]
Example:
bash
/technical-seo example.com --include sitemap,robots,schema,vitals --output json
Environment Variables:
bash
export PAGESPEED_API_KEY="${GOOGLE_PAGESPEED_API_KEY}"
export SEARCH_CONSOLE_CREDENTIALS="${GOOGLE_SEARCH_CONSOLE_JSON}"
export CRAWL_DEPTH=5
全面的技术SEO审计，涵盖可抓取性、可索引性和性能。
用法：
bash
/technical-seo <domain> [--include sitemap,robots,schema,vitals] [--output json]
示例：
bash
/technical-seo example.com --include sitemap,robots,schema,vitals --output json
环境变量：
bash
export PAGESPEED_API_KEY="${GOOGLE_PAGESPEED_API_KEY}"
export SEARCH_CONSOLE_CREDENTIALS="${GOOGLE_SEARCH_CONSOLE_JSON}"
export CRAWL_DEPTH=5

/competitor-gap

/competitor-gap

Identifies backlink gaps, topic gaps, and featured snippet opportunities.
Usage:
bash
/competitor-gap <your_domain> <competitor1,competitor2,competitor3> [--focus backlinks|content|snippets]
Example:
bash
/competitor-gap example.com competitor1.com,competitor2.com --focus backlinks
Output:
Backlink Gap Analysis:

Your Domain: example.com (DR: 45)
Competitor 1: competitor1.com (DR: 62)
Competitor 2: competitor2.com (DR: 58)

Common Backlinks (They have, you don't): 347 domains

Top Opportunities:
┌──────────────────────────┬─────┬──────┬───────────────┐
│ Referring Domain         │ DR  │ Type │ Opportunity   │
├──────────────────────────┼─────┼──────┼───────────────┤
│ industry-blog.com        │ 72  │ Blog │ Guest post    │
│ resource-directory.org   │ 68  │ Dir  │ Listing       │
│ news-site.com            │ 81  │ News │ Digital PR    │
└──────────────────────────┴─────┴──────┴───────────────┘

Next Steps: /link-prospecting industry-blog.com
识别反向链接差距、主题差距和特色摘要机会。
用法：
bash
/competitor-gap <your_domain> <competitor1,competitor2,competitor3> [--focus backlinks|content|snippets]
示例：
bash
/competitor-gap example.com competitor1.com,competitor2.com --focus backlinks
输出：
Backlink Gap Analysis:

Your Domain: example.com (DR: 45)
Competitor 1: competitor1.com (DR: 62)
Competitor 2: competitor2.com (DR: 58)

Common Backlinks (They have, you don't): 347 domains

Top Opportunities:
┌──────────────────────────┬─────┬──────┬───────────────┐
│ Referring Domain         │ DR  │ Type │ Opportunity   │
├──────────────────────────┼─────┼──────┼───────────────┤
│ industry-blog.com        │ 72  │ Blog │ Guest post    │
│ resource-directory.org   │ 68  │ Dir  │ Listing       │
│ news-site.com            │ 81  │ News │ Digital PR    │
└──────────────────────────┴─────┴──────┴───────────────┘

Next Steps: /link-prospecting industry-blog.com

/content-brief

/content-brief

Generates AI-powered SEO content briefs with outlines, NLP terms, and targets.
Usage:
bash
/content-brief <target_keyword> [--serp-analysis] [--competitors 10] [--format md]
Example:
bash
/content-brief "email marketing best practices" --serp-analysis --competitors 10
Output:
markdown
undefined
生成AI驱动的SEO内容brief，包含大纲、NLP术语和目标指标。
用法：
bash
/content-brief <target_keyword> [--serp-analysis] [--competitors 10] [--format md]
示例：
bash
/content-brief "email marketing best practices" --serp-analysis --competitors 10
输出：
markdown
undefined

Content Brief: "email marketing best practices"

Content Brief: "email marketing best practices"

Target Metrics

Target Metrics

  • Primary Keyword: email marketing best practices
  • Search Volume: 14,800/month
  • Difficulty: 54/100
  • Intent: Informational
  • Target Word Count: 2,800-3,200 words
  • Reading Level: Grade 10-12
  • Primary Keyword: email marketing best practices
  • Search Volume: 14,800/month
  • Difficulty: 54/100
  • Intent: Informational
  • Target Word Count: 2,800-3,200 words
  • Reading Level: Grade 10-12

Content Outline

Content Outline

1. Introduction (200 words)

1. Introduction (200 words)

  • Hook: Email marketing ROI statistics
  • Preview of best practices
  • Reader benefit statement
  • Hook: Email marketing ROI statistics
  • Preview of best practices
  • Reader benefit statement

2. List Building Best Practices (500 words)

2. List Building Best Practices (500 words)

  • Double opt-in implementation
  • Lead magnet strategies
  • GDPR compliance
  • Double opt-in implementation
  • Lead magnet strategies
  • GDPR compliance

3. Email Design & Formatting (600 words)

3. Email Design & Formatting (600 words)

  • Mobile responsiveness
  • Visual hierarchy
  • CTA placement
[... continues ...]
  • Mobile responsiveness
  • Visual hierarchy
  • CTA placement
[... continues ...]

Required NLP Terms (Include naturally)

Required NLP Terms (Include naturally)

  • email deliverability (4-6 times)
  • subscriber engagement (3-5 times)
  • email automation (5-7 times)
  • A/B testing (3-4 times)
  • personalization (6-8 times)
  • email deliverability (4-6 times)
  • subscriber engagement (3-5 times)
  • email automation (5-7 times)
  • A/B testing (3-4 times)
  • personalization (6-8 times)

Competitor Analysis

Competitor Analysis

Top 10 ranking pages average:
  • Word count: 2,943
  • Images: 12
  • External links: 18
  • Internal links: 24
undefined
Top 10 ranking pages average:
  • Word count: 2,943
  • Images: 12
  • External links: 18
  • Internal links: 24
undefined

/serp-monitor

/serp-monitor

Daily rank tracking with volatility alerts and CTR optimization recommendations.
Usage:
bash
/serp-monitor <domain> [--keywords keyword-list.txt] [--frequency daily|weekly]
Configuration:
bash
export SERP_API_KEY="${SERPAPI_KEY}"
export SERP_LOCATION="United States"
export SERP_DEVICE="desktop"
export SERP_ALERT_THRESHOLD=5  # Alert if position drops by 5+
每日排名追踪，包含波动警报和CTR优化建议。
用法：
bash
/serp-monitor <domain> [--keywords keyword-list.txt] [--frequency daily|weekly]
配置：
bash
export SERP_API_KEY="${SERPAPI_KEY}"
export SERP_LOCATION="United States"
export SERP_DEVICE="desktop"
export SERP_ALERT_THRESHOLD=5  # 排名下降5位以上触发警报

/link-prospecting

/link-prospecting

Generates quality backlink prospect lists with DA/DR filters and outreach templates.
Usage:
bash
/link-prospecting <topic> [--min-dr 40] [--exclude domains.txt] [--output csv]
Example:
bash
/link-prospecting "content marketing" --min-dr 50 --output csv
生成高质量反向链接潜在列表，包含DA/DR过滤和外展模板。
用法：
bash
/link-prospecting <topic> [--min-dr 40] [--exclude domains.txt] [--output csv]
示例：
bash
/link-prospecting "content marketing" --min-dr 50 --output csv

/page-speed-seo

/page-speed-seo

Analyzes page speed metrics and maps them to ranking impact.
Usage:
bash
/page-speed-seo <url> [--device mobile|desktop] [--detailed]
Environment Variables:
bash
export LIGHTHOUSE_API_ENDPOINT="${LIGHTHOUSE_API_URL}"
export CRUX_API_KEY="${CHROME_UX_REPORT_API_KEY}"
分析页面速度指标并映射其对排名的影响。
用法：
bash
/page-speed-seo <url> [--device mobile|desktop] [--detailed]
环境变量：
bash
export LIGHTHOUSE_API_ENDPOINT="${LIGHTHOUSE_API_URL}"
export CRUX_API_KEY="${CHROME_UX_REPORT_API_KEY}"

/local-seo

/local-seo

NAP consistency checker, Google Business Profile optimizer, local citation auditor.
Usage:
bash
/local-seo <business_name> <location> [--check-citations] [--gbp-optimize]
NAP一致性检查器、Google Business Profile优化器、本地引用审计工具。
用法：
bash
/local-seo <business_name> <location> [--check-citations] [--gbp-optimize]

/content-calendar

/content-calendar

Generates data-driven editorial calendars from search demand and seasonality.
Usage:
bash
/content-calendar <niche> [--months 6] [--frequency weekly] [--format xlsx]
Example:
bash
/content-calendar "digital marketing" --months 12 --frequency weekly --format xlsx
基于搜索需求和季节性生成数据驱动的编辑日历。
用法：
bash
/content-calendar <niche> [--months 6] [--frequency weekly] [--format xlsx]
示例：
bash
/content-calendar "digital marketing" --months 12 --frequency weekly --format xlsx

Workflows (Multi-Step Automation)

工作流（多步骤自动化）

full-seo-sprint

full-seo-sprint

12-step comprehensive SEO sprint from audit to implementation.
Usage:
bash
/workflows:full-seo-sprint <domain> [--scope full|quick] [--duration 30d|60d|90d]
Steps:
  1. Technical SEO audit
  2. Keyword research & mapping
  3. Competitor gap analysis
  4. Content audit
  5. On-page optimization plan
  6. Link building strategy
  7. Content calendar creation
  8. Schema markup implementation
  9. Core Web Vitals optimization
  10. Analytics & tracking setup
  11. Monitoring dashboard
  12. Monthly reporting template
12步全面SEO冲刺，从审计到落地实施。
用法：
bash
/workflows:full-seo-sprint <domain> [--scope full|quick] [--duration 30d|60d|90d]
步骤：
  1. 技术SEO审计
  2. 关键词研究与映射
  3. 竞品差距分析
  4. 内容审计
  5. 页面优化计划
  6. 外链建设策略
  7. 内容日历创建
  8. Schema标记实施
  9. Core Web Vitals优化
  10. 分析与追踪设置
  11. 监控仪表盘
  12. 月度报告模板

launch-seo

launch-seo

Pre-launch SEO validation checklist.
Usage:
bash
/workflows:launch-seo <staging_url> [--checklist-only] [--fix-auto]
Validates:
  • Canonical tags
  • Hreflang implementation
  • Robots.txt
  • XML sitemap
  • Structured data
  • Meta tags
  • Mobile responsiveness
  • Page speed
上线前SEO验证清单。
用法：
bash
/workflows:launch-seo <staging_url> [--checklist-only] [--fix-auto]
验证内容：
  • Canonical标签
  • Hreflang实施
  • Robots.txt
  • XML sitemap
  • 结构化数据
  • Meta标签
  • 移动端适配
  • 页面速度

content-refresh

content-refresh

Identifies and refreshes underperforming content.
Usage:
bash
/workflows:content-refresh <domain> [--min-age 180d] [--traffic-drop 30%]
识别并更新表现不佳的内容。
用法：
bash
/workflows:content-refresh <domain> [--min-age 180d] [--traffic-drop 30%]

authority-building

authority-building

End-to-end digital PR and link-building campaign.
Usage:
bash
/workflows:authority-building <domain> <target_dr> [--timeline 90d]
端到端数字PR和外链建设活动。
用法：
bash
/workflows:authority-building <domain> <target_dr> [--timeline 90d]

ai-content-pipeline

ai-content-pipeline

Automated content creation pipeline from keyword to publish.
Usage:
bash
/workflows:ai-content-pipeline <keyword_list> [--auto-publish] [--cms wordpress]
Environment Variables:
bash
export WORDPRESS_API_URL="${WP_SITE_URL}/wp-json/wp/v2"
export WORDPRESS_APP_PASSWORD="${WP_APP_PASSWORD}"
export OPENAI_API_KEY="${OPENAI_API_KEY}"
export CONTENT_REVIEW_REQUIRED=true
从关键词到发布的自动化内容创建流水线。
用法：
bash
/workflows:ai-content-pipeline <keyword_list> [--auto-publish] [--cms wordpress]
环境变量：
bash
export WORDPRESS_API_URL="${WP_SITE_URL}/wp-json/wp/v2"
export WORDPRESS_APP_PASSWORD="${WP_APP_PASSWORD}"
export OPENAI_API_KEY="${OPENAI_API_KEY}"
export CONTENT_REVIEW_REQUIRED=true

Common Patterns

常用模式

Batch Keyword Analysis

批量关键词分析

bash
undefined
bash
undefined

Process multiple keywords from file

处理文件中的多个关键词

cat keywords.txt | while read keyword; do /keyword-research "$keyword" --output json >> results.jsonl done
undefined
cat keywords.txt | while read keyword; do /keyword-research "$keyword" --output json >> results.jsonl done
undefined

Scheduled Monitoring

定时监控

bash
undefined
bash
undefined

Add to crontab for daily monitoring

添加到crontab实现每日监控

0 6 * * * /usr/local/bin/seo-skills /serp-monitor example.com --keywords keywords.txt --email-alerts
undefined
0 6 * * * /usr/local/bin/seo-skills /serp-monitor example.com --keywords keywords.txt --email-alerts
undefined

Multi-Domain Audits

多域名审计

bash
undefined
bash
undefined

Audit multiple domains

审计多个域名

for domain in $(cat domains.txt); do /technical-seo "$domain" --output "reports/${domain}_audit.json" done
undefined
for domain in $(cat domains.txt); do /technical-seo "$domain" --output "reports/${domain}_audit.json" done
undefined

Integration with CI/CD

CI/CD集成

bash
undefined
bash
undefined

Pre-deployment SEO check

部署前SEO检查

#!/bin/bash STAGING_URL="${DEPLOY_URL}" /workflows:launch-seo "$STAGING_URL" --checklist-only
if [ $? -ne 0 ]; then echo "SEO validation failed. Blocking deployment." exit 1 fi
undefined
#!/bin/bash STAGING_URL="${DEPLOY_URL}" /workflows:launch-seo "$STAGING_URL" --checklist-only
if [ $? -ne 0 ]; then echo "SEO验证失败，阻止部署。" exit 1 fi
undefined

Programmatic Usage

程序化调用

While primarily a CLI tool, core functions can be imported:
javascript
// Example integration (Node.js)
const { keywordResearch, contentAudit } = require('fabled-packer-redeem-seo');

async function analyzeCompetitor(domain) {
  const audit = await contentAudit(domain, {
    scope: 'full',
    minWords: 500
  });
  
  const keywords = await keywordResearch(audit.topKeywords[0], {
    depth: 'deep'
  });
  
  return {
    audit,
    keywords,
    recommendations: generateRecommendations(audit, keywords)
  };
}
虽然主要是CLI工具，但核心功能可被导入使用：
javascript
// Node.js集成示例
const { keywordResearch, contentAudit } = require('fabled-packer-redeem-seo');

async function analyzeCompetitor(domain) {
  const audit = await contentAudit(domain, {
    scope: 'full',
    minWords: 500
  });
  
  const keywords = await keywordResearch(audit.topKeywords[0], {
    depth: 'deep'
  });
  
  return {
    audit,
    keywords,
    recommendations: generateRecommendations(audit, keywords)
  };
}

Troubleshooting

故障排除

API Rate Limiting

API速率限制

bash
undefined
bash
undefined

Increase delays between requests

增加请求间隔

export SEO_AUDIT_CRAWL_DELAY=2000 export SEO_API_RATE_LIMIT=10 # requests per second
undefined
export SEO_AUDIT_CRAWL_DELAY=2000 export SEO_API_RATE_LIMIT=10 # 每秒请求数
undefined

Large Site Audits Timing Out

大型站点审计超时

bash
undefined
bash
undefined

Use incremental auditing

使用增量审计

/content-audit example.com --scope blog --max-pages 1000 /content-audit example.com --scope products --max-pages 1000
undefined
/content-audit example.com --scope blog --max-pages 1000 /content-audit example.com --scope products --max-pages 1000
undefined

Missing Dependencies

缺失依赖

bash
undefined
bash
undefined

Install optional dependencies for advanced features

安装高级功能所需的可选依赖

npm install -g lighthouse puppeteer
undefined
npm install -g lighthouse puppeteer
undefined

Search Console Authentication Issues

Search Console认证问题

bash
undefined
bash
undefined

Verify credentials file

验证凭证文件

export SEARCH_CONSOLE_CREDENTIALS="/path/to/service-account.json"
export SEARCH_CONSOLE_CREDENTIALS="/path/to/service-account.json"

Test connection

测试连接

gcloud auth application-default login
undefined
gcloud auth application-default login
undefined

Memory Issues on Large Datasets

大数据集内存问题

bash
undefined
bash
undefined

Increase Node.js memory limit

增加Node.js内存限制

export NODE_OPTIONS="--max-old-space-size=8192"
undefined
export NODE_OPTIONS="--max-old-space-size=8192"
undefined

Configuration Files

配置文件

.seorc.json

.seorc.json

json
{
  "defaults": {
    "crawlDelay": 1000,
    "userAgent": "SEO-Skills-Bot/1.0",
    "maxPages": 5000,
    "respectRobots": true
  },
  "apis": {
    "serpapi": {
      "key": "${SERPAPI_KEY}",
      "location": "United States",
      "device": "desktop"
    },
    "pageSpeed": {
      "key": "${GOOGLE_PAGESPEED_API_KEY}",
      "strategy": "mobile"
    }
  },
  "output": {
    "format": "markdown",
    "directory": "./seo-reports"
  }
}
json
{
  "defaults": {
    "crawlDelay": 1000,
    "userAgent": "SEO-Skills-Bot/1.0",
    "maxPages": 5000,
    "respectRobots": true
  },
  "apis": {
    "serpapi": {
      "key": "${SERPAPI_KEY}",
      "location": "United States",
      "device": "desktop"
    },
    "pageSpeed": {
      "key": "${GOOGLE_PAGESPEED_API_KEY}",
      "strategy": "mobile"
    }
  },
  "output": {
    "format": "markdown",
    "directory": "./seo-reports"
  }
}

keywords.yaml

keywords.yaml

yaml
primary:
  - keyword: "content marketing"
    priority: high
    target_url: "/blog/content-marketing-guide"
  
  - keyword: "email marketing"
    priority: high
    target_url: "/blog/email-marketing-guide"

secondary:
  - keyword: "marketing automation"
    priority: medium
    target_url: "/blog/marketing-automation"
yaml
primary:
  - keyword: "content marketing"
    priority: high
    target_url: "/blog/content-marketing-guide"
  
  - keyword: "email marketing"
    priority: high
    target_url: "/blog/email-marketing-guide"

secondary:
  - keyword: "marketing automation"
    priority: medium
    target_url: "/blog/marketing-automation"

Advanced Usage

高级用法

Custom Scoring Models

自定义评分模型

bash
undefined
bash
undefined

Override default opportunity scoring

覆盖默认机会评分规则

/keyword-research "marketing tools"
--score-weights "volume:0.4,difficulty:0.3,intent:0.3"
--difficulty-threshold 60
undefined
/keyword-research "marketing tools"
--score-weights "volume:0.4,difficulty:0.3,intent:0.3"
--difficulty-threshold 60
undefined

White-Label Reports

白标报告

bash
undefined
bash
undefined

Generate branded PDF reports

生成品牌化PDF报告

/content-audit example.com
--output pdf
--template "./templates/agency-report.hbs"
--logo "./assets/logo.png"
undefined
/content-audit example.com
--output pdf
--template "./templates/agency-report.hbs"
--logo "./assets/logo.png"
undefined

Webhook Integration

Webhook集成

bash
undefined
bash
undefined

Send results to webhook

将结果发送到Webhook

/serp-monitor example.com
--webhook "${SLACK_WEBHOOK_URL}"
--alert-on "position_drop,position_gain,new_competitor"
undefined
/serp-monitor example.com
--webhook "${SLACK_WEBHOOK_URL}"
--alert-on "position_drop,position_gain,new_competitor"
undefined

Additional Resources

额外资源

License

许可证

MIT — Free to use, modify, and distribute.
MIT — 可免费使用、修改和分发。