Metadata-Version: 2.4
Name: aeo-geo-seo
Version: 1.0.0
Summary: CLI tool to install the AEO/GEO/SEO skill into any AI coding assistant
License-Expression: MIT
Project-URL: Homepage, https://github.com/aslamSk301/aeo-geo-seo-skill
Project-URL: Repository, https://github.com/aslamSk301/aeo-geo-seo-skill
Project-URL: Issues, https://github.com/aslamSk301/aeo-geo-seo-skill/issues
Keywords: seo,aeo,geo,schema,llms-txt,ai-search,structured-data,nextjs
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Classifier: Topic :: Internet :: WWW/HTTP :: Indexing/Search
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# aeo-geo-seo

A CLI tool that installs the **AEO / GEO / SEO skill** into any AI coding assistant — one command, any IDE.

```bash
pip install aeo-geo-seo
aeo-geo-seo kiro install
```

Your AI will now know how to rank sites on Google, ChatGPT, Perplexity, and Gemini.

---

## What It Does

Installs a battle-tested skill covering:

| Module | What It Teaches Your AI |
|--------|------------------------|
| **Schema Validation** | Organization, Product, FAQPage, LocalBusiness, BreadcrumbList JSON-LD |
| **llms.txt** | AI crawler context file — template + quality checklist |
| **robots.txt AI Bot Check** | 14 AI bot tokens, block/allow rules, private route patterns |
| **AI Search Testing** | Text density, canonical tags, OG metadata, question headings |
| **GEO Content Matching** | Brand, city, currency, language signals for geo-targeting |
| **AI Mention Monitoring** | sameAs, AggregateRating, E-E-A-T trust signals |
| **Crawl & Index Validation** | Sitemap, lastmod, 200-status checks, noindex guard |
| **Regional Visibility** | NAP consistency, GeoCoordinates, areaServed, HTML lang |

---

## Install

```bash
pip install aeo-geo-seo
```

---

## Usage

Run from your **project root**:

```bash
aeo-geo-seo <platform> install
aeo-geo-seo <platform> uninstall
```

### Platform Table

| Platform | Command | Installs To |
|----------|---------|-------------|
| **Kiro IDE/CLI** | `aeo-geo-seo kiro install` | `.kiro/skills/aeo-geo-seo/` + steering |
| **Claude Code** | `aeo-geo-seo claude install` | `~/.claude/skills/aeo-geo-seo/` |
| **Agent Skills** | `aeo-geo-seo agents install` | `.agents/skills/aeo-geo-seo/` + AGENTS.md |
| **OpenAI Codex** | `aeo-geo-seo codex install` | `.agents/skills/aeo-geo-seo/` + AGENTS.md |
| **VS Code Copilot** | `aeo-geo-seo vscode install` | `.github/skills/aeo-geo-seo/` + copilot-instructions.md |
| **Cursor** | `aeo-geo-seo cursor install` | `.cursor/skills/aeo-geo-seo/` |
| **GitHub Copilot CLI** | `aeo-geo-seo copilot install` | `~/.copilot/skills/aeo-geo-seo/` |
| **Google Antigravity** | `aeo-geo-seo antigravity install` | `.agents/skills/aeo-geo-seo/` + AGENTS.md |
| **Aider** | `aeo-geo-seo aider install` | `.aider/skills/aeo-geo-seo/` + AGENTS.md |
| **Trae / Trae CN** | `aeo-geo-seo trae install` | `.trae/skills/aeo-geo-seo/` + AGENTS.md |
| **OpenClaw** | `aeo-geo-seo claw install` | `.openclaw/skills/aeo-geo-seo/` |
| **Hermes** | `aeo-geo-seo hermes install` | `~/.hermes/skills/aeo-geo-seo/` |
| **Devin CLI** | `aeo-geo-seo devin install` | `~/.config/devin/skills/aeo-geo-seo/` |
| **Pi coding agent** | `aeo-geo-seo pi install` | `~/.pi/agent/skills/aeo-geo-seo/` |

---

## What Gets Installed

```
.kiro/skills/aeo-geo-seo/
├── SKILL.md                    ← main workflow (8 modules, 6 checklists)
└── references/
    ├── schema-playbook.md      ← 10 JSON-LD schemas, copy-paste ready
    ├── robots-llms.md          ← robots.txt templates + llms.txt template
    ├── indexing-fixes.md       ← GSC issue diagnosis step-by-step
    └── frameworks.md           ← Next.js, Nuxt, SvelteKit, HTML, WordPress
```

---

## Quick Wins Your AI Will Apply First

1. Create `/llms.txt` — AI crawlers read this before indexing your site
2. Add `postalCode` + `streetAddress` to PostalAddress schema — fixes Rich Results warnings
3. Block private routes in robots.txt — `/cart`, `/login`, `/orders`, `/wishlist`
4. Remove UUID/ID URLs from sitemap — only slug-based canonical URLs
5. Add FAQPage schema to homepage — highest-impact schema for AI citations

---

## Example Session

```
You: audit my site's AEO and GEO
AI:  [reads SKILL.md → runs 8-module audit → returns scored report with fixes]

You: create llms.txt for my baby products store
AI:  [reads robots-llms.md → generates 280-word llms.txt with brand context]

You: fix my GSC "page with redirect" issue
AI:  [reads indexing-fixes.md → explains UUID→slug sitemap fix with code]

You: add Product schema to my Next.js product page
AI:  [reads schema-playbook.md → writes correct JSON-LD with Offer + BreadcrumbList]
```

---

## Uninstall

```bash
aeo-geo-seo kiro uninstall
```

Removes the skill folder and steering file cleanly.

---

## Skill Contents

The skill covers **3 layers of modern search**:

```
SEO  →  Google/Bing crawl + index + rank
AEO  →  AI engines extract your Q&A as direct answers
GEO  →  AI knows who you are, where you operate, what you sell
```

**Frameworks covered:** Next.js App Router · Next.js Pages Router · Nuxt 3 · SvelteKit · Plain HTML · WordPress

**Site types:** E-commerce · SaaS · Local Business · Blog · Portfolio

---

## License

MIT — use freely, modify for your project.

---

## Links

- GitHub: [aslamSk301/aeo-geo-seo-skill](https://github.com/aslamSk301/aeo-geo-seo-skill)
- Issues: [github.com/aslamSk301/aeo-geo-seo-skill/issues](https://github.com/aslamSk301/aeo-geo-seo-skill/issues)
