CLI reference

geoaeo audit <target>

Audit a live URL or a local directory. Scores 0–100 across 20 weighted checks including answerability, structured data, llms.txt, crawlability, freshness, and E-E-A-T.

npx geoaeo audit https://example.com
npx geoaeo audit https://example.com --json
npx geoaeo audit ./apps/website

Flags

• --json — print JSON instead of the human-readable report
• --ci — exit non-zero when the score is below --min-score
• --min-score <n> — minimum passing score for --ci (default 90)

npx geoaeo audit https://example.com --ci --min-score 85

The command exits non-zero when the score is below the threshold. Use it to gate a build.

geoaeo init [directory]

Scaffold GEO and AEO artifacts into a site. Detects Next.js, Astro, SvelteKit, Nuxt, or Remix.

npx geoaeo init ./
npx geoaeo init ./apps/website --force

• Next.js and similar frameworks — writes routes that emit each artifact
• Static sites — writes static files directly
• Existing files stay unchanged unless you pass --force

geoaeo gen <artifact>

Generate one artifact from the local geoaeo.config.ts. Prints to stdout or writes to a file.

npx geoaeo gen llms
npx geoaeo gen llms-full --output public/llms-full.txt
npx geoaeo gen sitemap --output public/sitemap.xml
npx geoaeo gen robots
npx geoaeo gen webmcp
npx geoaeo gen jsonld --type faq
npx geoaeo gen ogimage --output public/og.svg
npx geoaeo gen rss --output public/feed.xml
npx geoaeo gen hreflang
npx geoaeo gen mdmirror

Flags

• -o, --output <file> — write to a file instead of stdout
• --type <kind> — JSON-LD kind: software, product, faq, breadcrumb, organization, website, article, howto, person, or review (default software)

Available artifacts: llms, llms-full, jsonld, webmcp, sitemap, robots, ogimage, rss, hreflang, mdmirror.

geoaeo humanize <glob>

Find AI-writing tells in Markdown and JSX files. Checks for em dashes, AI vocabulary, filler, hype, fake-depth tails, and title-case headings.

npx geoaeo humanize 'content/**/*.md' --check
npx geoaeo humanize 'src/**/*.tsx' --write

• --check — report only. Exits non-zero when tells are found
• --write — rewrite files in place. Keeps YAML frontmatter, code fences, JSX tags, imports, class names, and expressions

geoaeo mcp

Run the MCP server over stdio. The binary is also available as geoaeo-mcp.

npx geoaeo mcp
npx geoaeo-mcp

The server exposes three tools: audit, gen, and humanize. See the MCP page for wiring it into agents.

Examples

• Gate CI: npx geoaeo audit https://example.com --ci --min-score 85
• JSON for scripts: npx geoaeo audit ./ --json | jq .score
• Write JSON-LD: npx geoaeo gen jsonld --type software > public/jsonld.json