# mykpono/ultimate-seo-geo architecture

> Architecture diagram of the GitHub repository mykpono/ultimate-seo-geo, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-26). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mykpono/ultimate-seo-geo
- Repository: https://github.com/mykpono/ultimate-seo-geo

## Overview

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: [`scripts/generate_report.py`](https://github.com/mykpono/ultimate-seo-geo/blob/main/scripts/generate_report.py) (Audit Aggregator), [`scripts/google_auth.py`](https://github.com/mykpono/ultimate-seo-geo/blob/main/scripts/google_auth.py) (Google Authentication), [`scripts`](https://github.com/mykpono/ultimate-seo-geo/tree/main/scripts) (Prioritized Roadmap), [`scripts/gsc_query.py`](https://github.com/mykpono/ultimate-seo-geo/blob/main/scripts/gsc_query.py) (Search Console Queries)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_audit["Site Audit"]
  node_report["Audit Aggregator<br/>[generate_report.py]"]
  node_technical["Technical SEO Checks"]
  node_site_map["Site Discovery<br/>[site_mapper.py]"]
  node_schema["Schema Validation<br/>[validate_schema.py]"]
end

subgraph group_strategy["Content And GEO"]
  node_page_content["Content Quality<br/>[content_quality.py]"]
  node_topic["Topic Clustering<br/>[topic_cluster.py]"]
  node_citability["Citability Checks"]
  node_ai_crawlers["AI Crawler Access<br/>[ai_bot_access.py]"]
  node_llms["llms.txt Check"]
  node_other_seo["SEO Domain Checks"]
end

subgraph group_measurement["Search Measurement"]
  node_gsc_auth["Google Authentication<br/>[google_auth.py]"]
  node_gsc["Search Console Queries<br/>[gsc_query.py]"]
  node_ga4["Analytics Checks<br/>[ga4_audit.py]"]
  node_drift["Drift Monitoring<br/>[drift_monitor.py]"]
end

subgraph group_delivery["Plans And Reports"]
  node_findings["Scored Findings<br/>[generate_report.py]"]
  node_roadmap["Prioritized Roadmap"]
  node_fixes["Executable Fixes"]
  node_report_render["Report Renderer<br/>[render_report.py]"]
  node_exports["HTML Excel PDF<br/>[generate_report.py]"]
end

node_user(("Developer or Marketer"))
node_google["Google APIs"]
node_target_site(("Audited Website"))

node_user -->|"submits site"| node_report
node_report -->|"runs checks"| node_technical
node_report -->|"discovers pages"| node_site_map
node_report -->|"runs checks"| node_schema
node_report -->|"runs checks"| node_page_content
node_report -->|"runs checks"| node_topic
node_report -->|"runs checks"| node_citability
node_report -->|"runs checks"| node_ai_crawlers
node_report -->|"runs checks"| node_llms
node_report -->|"aggregates checks"| node_other_seo
node_target_site -->|"serves pages"| node_technical
node_target_site -->|"serves pages"| node_site_map
node_target_site -->|"serves file"| node_llms
node_user -->|"authorizes access"| node_gsc_auth
node_gsc_auth -->|"authenticates"| node_google
node_gsc -->|"queries data"| node_google
node_gsc_auth -->|"provides credentials"| node_gsc
node_ga4 -.->|"queries data"| node_google
node_user -->|"compares snapshots"| node_drift
node_report -->|"produces"| node_findings
node_findings -->|"prioritizes actions"| node_roadmap
node_roadmap -->|"guides execution"| node_fixes
node_findings -.->|"supplies summary"| node_report_render
node_report -->|"exports report"| node_exports
node_user -->|"requests planning"| node_roadmap
node_user -->|"requests execution"| node_fixes

click node_report "https://github.com/mykpono/ultimate-seo-geo/blob/main/scripts/generate_report.py"
click node_technical "https://github.com/mykpono/ultimate-seo-geo/tree/main/scripts"
click node_site_map "https://github.com/mykpono/ultimate-seo-geo/blob/main/scripts/site_mapper.py"
click node_schema "https://github.com/mykpono/ultimate-seo-geo/blob/main/scripts/validate_schema.py"
click node_page_content "https://github.com/mykpono/ultimate-seo-geo/blob/main/scripts/content_quality.py"
click node_topic "https://github.com/mykpono/ultimate-seo-geo/blob/main/scripts/topic_cluster.py"
click node_citability "https://github.com/mykpono/ultimate-seo-geo/blob/main/scripts/citability_checker.py"
click node_ai_crawlers "https://github.com/mykpono/ultimate-seo-geo/blob/main/scripts/ai_bot_access.py"
click node_llms "https://github.com/mykpono/ultimate-seo-geo/blob/main/scripts/llms_txt_checker.py"
click node_other_seo "https://github.com/mykpono/ultimate-seo-geo/tree/main/scripts"
click node_gsc_auth "https://github.com/mykpono/ultimate-seo-geo/blob/main/scripts/google_auth.py"
click node_gsc "https://github.com/mykpono/ultimate-seo-geo/blob/main/scripts/gsc_query.py"
click node_ga4 "https://github.com/mykpono/ultimate-seo-geo/blob/main/scripts/ga4_audit.py"
click node_drift "https://github.com/mykpono/ultimate-seo-geo/blob/main/scripts/drift_monitor.py"
click node_findings "https://github.com/mykpono/ultimate-seo-geo/blob/main/scripts/generate_report.py"
click node_roadmap "https://github.com/mykpono/ultimate-seo-geo/tree/main/scripts"
click node_fixes "https://github.com/mykpono/ultimate-seo-geo/tree/main/scripts"
click node_report_render "https://github.com/mykpono/ultimate-seo-geo/blob/main/scripts/render_report.py"
click node_exports "https://github.com/mykpono/ultimate-seo-geo/blob/main/scripts/generate_report.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_report,node_technical,node_site_map,node_schema toneBlue
class node_page_content,node_topic,node_citability,node_ai_crawlers,node_llms,node_other_seo toneAmber
class node_gsc_auth,node_gsc,node_ga4,node_drift,node_google toneMint
class node_findings,node_roadmap,node_fixes,node_report_render,node_exports toneRose
class node_user,node_target_site toneIndigo
```

## Components

### Site Audit

- [Audit Aggregator](https://github.com/mykpono/ultimate-seo-geo/blob/main/scripts/generate_report.py): `scripts/generate_report.py`
- [Technical SEO Checks](https://github.com/mykpono/ultimate-seo-geo/tree/main/scripts): `scripts`
- [Site Discovery](https://github.com/mykpono/ultimate-seo-geo/blob/main/scripts/site_mapper.py): `scripts/site_mapper.py`
- [Schema Validation](https://github.com/mykpono/ultimate-seo-geo/blob/main/scripts/validate_schema.py): `scripts/validate_schema.py`

### Content And GEO

- [Content Quality](https://github.com/mykpono/ultimate-seo-geo/blob/main/scripts/content_quality.py): `scripts/content_quality.py`
- [Topic Clustering](https://github.com/mykpono/ultimate-seo-geo/blob/main/scripts/topic_cluster.py): `scripts/topic_cluster.py`
- [Citability Checks](https://github.com/mykpono/ultimate-seo-geo/blob/main/scripts/citability_checker.py): `scripts/citability_checker.py`
- [AI Crawler Access](https://github.com/mykpono/ultimate-seo-geo/blob/main/scripts/ai_bot_access.py): `scripts/ai_bot_access.py`
- [llms.txt Check](https://github.com/mykpono/ultimate-seo-geo/blob/main/scripts/llms_txt_checker.py): `scripts/llms_txt_checker.py`
- [SEO Domain Checks](https://github.com/mykpono/ultimate-seo-geo/tree/main/scripts): `scripts`

### Search Measurement

- [Google Authentication](https://github.com/mykpono/ultimate-seo-geo/blob/main/scripts/google_auth.py): `scripts/google_auth.py`
- [Search Console Queries](https://github.com/mykpono/ultimate-seo-geo/blob/main/scripts/gsc_query.py): `scripts/gsc_query.py`
- [Analytics Checks](https://github.com/mykpono/ultimate-seo-geo/blob/main/scripts/ga4_audit.py): `scripts/ga4_audit.py`
- [Drift Monitoring](https://github.com/mykpono/ultimate-seo-geo/blob/main/scripts/drift_monitor.py): `scripts/drift_monitor.py`

### Plans And Reports

- [Scored Findings](https://github.com/mykpono/ultimate-seo-geo/blob/main/scripts/generate_report.py): `scripts/generate_report.py`
- [Prioritized Roadmap](https://github.com/mykpono/ultimate-seo-geo/tree/main/scripts): `scripts`
- [Executable Fixes](https://github.com/mykpono/ultimate-seo-geo/tree/main/scripts): `scripts`
- [Report Renderer](https://github.com/mykpono/ultimate-seo-geo/blob/main/scripts/render_report.py): `scripts/render_report.py`
- [HTML Excel PDF](https://github.com/mykpono/ultimate-seo-geo/blob/main/scripts/generate_report.py): `scripts/generate_report.py`

### Other components

- **Developer or Marketer**
- **Google APIs**
- **Audited Website**

## Connections

- 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