# Canonry
> Canonry is the open-source, agent-native operating system for AEO
> (Answer Engine Optimization). It tracks how ChatGPT, Gemini, Claude, and
> Perplexity cite your site, sweeps Google Search Console / Bing / GA4,
> and hands a typed tool surface to your local coding agent (Claude Code,
> OpenAI Codex, or Cursor) over the CLI or MCP. A bundled agent named
> "Aero" ships ready for users who haven't configured their own.

## Highlights
- Agent-native by design. Built ground-up to be driven by agents.
- Bring your own coding agent (Claude Code / Codex / Cursor) over CLI or MCP
- Bundled "Aero" agent included. Same typed surface, zero setup, 15+ LLMs.
- Monitors Gemini, OpenAI, Anthropic Claude, Perplexity
- Sweeps Google Search Console, Bing Webmaster, Google Analytics 4
- 30+ CLI commands · 118 REST endpoints · 48 MCP tools · 6 webhook events
- Closed-loop: evidence, patch, tool calls, re-verification
- Local-first, SQLite, self-hosted, BYO provider keys
- Source on GitHub. npm package public. Licensing being finalized.

## FAQ
- What is AEO? Optimizing for how generative answer engines synthesize and
  cite sources, not traditional blue-link SEO.
- Does Canonry replace my coding agent? No. It provides a typed surface,
  evidence, tools, and a verification loop. Your agent does the code.
  Aero is bundled for users who don't bring their own.
- How do I connect my agent? Recommended path is the CLI; MCP is also
  supported for Claude Desktop, Cursor, and Codex.
- Which engines are monitored? Gemini (incl. AI Overviews), OpenAI ChatGPT,
  Anthropic Claude, Perplexity. Local LLMs via OpenAI-compatible endpoints.
- Is it self-hosted? Yes. SQLite, local-first. No cloud account required.
- Is the source public? Yes. Source on GitHub. License being finalized.

## Install
- brew install ainyc/canonry/canonry
- npm install -g @ainyc/canonry
- docker run --rm -p 4100:4100 -v canonry-data:/data arberx/canonry
- GitHub: https://github.com/AINYC/canonry

## Further reading
- / : landing page
- /llms-full.txt : extended manifest with definitions, surfaces, agent flow
- /sitemap.xml : indexed pages
- /robots.txt : crawl rules
- /.well-known/mcp.json : MCP server card for agents