Canonry

Agent-first AEO operating platform. Open source. Self-hosted.

• Track citations across Gemini, ChatGPT, Claude, Perplexity, and local LLMs
• Watch AI engines crawl and refer traffic via server-log ingestion — Cloud Run, Vercel, and the WordPress Traffic Logger plugin today
• Diagnose against real traffic with built-in GSC, GA4, and Bing Webmaster
• Execute fixes via WordPress, JSON-LD schema, and indexing submissions
• Manage many clients declaratively — config-as-code YAML + cnry apply
• Schedule recurring visibility checks AND traffic syncs, with webhook alerts on regressions
• Generate client-ready HTML reports — cnry report <project>
• Drive from your own agent via the 67-tool MCP adapter or webhooks
• Or use Aero — Canonry's built-in agent that wakes up after every run

Every dashboard view has a matching CLI command and API endpoint. The CLI is the surface; the UI consumes the same API your agent does.

Run your first AI visibility check in 5 minutes

npm install -g @ainyc/canonry
cnry init
cnry serve

The CLI installs as cnry (short form) and canonry — the two are interchangeable.

Open http://localhost:4100/setup. A guided wizard walks you through provider keys, project setup, queries, and your first visibility check.

Prefer the terminal?

cnry project create my-site --domain example.com
cnry query add my-site "your first query" "second query"
cnry run my-site --wait
cnry evidence my-site
cnry insights my-site

If you get stuck

| Problem | Fix | |---------|-----| | No provider key configured | Grab a free Gemini key, set GEMINI_API_KEY, restart cnry serve. | | No results after a run | Visibility checks are async — check the Runs tab or use cnry run <project> --wait. | | Not sure what queries to test | The setup wizard auto-generates them by analyzing your site. | | npm install fails on node-gyp | Install build tools for better-sqlite3 (guide). |

Provider keys

| Provider | Key source | Env var | |----------|-----------|---------| | Gemini | aistudio.google.com | GEMINI_API_KEY | | OpenAI | platform.openai.com | OPENAI_API_KEY | | Claude | console.anthropic.com | ANTHROPIC_API_KEY | | Perplexity | perplexity.ai/settings/api | PERPLEXITY_API_KEY | | Local LLMs | Any OpenAI-compatible endpoint | LOCAL_LLM_URL |

Configure during cnry init, in the dashboard /settings, or as env vars.

Documentation

| | | |---|---| | Architecture & data model | docs/architecture.md · docs/data-model.md | | Aero — built-in agent | skills/aero/SKILL.md | | MCP — Claude Desktop / Cursor / Codex | docs/mcp.md | | Integrations | GSC · GA4 · Bing · WordPress · Server-side traffic (Cloud Run + Vercel + WordPress logs) | | Deployment — Docker, Railway, Render, systemd, Tailscale | docs/deployment.md | | API — 118+ endpoints | GET /api/v1/openapi.json (no auth) | | Skills bundle for Claude Code / Codex | cnry skills install (details) | | Roadmap & ADRs | docs/roadmap.md · docs/adr/ | | All docs | docs/README.md |

Requirements

Node.js ≥ 22.14.0. At least one provider API key.

Contributing

git clone https://github.com/ainyc/canonry.git && cd canonry
pnpm install && pnpm run typecheck && pnpm run test && pnpm run lint

See CONTRIBUTING.md.

License

FSL-1.1-ALv2. Free to use, modify, and self-host. Each version converts to Apache 2.0 after two years.