# geoaeo

> Free, open-source CLI, MCP server, and library that audits any site 0-100 for SEO, GEO, and AEO and generates llms.txt, sitemaps, JSON-LD, WebMCP, and Markdown mirrors.

## Docs

- [Install](https://usegeoaeo.com/docs/install): `npm install geoaeo`, scaffold `geoaeo.config.ts`, verify bins `geoaeo` and `geoaeo-mcp`.
- [CLI reference](https://usegeoaeo.com/docs/cli): `audit <url|dir>`, `init`, `gen <artifact>`, `humanize`, `mcp` with flags and examples.
- [MCP server](https://usegeoaeo.com/docs/mcp): run `npx geoaeo mcp` over stdio, tools `audit`, `gen`, `humanize`.
- [Harnesses](https://usegeoaeo.com/docs): Claude Code, Cursor, Windsurf, Codex, Gemini CLI, GitHub Copilot, Continue.
- [GEO/AEO checklist](https://usegeoaeo.com/checklist): 34 weighted checks for answerability, structured data, crawlability, freshness, E-E-A-T.
- [Examples](https://usegeoaeo.com/examples): static-html, nextjs-app, astro-site with audit scores.
- [Docs index](https://usegeoaeo.com/docs)

## API

geoaeo is an npm library, not a hosted API. Use the package directly:

- [npm package](https://www.npmjs.com/package/geoaeo): `import { auditTarget, generateLlms, humanizeText } from 'geoaeo'`
- [GitHub](https://github.com/pooriaarab/usegeoaeo): source, issues, and `geoaeo.config.ts` examples
- [MCP via npx](https://www.npmjs.com/package/geoaeo): `npx geoaeo mcp` over stdio with `audit`, `gen`, `humanize`

## Pricing

- Free and open-source under the MIT license. `npm i geoaeo`. Hosted tools at https://usegeoaeo.com/tools are free. No paid tier.

## Tools

- [Site audit](https://usegeoaeo.com/tools): Score any URL 0-100 for SEO, GEO, and AEO.
- [llms.txt generator](https://usegeoaeo.com/tools): Generate an llms.txt for your site.
- [JSON-LD generator](https://usegeoaeo.com/tools): Generate schema.org structured data.

## More

- [Agents guide](https://usegeoaeo.com/agents.md): how AI agents should discover and use geoaeo
- [sitemap.xml](https://usegeoaeo.com/sitemap.xml)
- [robots.txt](https://usegeoaeo.com/robots.txt)
- [WebMCP](https://usegeoaeo.com/webmcp.json)
- [Poppy](https://usegeoaeo.com/.well-known/poppy.json)