MMCPMarkets
CC

canonry/canonry

Developer tools
117 stars 품질 40 트렌드 40
Repository Install

Your entire AEO/GEO/AI Visibility, technical SEO + web analytics stack.

개요

Your entire AEO/GEO/AI Visibility, technical SEO + web analytics stack.

README

Canonry

Your entire AEO/GEO/AI Visibility, technical SEO + web analytics stack. Agent-first. Self-hosted. Local.

Think PostHog, for AI search visibility. Canonry tracks what ChatGPT, Claude, Gemini, and Perplexity say about you, joins it with your search, server side traffic data and paid media, and gives your agent the tools + skills to fix what it finds.

npm install -g @canonry/canonry

Track your share of answer-engine brand mentions over time.

Measure → diagnose → approve action → measure change

Phase What Canonry does
Measure Track mentions and citations across Gemini, ChatGPT, Claude, Perplexity, and local models. Join them with GSC, GA4, Bing, server side traffic, Business Profile, and backlink data.
Diagnose Crawl the site, score Page Health, inspect evidence, compare competitors, and explain regressions.
Act Give your agent the context + skills to make surgical on-site technical SEO changes and coordinate content, indexing, analytics, and paid media.
Operate Create automation workflows, schedule checks, sync data, send webhooks, and generate client-ready reports.

Built-in integrations and workflows

The dashboard, CLI, and agent tools share the same project API.

Get a Page Health baseline

Map crawlable pages and the internal links connecting them.

  1. Install Canonry.

    npm install -g @canonry/canonry

  2. Create the local configuration, SQLite database, and full-instance API key.

    cnry bootstrap

    Keep the output private. Provider credentials are optional. Bootstrap imports supported variables that are already in your environment.

  3. Start Canonry.

    cnry serve

  4. Open http://127.0.0.1:4100/setup. If prompted, create a dashboard password.

  5. Enter your domain and approve the public-site crawl. This crawl creates a persisted Page Health baseline. AI Visibility is optional.

  6. To use the terminal instead, keep cnry serve running. Open a second terminal and run:

    cnry project create my-site --domain example.com --country US --language en
cnry technical-aeo run my-site --max-pages 100 --wait --format json

  7. Read the run ID and status from the output. If the status is completed or partial, read evidence from that run:

    cnry technical-aeo score my-site --run-id  --format json
cnry technical-aeo pages my-site --run-id  --sort score-asc --limit 10 --format jsonl

    --wait polls for up to 15 minutes. If the scan remains active, use the progress command below. If it fails or is cancelled, inspect it with cnry run show --format json.

Or use any shell-capable coding agent

If your client supports the Agent Plugin or MCP adapter, use that integration. Otherwise, paste this request into any shell-capable agent.

Add AI Visibility when you need it

Map citation and answer-mention coverage across every tracked query and engine.

Provider Key source Environment variable
Gemini Google AI Studio GEMINI_API_KEY
OpenAI OpenAI Platform OPENAI_API_KEY
Claude Anthropic Console ANTHROPIC_API_KEY
Perplexity Perplexity settings PERPLEXITY_API_KEY
Local model Any OpenAI-compatible endpoint LOCAL_BASE_URL

Then add the queries that matter and run a measured sweep:

cnry query add my-site "your first query" "your second query"
cnry run my-site --wait
cnry visibility-stats my-site --by-provider

Technical surface

Surface Use it for
CLI and REST API Script project measurements, diagnoses, actions, reports, and schedules. OpenAPI is available at GET /api/v1/openapi.json.
MCP and Agent Plugin Give Codex, Claude, Cursor, or a custom agent a typed, task-shaped tool surface.
Aero When enabled and configured, use the built-in analyst that reviews evidence and wakes after completed runs.
Dashboard Approve work, inspect evidence, and observe the same project record used by agents.

Deployment and trust boundary

Canonry is self-hosted and single-tenant. Run one instance for one operator or team, and isolate unrelated teams on separate instances.

See the deployment guide for reverse proxies, daemon mode, Docker, systemd, and Tailscale.

If you get stuck

Problem Fix
Site scan is still running Read exact counters with cnry technical-aeo progress --run-id --format json.
Site scan failed Read the error with cnry run show --format json. Read the last phase and counters with the progress command above.
No visibility results Inspect existing work with cnry runs --format json, then cnry run show --format json. This does not start another paid run.
Need more query candidates Run cnry discover run --icp "...". This does not change the basket. Preview a completed session with cnry discover promote preview . Promote only after approval.
Need one-off research Run cnry research run "query one" "query two" --wait. Research does not change the tracked basket.
npm install fails on node-gyp Install build tools for better-sqlite3 (guide).

Documentation
Architecture & data model docs/architecture.md · docs/data-model.md
Aero — built-in agent skills/aero/SKILL.md
Agent Plugin — portable core + Codex / Claude adapters docs/plugins.md
MCP — Claude Desktop / Cursor / Codex docs/mcp.md
Integrations GSC · GA4 · Google Ads + GTM · Bing · Google Business Profile · WordPress · Server-side traffic (Cloudflare direct push or Queue pull, Cloud Run, Vercel, WordPress)
Deployment — reverse proxies, Docker, systemd, Tailscale docs/deployment.md
API GET /api/v1/openapi.json
Standalone skills bundle for Claude Code / Codex cnry skills install (details)
All docs docs/README.md

Contributing

git clone https://github.com/Canonry/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.

View this README on GitHub

추천 도구

다른 키워드를 입력하거나 필터를 제거해 보세요.

설치

npx skillfish add canonry/canonry