源码系统概览
文章正文
Canonry 是一款 Agent 优先的 AI SEO 运营平台源码，中文版项目名为知引，覆盖 AEO 与 GEO 可见度审计、内容运营与流量监测，前端为 React 19 加 Vite，后端为 Node 22 加 Fastify 的 monorepo 结构，仓库在 GitHub 开源并保持活跃更新。
项目由作者 Arber X 主导维护，GitHub 组织 Canonry 开源，最后更新 2026 年 9 月 12 日，当前版本 4.186.1，许可证为 FSL-1.1-ALv2 功能性源码许可，不同于 MIT 或 Apache 标准协议，两年后自动转为 Apache 2.0，期间企业生产使用需购买商业授权。数据库使用 better-sqlite3 与 Drizzle ORM，包管理采用 pnpm workspace。
源码简介
Agent 能力通过独立 provider 包接入 OpenAI、Claude、Gemini、Perplexity 与本地模型，模型层可替换，业务层不与单一厂商绑定。
审计引擎以 aeo-audit 包为核心，内置 MCP 协议支持，可对站点做 AEO 与 GEO 双维度可见度评估并输出结构化报告。
数据集成覆盖 Bing、Google Analytics、Google Business Profile、Common Crawl 与 WordPress 等外部数据源，Common Crawl 集成基于 DuckDB 做大规模页面分析。
前端采用 Radix UI 与 TanStack Router 加 React Query，图可视化基于 sigma 与 graphology 渲染引用关系，仓库以 pnpm workspace 组织并附带 vitest 测试体系。
和传统 SEO 工具对比 Ahrefs，Canonry 的差异点在面向 AI 搜索的 AEO 审计与 Agent 自动化。
| 对比维度 | Canonry | Ahrefs |
|---|---|---|
| 优化对象 | AI 搜索可见度 AEO 加 GEO | 传统搜索排名 SEO |
| 驱动方式 | Agent 自动审计与运营 | 人工查询分析 |
| 部署形态 | 源码自托管 | SaaS 订阅 |
| 中文支持 | 中文版知引原生支持 | 界面以英文为主 |
整体来看，想把 SEO 运营从人工查询升级为 Agent 自动审计并覆盖 AI 搜索场景的团队，Canonry 是当前少有的完整开源实现。
欢迎感兴趣的开发者到 GitHub 仓库 star 和 fork 参与贡献。
适用场景
- SEO 团队对站点做 AEO 与 GEO 双维度可见度审计。
- 内容运营用 Agent 自动生成优化建议并跟踪改进效果。
- 企业自托管 SEO 数据平台，接入自有 Analytics 数据源。
- TypeScript 开发者学习 pnpm monorepo 与 Agent 架构实践。
技术栈与运行环境
后端 Node 22 加 Fastify 5，数据层 better-sqlite3 配 Drizzle ORM，模型接入包含 Anthropic、Google Genai、OpenAI 等 SDK，任务调度有 node-cron 与 cron-parser。
前端 React 19 配 Vite、TanStack Router、React Query 与 Redux Toolkit，仓库根目录提供 Dockerfile 支持，容器化部署默认暴露 9080 端口。
功能亮点
- Agent 优先架构，OpenAI、Claude、Gemini、Perplexity 与本地模型可切换。
- AEO 与 GEO 双维度站点可见度审计并输出报告。
- MCP 协议支持，可与外部工具链互联。
- Bing、Google Analytics、Common Crawl、WordPress 等数据源集成。
- 引用关系图可视化与内容运营工作流。
- pnpm monorepo 工程化完整，含 vitest 测试与 eslint 规则集。
技术架构与部署指南
安装与部署提示
克隆仓库后安装 pnpm 依赖，按 backend 与 frontend 分别启动 API 服务与前端构建，api 与 worker 两个应用各司其职。
容器化部署使用仓库提供的 Dockerfile 与脚本目录，默认端口 9080，浏览器打开即可进入管理界面。
首次使用需在配置中填入所选模型 provider 的 API Key，审计任务由 worker 进程按计划执行。
截图与演示说明
上图来自项目 README 的总览页截图，界面以数据面板与任务流为主，中文版知引保持同一套界面语言。
仓库 docs 目录的 user 文档附带报告页与设置页截图，报告页展示审计得分与问题清单，设置页管理数据源与模型配置。
审计结果以结构化报告呈现，引用关系图基于 graphology 渲染，节点连线反映页面间的引用拓扑。
常见问题
问. Canonry 是什么项目？
Canonry 是 Agent 优先的 AI SEO 运营平台源码，中文版名为知引，覆盖 AEO 与 GEO 可见度审计、内容运营与流量监测，以 pnpm monorepo 组织前后端代码。
问. Canonry 怎么部署？
用 pnpm 安装依赖后分别启动后端 api 与 worker 应用及前端，或直接用仓库 Dockerfile 容器化部署，默认 9080 端口，模型 Key 在配置中填写。
问. 和 Ahrefs 对比有什么区别？
与 Ahrefs 对比，Canonry 面向 AI 搜索时代的 AEO 与 GEO 优化并以 Agent 自动化执行，Ahrefs 聚焦传统搜索排名数据且为 SaaS 订阅模式，Canonry 可源码自托管。
问. Canonry 免费吗？
许可证为 FSL-1.1-ALv2，个人与非生产使用免费，两年后该版本自动转 Apache 2.0，当前企业生产使用需购买商业授权，具体条款见仓库 LICENSE 文件。
安全风险提示
对 1960 个源码文件做了高风险函数扫描，exec 命中 48 处、child_process 命中 13 处，逐类核对均为构建脚本与测试代码中的合法用途，未发现后门或恶意外联，未检出硬编码密钥。
FSL-1.1-ALv2 许可证对生产使用有商业授权要求，部署前请阅读仓库 LICENSE；接入各模型与数据源时涉及的 API Key 均需自行妥善保管。
下载说明
本页提供 Canonry AEO优化平台的完整源码打包下载，含 backend、frontend 全部 monorepo 代码与部署脚本。
压缩包为原始仓库文件，下载解压后按部署提示准备 Node 22 与 pnpm 环境即可运行。
GitHub项目开源地址 https://github.com/Canonry/canonry
