seo-optimization

name	seo-optimization
description	SEO audits, keyword research with ReviewWeb.site API (keyword ideas, difficulty, traffic, backlinks), on-page optimization, technical SEO, programmatic SEO (pSEO), JSON+LD schema, Google Search Console API integration. Activate for search optimization, meta tags, sitemap, Core Web Vitals. Used by seo-specialist, attraction-specialist, content-creator agents.
license	MIT

SEO Optimization

Technical SEO, keyword research (ReviewWeb.site API), Google Search Console API, and programmatic SEO.

When to Use

• Keyword research with real data (volume, difficulty, CPC)
• Competitor domain analysis (traffic, top keywords, backlinks)
• Google Search Console data (queries, pages, clicks, impressions, CTR, position)
• SEO audit or technical analysis
• JSON+LD schema generation
• Programmatic SEO (pSEO) templates
• Core Web Vitals measurement (browser-based or API)

Quick Start: Google Search Console

Prerequisites:

• Node.js 18+ with googleapis package (npm install googleapis)
• Enable Search Console API in your Google Cloud project

Setup (one-time):

1. Create OAuth credentials at Google Cloud Console (Desktop app type)
2. Download JSON → save as .claude/secrets/google_client_secret.json (project) or ~/.claude/secrets/ (global)
3. Authenticate:

node scripts/gsc-auth.cjs --auth

Query data:

node scripts/gsc-query.cjs --sites                                    # List sites
node scripts/gsc-query.cjs --top-queries -s https://example.com       # Top queries
node scripts/gsc-query.cjs --low-ctr -s https://example.com -o low-ctr.csv -f csv

See google-search-console-api-guide.md for full API reference.

Scripts

Google Search Console (OAuth2)

Config: google_client_secret.json in .claude/secrets/ (project or ~/.claude/secrets/ global)

Script	Purpose
gsc-config-loader.cjs	Cross-platform config/token resolution
gsc-auth.cjs	OAuth2 authentication flow
gsc-query.cjs	Query analytics, sitemaps, URL inspection

node scripts/gsc-auth.cjs --auth                    # Authenticate
node scripts/gsc-auth.cjs --verify                  # Check token
node scripts/gsc-query.cjs --top-queries -s URL     # Top queries
node scripts/gsc-query.cjs --inspect -s URL -u /page  # Inspect URL

Keyword Research (ReviewWeb.site API)

Requires: REVIEWWEB_API_KEY in .env

node scripts/analyze-keywords.cjs -k "react tutorial" -o report.md
node scripts/analyze-keywords.cjs -d "competitor.com" -o analysis.md

Core Web Vitals (PageSpeed API)

node scripts/audit-core-web-vitals.cjs -u https://example.com
node scripts/audit-core-web-vitals.cjs -s sitemap.xml -f md -o report.md

Other Scripts

Script	Purpose
generate-sitemap.cjs	XML sitemap generation
generate-schema.cjs	JSON+LD schema generator
validate-schema.cjs	Validate JSON-LD
pseo-generator.cjs	pSEO page generation

References

Search Console: google-search-console-api-guide.md, search-console-query-patterns.md

API: reviewweb-api.md, reviewweb-content-api.md

Audit Workflows: seo-audit-workflow.md, browser-seo-audit-workflow.md

Keyword Research: keyword-research-workflow.md, keyword-clustering-methodology.md, content-gap-analysis-framework.md

Technical SEO: technical-seo-checklist.md, core-web-vitals-remediation.md, sitemap-best-practices.md, robots-txt-best-practices-2025.md, canonical-url-strategy.md, mobile-seo-checklist.md

On-Page SEO: on-page-seo-checklist-2025.md, meta-tag-templates.md, semantic-seo-framework.md, readability-scoring-guide.md, internal-linking-automation.md

Programmatic SEO: pseo-templates.md, pseo-best-practices.md, pseo-template-syntax.md, pseo-url-structure-guide.md, pseo-scale-architecture.md

Link Building: backlink-analysis-framework.md, link-building-campaign-framework.md, outreach-email-templates.md, directory-submission-list.md

Schema: schema-generation.md, schema-templates/ (article, product, faq, howto, organization, localbusiness)

Report Output

Activate: assets-organizing skill for report file paths

Report Type	Path
SEO Audits	assets/reports/seo/{date}-{domain}-audit.md
Keyword Research	assets/reports/seo/{date}-{topic}-keywords.md
Ranking Reports	assets/reports/seo/{date}-{domain}-rankings.md
CWV Reports	assets/reports/seo/{date}-{domain}-cwv.md

Cross-Skill Integration

chrome-devtools: Real browser CWV, screenshots, network analysis → browser-seo-audit-workflow.md

assets-organizing: Report file organization and naming conventions