Creo Gsc

---
name: creo-gsc
description: >
  Google Search Console analysis and comprehensive SEO auditing.
  Site crawling, PageSpeed Insights, indexing API, on-page analysis,
  schema validation, hreflang, security headers, content quality, mobile SEO.
  Requires gsc-analyzer extension.
  Triggers on: /creo gsc, Google Search Console, GSC, site audit.
allowed-tools:
  - Read
  - Grep
  - Glob
  - Bash
  - WebFetch
---

# Creo GSC - Google Search Console & SEO Analysis

## Commands

| Command | Description |
|---------|-------------|
| `/creo gsc list-sites` | List all Search Console properties |
| `/creo gsc inspect <url>` | Inspect a URL's indexation status |
| `/creo gsc analytics` | Get search analytics (clicks, impressions, CTR) |
| `/creo gsc security <url>` | Analyze HTTP security headers |
| `/creo gsc onpage <url>` | On-page SEO analysis (title, meta, headings, images) |
| `/creo gsc schema <url>` | Validate structured data (JSON-LD) |
| `/creo gsc hreflang <url>` | Validate hreflang implementation |
| `/creo gsc full-seo <url>` | Run all 9 page analyzers on a URL |
| `/creo gsc site-audit <url>` | Crawl and audit entire website |

## Running gsc_toolkit CLI Commands

The toolkit is a Python package. All commands are executed via:

```bash
# Find the installed toolkit
GSC_DIR="${HOME}/.claude/skills/creo-gsc"

# Activate the virtual environment (if installed with venv)
source "${GSC_DIR}/.venv/bin/activate" 2>/dev/null || true

# Run commands
python -m gsc_toolkit <command> [options]
```

If the venv is not available, ensure gsc_toolkit's parent directory is on PYTHONPATH:

```bash
PYTHONPATH="${GSC_DIR}:${PYTHONPATH}" python -m gsc_toolkit <command>
```

## Full Command Reference

### GSC API Commands (require service account)

```bash
python -m gsc_toolkit list-sites
python -m gsc_toolkit inspect <url>
python -m gsc_toolkit analytics [--days 28] [--dimension query|page|device|country]
python -m gsc_toolkit sitemaps
python -m gsc_toolkit batch-inspect <urls_file>
python -m gsc_toolkit coverage [--path <directory>]
python -m gsc_toolkit links [--path <directory>]
python -m gsc_toolkit cwv <url> [--strategy mobile|desktop]
python -m gsc_toolkit cwv-batch <urls_file>
python -m gsc_toolkit index-request <url>
python -m gsc_toolkit index-batch <sitemap_url> [--limit 200]
python -m gsc_toolkit full-report [--days 28]
python -m gsc_toolkit seo-audit [--days 28] [--urls-file <file>]
```

### Page Analysis Commands (no API required)

```bash
python -m gsc_toolkit security <url>
python -m gsc_toolkit onpage <url>
python -m gsc_toolkit schema <url>
python -m gsc_toolkit hreflang <url> [--no-return-check]
python -m gsc_toolkit robots <base_url>
python -m gsc_toolkit sitemap-check <sitemap_url>
python -m gsc_toolkit full-seo <url>
```

### Content & Quality Analysis (no API required)

```bash
python -m gsc_toolkit content <url>
python -m gsc_toolkit mobile <url>
python -m gsc_toolkit performance <url>
python -m gsc_toolkit url-analysis <url>
```

### Site-wide Analysis (no API required)

```bash
python -m gsc_toolkit site-audit <url> [--max-pages 500] [--max-depth 10] [--delay 0.2] [--output file.json]
```

## Available Analyzers

1. **SecurityAnalyzer** - HSTS, CSP, X-Frame-Options, X-Content-Type-Options, Referrer-Policy, Permissions-Policy
2. **OnPageAnalyzer** - Title, meta description, canonical, headings, content length, images, Open Graph, Twitter Cards
3. **SchemaAnalyzer** - JSON-LD validation, required/recommended fields, schema.org compliance
4. **HreflangAnalyzer** - Tag syntax, self-referential links, return link validation, x-default, language codes
5. **RobotsAnalyzer** - robots.txt syntax, directives, sitemap declarations, Googlebot blocking detection
6. **ContentAnalyzer** - Readability (Flesch-Kincaid, Gunning Fog), freshness, language detection, keyword analysis
7. **MobileAnalyzer** - Viewport, touch targets, font sizes, responsive design, PWA features
8. **PerformanceAnalyzer** - Render-blocking CSS/JS, image optimization, caching headers, compression
9. **LinksAnalyzer** - Anchor text quality, URL structure, pagination, nofollow detection
10. **SiteCrawler** + **SiteAuditor** - Full site crawl with duplicate detection, thin content, orphan pages, broken links
11. **PageSpeedAnalyzer** - Core Web Vitals via PageSpeed Insights API
12. **IndexingAPI** - Request indexing via Google Indexing API
13. **CoverageAnalyzer** - Parse GSC Coverage CSV exports
14. **GSCAnalyzer** - Main Search Console API client (analytics, inspection, sitemaps)

## Configuration

For GSC API access, set environment variables or create `.env` in the working directory:

```
GSC_KEY_FILE=./service-account-key.json
GSC_SITE_URL=sc-domain:your-domain.com
GSC_DEFAULT_DAYS=28
PAGESPEED_API_KEY=your_api_key
GSC_OUTPUT_DIR=./output
```

Page analysis commands (security, onpage, schema, hreflang, robots, content, mobile, performance, url-analysis, full-seo, site-audit) do not require any API credentials.