Increase search visibility through data-driven keyword research, technical audits, and programmatic SEO strategies.

What This Skill Does

The Challenge: SEO requires combining keyword research, technical audits, content optimization, and performance monitoring across multiple tools and platforms. Manual workflows are time-consuming and error-prone.

The Solution: SEO Optimization skill integrates ReviewWeb.site API for keyword data (volume, difficulty, CPC), Google Search Console API for ranking insights, Core Web Vitals measurement, and programmatic SEO templates. Provides automated audits, schema generation, and sitemap management.

Activation

Implicit: Activates automatically for SEO Specialist, Attraction Specialist, and Content Creator agents.

Explicit: Activate via prompt:

Activate seo-optimization skill to [describe task]

Capabilities

1. Keyword Research with ReviewWeb API

Fetch real keyword data including search volume, difficulty, CPC, and top-ranking pages.

node scripts/analyze-keywords.cjs -k "react tutorial" -o report.md

Output: Markdown report with:

  • Primary keyword metrics (volume, difficulty, CPC)
  • Related keywords with opportunities
  • Top 10 ranking page analysis
  • Content gap recommendations

API Documentation: references/reviewweb-api.md

2. Google Search Console Integration

Query search performance data including clicks, impressions, CTR, and rankings.

Setup (one-time):

  1. Enable Search Console API in Google Cloud
  2. Download OAuth credentials as google_client_secret.json
  3. Place in .claude/secrets/ (project or global)
  4. Authenticate: node scripts/gsc-auth.cjs --auth

Example Queries:

# List verified sites
node scripts/gsc-query.cjs --sites

# Top search queries
node scripts/gsc-query.cjs --top-queries -s https://example.com

# Low CTR opportunities
node scripts/gsc-query.cjs --low-ctr -s https://example.com -o low-ctr.csv -f csv

Full Guide: references/google-search-console-api-guide.md

3. Core Web Vitals Measurement

Audit page performance using PageSpeed Insights API.

# Audit single URL
node scripts/audit-core-web-vitals.cjs -u https://example.com

# Batch audit from sitemap
node scripts/audit-core-web-vitals.cjs -s sitemap.xml -f md -o cwv-report.md

Metrics Tracked: LCP (Largest Contentful Paint), FID (First Input Delay), CLS (Cumulative Layout Shift)

Remediation Guide: references/core-web-vitals-remediation.md

Prerequisites

For keyword research:

  • REVIEWWEB_API_KEY in .env file
  • Node.js 18+

For Google Search Console:

  • Google Cloud project with Search Console API enabled
  • OAuth 2.0 credentials (Desktop app type)
  • npm package googleapis: npm install googleapis

For Core Web Vitals:

  • PageSpeed Insights API key (optional, free tier available)

Configuration

Environment Variables (.env):

REVIEWWEB_API_KEY=your_api_key_here
PAGESPEED_API_KEY=your_key_here  # Optional

Secrets Directory: .claude/secrets/

  • google_client_secret.json - OAuth credentials
  • google_tokens.json - Generated after authentication

Best Practices

1. Target Long-Tail Keywords First Lower difficulty, higher conversion intent. Build authority before competing for head terms.

2. Optimize for Search Intent, Not Just Keywords Match content format to search intent: informational, navigational, commercial, transactional.

3. Fix Technical SEO Before Content Core Web Vitals, mobile-friendliness, and crawlability issues block ranking improvements.

Common Use Cases

Use Case 1: Content Opportunity Discovery

Scenario: Find keyword opportunities for next quarter’s blog content.

Workflow:

  1. Research seed keyword: node scripts/analyze-keywords.cjs -k "saas marketing"
  2. Extract related keywords from report
  3. Filter by difficulty <40 and volume >500
  4. Map keywords to content pillars
  5. Create editorial calendar

Output: 20+ keyword opportunities with search volume and difficulty scores.

Use Case 2: Search Performance Analysis

Scenario: Identify pages with low CTR despite high impressions.

Workflow:

  1. Query Search Console: node scripts/gsc-query.cjs --low-ctr -s https://yoursite.com
  2. Analyze title tags and meta descriptions
  3. Rewrite to improve CTR
  4. Monitor changes over 2-4 weeks

Output: Prioritized page list with optimization recommendations.

Troubleshooting

Issue: ReviewWeb API returns 401 Unauthorized Solution: Verify REVIEWWEB_API_KEY in .env file. Check API quota at ReviewWeb dashboard.

Issue: Google Search Console authentication fails Solution:

  1. Verify OAuth credentials match app type (Desktop app)
  2. Delete existing google_tokens.json and re-authenticate
  3. Check API is enabled in Google Cloud Console

Issue: Core Web Vitals script timeouts Solution: Use --timeout 60000 flag or audit smaller URL batches. PageSpeed API has rate limits.

  • /seo/keywords - Keyword research workflow
  • /seo/audit - Full SEO audit
  • /seo/competitor - Competitor analysis
  • /content/blog - SEO-optimized blog generation