# seo-optimization

> 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.

- Author: HTBK
- Repository: huynhtrungbk/Trung-DevKit-Antigravity
- Version: 20260125071554
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/huynhtrungbk/Trung-DevKit-Antigravity
- Web: https://mule.run/skillshub/@@huynhtrungbk/Trung-DevKit-Antigravity~seo-optimization:20260125071554

---

---
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](https://console.cloud.google.com/apis/library/searchconsole.googleapis.com) in your Google Cloud project

**Setup (one-time):**

1. Create OAuth credentials at [Google Cloud Console](https://console.cloud.google.com/apis/credentials) (Desktop app type)
2. Download JSON → save as `.agent/secrets/google_client_secret.json` (project) or `~/.agent/secrets/` (global)
3. Authenticate:
```bash
node scripts/gsc-auth.cjs --auth
```

**Query data:**
```bash
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 `.agent/secrets/` (project or `~/.agent/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 |

```bash
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`

```bash
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)

```bash
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