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):

Create OAuth credentials at Google Cloud Console (Desktop app type)
Download JSON → save as .claude/secrets/google_client_secret.json (project) or ~/.claude/secrets/ (global)
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