SEO Optimization

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)

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

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

Cross-Skill Integration

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

assets-organizing: Report file organization and naming conventions