SEO/GEO/AEO Optimizer
Audit content for search engine and AI platform visibility. Generates schema markup, validates metadata, extracts keywords, and produces actionable reports.
When NOT to Use
- Creating new content from scratch (use content generation tools)
- Image optimization (use image-specific tools)
- Server-side performance (use web performance tools)
Decision Matrix
Pick the right script based on user intent:
| User Wants | Script | Input |
|---|---|---|
| Full audit with report | scripts/audit_report.py <file> --format all |
HTML/MD/JSX |
| Content structure analysis | scripts/analyze_content.py <file> |
HTML/MD/JSX |
| Meta tag validation | scripts/metadata_validator.py <file> |
HTML |
| Keyword extraction | scripts/keyword_analyzer.py <file> |
Any text |
| Entity extraction | scripts/entity_extractor.py <file> |
Any text |
| Schema markup generation | scripts/schema_generator.py <type> [args] |
CLI args |
| AI platform optimization | scripts/auto_implementer.py <file> <platform> |
HTML + platform |
| Content optimization | scripts/content_optimizer.py <file> |
HTML/MD |
| Citation enhancement | scripts/citation_enhancer.py <file> |
HTML/MD |
| Voice search optimization | scripts/voice_optimizer.py <file> |
HTML/MD |
| Freshness monitoring | scripts/freshness_monitor.py <file> |
HTML |
| IndexNow submission | scripts/indexnow_submit.py <url> |
URL |
Platforms for auto_implementer: chatgpt, perplexity, claude, gemini, grokipedia
Schema types: faq, article, howto, organization, person
Preflight
Before running any script, verify:
- File exists and is a supported type (.html, .md, .mdx, .jsx, .tsx)
- Python 3.7+ available (scripts use stdlib only, no external deps)
Error Handling
- FileNotFoundError: Check the path. Scripts accept absolute or relative paths.
- JSON decode errors: The input file may have malformed schema markup. Run
metadata_validator.pyfirst to identify issues. - Low scores (< 50): Not an error. Run
audit_report.py --format allfor detailed recommendations, then apply fixes withauto_implementer.py. - Script import errors: All scripts share
scripts/shared/utilities. Ensure the full scripts directory is intact.
Output
Reports saved to ~/Documents/SEO_Audit_YYYY-MM-DD_HH-MM-SS/ in three formats:
- JSON: Raw audit data for programmatic use
- Markdown: Readable report with recommendations
- HTML: Visual dashboard with scores and charts
References
| File | When to Read |
|---|---|
reference/scripts-reference.md |
Detailed script flags and options |
reference/troubleshooting.md |
Common issues and solutions |
reference/platform-strategies.md |
Platform-specific optimization strategies |
reference/citation-optimization-guide.md |
AI citation and GEO strategies |
reference/schema-library.md |
Complete JSON-LD schema reference |
reference/entity-seo-guide.md |
Knowledge Graph optimization |
reference/voice-search-guide.md |
Voice search and AEO optimization |
reference/social-preview-guide.md |
Open Graph and Twitter Card setup |
reference/statistics-2026.md |
May 2026 review — what shifted, what survived, what to drop |