Ultimate SEO Geo

Abstract

1. Introduction

The definitive SEO and Generative Engine Optimization agent for AI coding tools. LLM-agnostic — works on any platform that reads AGENTS.md. Runs full site audits with scored findings, generates ready-to-deploy fixes, and optimizes content for both Google Search and AI search engines (Google AI Overviews, AI Mode, ChatGPT Search, Perplexity). Exports HTML, Excel, and PDF reports.

Works with any AGENTS.md-compatible tool: Claude Code, Cursor, OpenAI Codex, Gemini CLI, GitHub Copilot, Windsurf, Cline, Aider, Devin, and more.

Give it a URL and it returns a scored audit, prioritized action plan, and executable fixes — not vague advice.

2. Objective

The definitive SEO + GEO skill for Claude. Full site audits with scored findings, AI search optimization (Google AI Overviews, ChatGPT, Perplexity), schema generation, E-E-A-T assessment, and 20 diagnostic scripts. Three modes: Audit → Plan → Execute.

This project demonstrates how Python can be applied to a real-world Digital Marketing & SEO problem.

3. Key Features / Modules

• Technical SEO — Core Web Vitals (LCP/INP/CLS), crawlability, indexability, JavaScript rendering, security headers, mobile-first
• On-Page SEO — Title tags, meta descriptions, H1s, URLs, canonicals
• Content & E-E-A-T — Content quality scoring, author credentials, experience signals, readability, thin content detection, content pruning/refresh
• Schema Markup — All active Schema.org types, deprecation-aware (HowTo, SpecialAnnouncement removed), JSON-LD generation and validation
• Keywords & Content Strategy — Keyword research, topic clusters, content gaps, funnel mapping (TOFU/MOFU/BOFU), content brief generation
• Link Building — Internal link audit, orphan page detection, anchor text analysis, external link quality hierarchy
• Local SEO — Google Business Profile, NAP consistency, review strategy, LocalBusiness schema, citation building
• Maps Intelligence — Geo-grid rank tracking, GBP completeness audit, review intelligence, competitor radius mapping, NAP consistency checking
• International SEO — Hreflang audit, language code validation, bidirectional return tags
• Programmatic SEO — Quality gates for pages at scale, thin content safeguards, template optimization

4. Technology Stack

5. System Requirements

General requirements for this technology stack — check the README for exact versions.

• Python 3.8 or later
• pip / virtualenv for dependencies
• VS Code, PyCharm or Jupyter Notebook
• Git (to clone the repository)

6. Installation & Setup

git clone https://github.com/mykpono/ultimate-seo-geo.git
cd ultimate-seo-geo

cp -r ultimate-seo-geo ~/.claude/skills/

Full setup instructions are in the project README.

7. Future Enhancements

Suggested extensions you can add to make this your own project.

• Export reports to Google Sheets or PDF
• Schedule weekly automated reports
• Add competitor comparison

8. Viva / Review Questions

Common questions examiners ask for projects in this domain.

1. Which marketing or SEO problem does this tool solve?
2. Which data sources or APIs does it use (Search Console, Analytics, social platforms)?
3. Which metrics or KPIs does it report and how are they calculated?
4. How could the output help a business make decisions?
5. How would you schedule it to run automatically?

9. Source Code & License

This project is developed by mykpono and published on GitHub under the MIT License. Please follow the license terms and credit the original author when you use or modify this code.