usegeoaeo
Scores a site 0-100 and generates GEO/AEO files for owners who want AI citations.
Install / Use
claude mcp add itsryanarmani -- npx -y github:itsryanarmani/usegeoaeoIf the server publishes to npm under a different name, use that package instead — check the repo README.
MCP Server
Model Context Protocol server
Quality Score
Category
AI & Machine LearningSupported Platforms
Our assessment of usegeoaeo
usegeoaeo scores 83/100 on our quality scale, 672nd of 950 AI & Machine Learning skills we index.
Its MCP Server is 9.2 KB long, well organised into 24 sections with 5 code examples: a thorough specification that gives an agent plenty to work with.
It has 47 GitHub stars, so there is little community track record yet; judge it on its content.
Maintenance, license and trust
- The repository was last updated 18 days ago, so usegeoaeo is actively maintained.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 92/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands.
Automated pattern scan on 2026-11-21. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
usegeoaeo compared with similar skills
All 4 of these similar skills score higher than usegeoaeo; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| usegeoaeo (this skill)by itsryanarmani | 83 | 47 | 18d ago | MCP Server |
| claude-memby thedotmack | 100 | 119.0k | today | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 114.0k | today | CLAUDE.md |
| Understand-Anythingby Egonex-AI | 100 | 93.7k | today | CLAUDE.md |
| hyperframesby heygen-com | 100 | 88.2k | today | CLAUDE.md |
Frequently asked questions
- How do I install usegeoaeo?
- Run
claude mcp add itsryanarmani -- npx -y github:itsryanarmani/usegeoaeo. The install tabs above show the steps for each supported agent. - Which AI agents does usegeoaeo work with?
- It is written for Claude Code and Claude Desktop, as a MCP Server file. Other agents that read the same format can often use it too.
- Is usegeoaeo safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. It is MIT-licensed and scores 92/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is usegeoaeo still maintained?
- The repository was last updated 18 days ago, so usegeoaeo is actively maintained.
Skill content
View source on GitHubgeoaeo
<a href="https://www.npmjs.com/package/geoaeo"><img src="https://img.shields.io/npm/v/geoaeo" alt="npm geoaeo 0.8.5"/></a>
Docs · Setup · CLI reference · MCP reference · Compare · llms.txt
geoaeo is an open-source site audit and artifact generator for developers. It checks search engine optimization (SEO), generative-engine optimization (GEO), and answer-engine optimization (AEO) signals. It returns a score and generates discovery files from your site configuration.
Install
npm install geoaeo
Requires Node.js 20 or newer. The package includes TypeScript types, ES module and CommonJS exports, and five direct dependencies.
Send your first audit
npx geoaeo audit https://example.com
No environment variables or API keys are required. Success prints the target, a score out of 100, PASS/FAIL checks, and top fixes. Scores depend on the fetched content; a completed audit does not require a passing score.
For a deterministic local generator example, save this as example.mjs:
import { defineConfig, generateLlms } from 'geoaeo';
const config = defineConfig({
siteName: 'Reply Kit',
siteUrl: 'https://example.com',
description: 'A tool that drafts replies.',
tools: [],
});
process.stdout.write(generateLlms(config));
Run node example.mjs. Success prints Markdown headed # Reply Kit.
How it works
URL or directory -> snapshot -> 34 weighted checks -> score and top fixes
SiteConfig -> generator -> discovery text, XML, JSON, HTML, or SVG
CLI / agent -> audit, generation, prose checks -> shared library behavior
Generators use your configuration; they do not discover your business facts. The repository includes the npm package, the public website, and Workers for website tools.
Why it exists
Developers need repeatable checks and generated discovery artifacts in their build workflows. Yoast SEO provides WordPress editing and metadata workflows. Lighthouse audits web page quality. geoaeo exposes configuration-driven artifact generation and discovery checks through code, a CLI, and Model Context Protocol (MCP).
Compare
Scope checked on 2026-10-14 against Yoast SEO and Lighthouse.
| Scope | geoaeo | Yoast SEO | Lighthouse | |---|---|---|---| | Main workflow | Discovery audits and artifact generation | WordPress SEO editing | Web page quality audits | | Configuration | SiteConfig and command flags | WordPress plugin settings | Audit configuration | | Execution | Node.js library, CLI, stdio MCP | WordPress | Chrome tooling or CLI |
Coverage
| Artifact choice | Status | Output |
|---|---|---|
| llms | ✓ generator | Short llms.txt |
| llms-full | ✓ generator | Detailed llms-full.txt |
| ai-txt | ✓ generator | AI usage policy (ai.txt) |
| jsonld | ✓ generator | JSON-LD structured data |
| webmcp | manifest only | WebMCP-style discovery JSON |
| poppy | discovery only | Personal Agent Protocol organization and empty web capability |
| sitemap | ✓ generator | XML sitemap |
| robots | ✓ generator | robots.txt |
| ogimage | ✓ generator | SVG image |
| rss | ✓ generator | RSS feed |
| hreflang | ✓ generator | Alternate-language link tags |
| mdmirror | ✓ generator | Markdown content |
The dispatcher has 12 artifact choices. JSON-LD supports 10 kinds: software, product, faq, breadcrumb, organization, website, article, howto, person, review. Framework detection includes Next.js, Astro, SvelteKit, Nuxt, and Remix; other directories receive static files. These are implemented generators and templates, not credential-verified integrations with answer engines. Local tests verify behavior. No ChatGPT, Claude, Perplexity, or Google AI citation outcome is verified by an audit score.
Common use cases
- Next.js developers: scaffold discovery routes and review generated site facts.
- Astro publishers: generate sitemap, robots, and language artifacts from shared configuration.
- SvelteKit teams: inspect deployed HTML and track audit thresholds in CI.
- Agent developers: connect Claude Code or Cursor through the stdio MCP server.
- Static-site maintainers: generate llms.txt and JSON-LD without a framework plugin.
Features
- Audits: 34 weighted checks return a normalized 0–100 score and up to five top fixes. See the checklist.
- Generators: emit artifacts from a shared site configuration. See installation.
- Prose checks: find configured writing patterns and optionally rewrite matching files. See the CLI reference.
- Agent tools: audit, generate, and check prose over stdio. See the MCP reference.
Runtime surfaces
| CLI command | Behavior |
|---|---|
| geoaeo audit <target> | Audit a URL or local directory; --json returns JSON |
| geoaeo init [directory] | Write starter configuration and framework routes or static artifacts |
| geoaeo gen <artifact> | Read configuration and print an artifact; --output writes a file |
| geoaeo humanize <glob> | Report prose findings; --write changes files |
| geoaeo mcp | Start the stdio MCP server |
The two bins are geoaeo and geoaeo-mcp.
The three MCP tools are audit, gen, and humanize. MCP gen returns text without writing a file.
Library exports include auditTarget, formatAuditReport, defineConfig, humanizeText, and the artifact generators.
init is a CLI scaffolding command, not an MCP tool.
Delivery and behavior limits
- Scores measure implemented heuristics. They do not measure rankings, traffic, or citations.
- A local source audit can miss rendered framework output. Audit a deployed URL to inspect served HTML.
initwrites placeholder facts. Replace them before publishing; existing files are skipped unless--forceis set.genreadsgeoaeo.config.ts,.js, or.mjsfrom the target directory. Configuration executes as code.- WebMCP output does not register executable browser tools. Poppy output does not implement authentication or a company agent.
audit --ci --min-score Nfails below the chosen score. The default threshold is 90.GEOAEO_ALLOWED_ROOTSoptionally limits local paths for supported CLI and MCP operations. HTTP audit targets remain allowed.- Prose rewrites use fixed rules; review every change before publishing.
Integration guides
- Install geoaeo and scaffold framework artifacts.
- Run audits and generate discovery files from the CLI.
- Configure an agent with the stdio MCP server.
For an MCP client, use this server configuration:
{"mcpServers":{"geoaeo":{"command":"npx","args":["-y","geoaeo","mcp"]}}}
Status
The package is version 0.8.5. Interfaces can change before 1.0. The library is MIT licensed. Public case studies are not yet published. Use the repository issue tracker for support if you have access, or consult the public docs.
Contributing
packages/geoaeo contains the package; apps/website contains the documentation site.
Install workspace dependencies with bun install. Run bun run ci:local for lint, types, tests, and plugin-skill checks.
Keep library behavior, CLI commands, and MCP tools aligned when changing shared capabilities.
FAQ
Which integrations are verified?
geoaeo includes five framework detectors and a static fallback. Tests cover templates and generators; the audit does not credential-check answer engines.
Does geoaeo provide a managed SEO service?
geoaeo provides a local package and public browser tools. You deploy generated artifacts to your own site.
How is geoaeo different from Yoast SEO?
geoaeo uses code and commands to audit discovery signals and generate files. Yoast SEO provides WordPress SEO editing and metadata workflows.
How is geoaeo different from Lighthouse?
geoaeo focuses on discovery checks and configuration-driven artifacts. Lighthouse audits web page quality, including performance and accessibility.
Does geoaeo guarantee citations from ChatGPT or Claude?
geoaeo cannot guarantee citations. Its score reports the checks implemented in the package.
Can geoaeo audit a local directory?
geoaeo accepts directories and HTTP URLs. Source files can differ from rendered pages, so inspect deployed output as well.
Does geoaeo require an API key?
geoaeo requires no API key for its library, CLI, or stdio MCP server. URL audits need network access.
Does geoaeo overwrite my files?
geoaeo skips existing scaffolding files unless init --force is set. Generation writes only when an output path is supplied; prose rewriting requires an explicit write option.
License
MIT.
Related Skills
claude-mem
119.0kPersistent Context Across Sessions for Every Agent – Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More
Agent-Reach
114.0kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
Understand-Anything
93.7kGraphs that teach > graphs that impress. Turn any code into an interactive knowledge graph you can explore, search, and ask questions about. Works with Claude Code, Codex, Cursor, Copilot, Gemini CLI, and more.
hyperframes
88.2kAI video you can actually edit. HyperFrames is a free, open-source AI video editor. Describe any video and get a real project you can change down to the frame.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
