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:

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

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

Full Command Reference

GSC API Commands (require service account)

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)

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)

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)

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.