How mykpono/ultimate-seo-geo works
Ultimate SEO + GEO is an LLM-agnostic SEO agent: a user supplies a site or existing findings, receives scored diagnostics and a prioritized plan, and can proceed to executable fixes and verification. The documented report script aggregates site checks into HTML, Excel, or PDF; separate tools cover Search Console data, GEO, drift, local, international, e-commerce, and other audit domains. The tree and excerpts support the report entry point and selected checker behavior, but do not establish wiring among individual unsampled checkers, so those are grouped without invented call edges.
Main entry points: generate_report.py Audit Aggregator · google_auth.py Google Authentication · scripts Prioritized Roadmap · gsc_query.py Search Console Queries
Components 22
Site Audit
- Audit Aggregator
scripts/generate_report.py - Technical SEO Checks
scripts - Site Discovery
scripts/site_mapper.py - Schema Validation
scripts/validate_schema.py
Content And GEO
- Content Quality
scripts/content_quality.py - Topic Clustering
scripts/topic_cluster.py - Citability Checks
scripts/citability_checker.py - AI Crawler Access
scripts/ai_bot_access.py - llms.txt Check
scripts/llms_txt_checker.py - SEO Domain Checks
scripts
Search Measurement
- Google Authentication
scripts/google_auth.py - Search Console Queries
scripts/gsc_query.py - Analytics Checks
scripts/ga4_audit.py - Drift Monitoring
scripts/drift_monitor.py
Plans And Reports
- Scored Findings
scripts/generate_report.py - Prioritized Roadmap
scripts - Executable Fixes
scripts - Report Renderer
scripts/render_report.py - HTML Excel PDF
scripts/generate_report.py
Other components
- Developer or Marketer
- Google APIs
- Audited Website
Connections 26
- Developer or Marketer → Audit Aggregator: submits site
- Audit Aggregator → Technical SEO Checks: runs checks
- Audit Aggregator → Site Discovery: discovers pages
- Audit Aggregator → Schema Validation: runs checks
- Audit Aggregator → Content Quality: runs checks
- Audit Aggregator → Topic Clustering: runs checks
- Audit Aggregator → Citability Checks: runs checks
- Audit Aggregator → AI Crawler Access: runs checks
- Audit Aggregator → llms.txt Check: runs checks
- Audit Aggregator → SEO Domain Checks: aggregates checks
- Audited Website → Technical SEO Checks: serves pages
- Audited Website → Site Discovery: serves pages
- Audited Website → llms.txt Check: serves file
- Developer or Marketer → Google Authentication: authorizes access
- Google Authentication → Google APIs: authenticates
- Search Console Queries → Google APIs: queries data
- Google Authentication → Search Console Queries: provides credentials
- Analytics Checks → Google APIs: queries data
- Developer or Marketer → Drift Monitoring: compares snapshots
- Audit Aggregator → Scored Findings: produces
- Scored Findings → Prioritized Roadmap: prioritizes actions
- Prioritized Roadmap → Executable Fixes: guides execution
- Scored Findings → Report Renderer: supplies summary
- Audit Aggregator → HTML Excel PDF: exports report
- Developer or Marketer → Prioritized Roadmap: requests planning
- Developer or Marketer → Executable Fixes: requests execution