# 发布传递、探索与测量

> The edge-cached Content Delivery API, site search, SEO and AI files, edge redirects, first-party analytics and custom domains.

> Markdown version of https://kanorio.com/zh-CN/developers/products/delivery. Append `.md` to any developer docs URL for this format. Index: https://kanorio.com/llms.txt · MCP: https://app.kanorio.com/api/mcp
>
> Translated from the English original: https://kanorio.com/en/developers/products/delivery.md

Status: **Partial**

传递是指已发布的内容如何触及访客、搜索引擎与 AI 助手，无论是由 Kanorio 托管网站，还是您自行构建前端。

## 涵盖范围

- **Content Delivery API：** 匿名、边缘缓存读取，支持版本令牌与缓存标签。发布后，网站会在数秒内切换至新版本。
- **搜索：** 跨页面、文章与产品的全文搜索。
- **SEO 与 AI 文件：** Sitemap、robots.txt、llms.txt、Feed 与 JSON-LD，链接皆指向您的域名。
- **边缘规则：** 重定向、AI 爬虫封锁与 IndexNow 令牌文件，通过您中间件中的 `@kanorio/sdk/edge` 应用。
- **分析：** 第一方页面浏览量与 AI 助手引荐来源，由 `<kanorio-analytics>` 回报。
- **域名：** 自定义域名及其 DNS 状态。

## API 如何运作

- 使用 Management API 发布与取消发布网站、更改开发者设置、创建预览令牌、绑定域名及查询分析数据。
- 本页面提及的其他功能皆由 Content Delivery API 与 SDK 提供服务。
- Webhooks 会回报分析里程碑以及外部前端的问题。

## What the APIs expose

| Capability | Status | API | Elements | Hosted site | Webhooks |
| --- | --- | --- | --- | --- | --- |
| Full-text site search | Available | Delivery `GET /search`; Management API `site.search` | — | Hosted site search box | — |
| Site speed & Core Web Vitals monitor (`/seo/speed`) | Available | — | — | `/seo/speed` (CrUX field data & PageSpeed Insights lab data) | — |
| On-site promotional widgets (`/marketing/on-site/topbar`, modal, floating buttons) | Hosted only | — | — | `/marketing/on-site/topbar`, `/marketing/on-site/modal`, `/marketing/on-site/floating` (injected into Kanorio-hosted DOM; hidden in backoffice when `frontendMode` is `HEADLESS`) | — |
| Brand identity: logo, site icon, brand colors, color scheme, fonts & corner radius (`/settings/brand`) | Available | Management `site.get_settings` / `site.update_settings` (`settings.brand`); Delivery `GET /site` (`brand`: colors resolved per color scheme with readable foreground, the owner's `colorScheme`, logo per backdrop, font families with stylesheet URLs, corner radius scale); CLI `settings update --brand-color --corner-radius --color-scheme` | `KanorioProvider` and every element read `brand` from `GET /site` once and apply it to `.kanorio-elements` as `--brand-color`, `--brand-foreground`, `--site-radius-*` and the brand font (`brand={false}` to opt out) | `/settings/brand` (both frontend modes; takes effect immediately, no publish) | — |
| Section layout & theme: text sizes & section density (`/editor` design surface) | Hosted only | — | — | `/editor` visual site builder (hidden in backoffice when `frontendMode` is `HEADLESS`) | — |
| Automatic OG image generation, `sitemap.xml`, `robots.txt` & JSON-LD output | Available | Delivery `GET /seo/sitemap.xml`, `GET /seo/robots.txt`, `GET /seo/indexnow-key.txt`, `GET /seo/jsonld?path=`, plus `seo` object on `/pages/:slug` and `/collections/blog/items/:slug` (`ogImage` includes `autoOgImage`); SDK `seo.rewrites({ framework })`, `seo.jsonLd(path)`, `createKanorioMiddleware()` (serves the IndexNow key file) | — | Automatically served on Kanorio-hosted pages | — |
| `llms.txt`, `llms-full.txt` & AI crawler management | Available | Delivery `GET /seo/llms.txt`, `GET /seo/llms-full.txt`, `GET /seo/robots.txt`, `GET /site` (`crawlerRules`), `POST /analytics/bot-hit`; SDK `@kanorio/sdk/edge` (`createKanorioMiddleware`) | — | Hosted `/llms.txt`, `/llms-full.txt` and edge bot tracker | — |
| First-party visitor & AI crawler traffic analytics (`/analytics`) | Partial | Delivery `POST /analytics/pageview` (anonymous, per-IP rate-limited, records `path` / `referrer` / UA category); Management API `analytics.*` | `<KanorioAnalytics />` | `/analytics` | — |

## API reference

- Management API: [Site](https://kanorio.com/en/developers/management-api/site) (13 operations)
- Management API: [Domains](https://kanorio.com/en/developers/management-api/domains) (3 operations)
- Management API: [Analytics](https://kanorio.com/en/developers/management-api/analytics) (4 operations)
- Management API: [Seo](https://kanorio.com/en/developers/management-api/seo) (2 operations)
- Content Delivery API: [Openapi](https://kanorio.com/en/developers/delivery-api/openapi) (1 operations)
- Content Delivery API: [Site](https://kanorio.com/en/developers/delivery-api/site) (1 operations)
- Content Delivery API: [Seo](https://kanorio.com/en/developers/delivery-api/seo) (6 operations)
- Content Delivery API: [Analytics](https://kanorio.com/en/developers/delivery-api/analytics) (2 operations)
- Content Delivery API: [Search](https://kanorio.com/en/developers/delivery-api/search) (1 operations)

## Webhook events

- `site.analytics.milestone`: Fired when cumulative site pageviews reach a milestone.
- `site.externalFrontend.degraded`: Fired when the daily external frontend health check detects failing core endpoints (unreachable storefront or broken SEO rewrites).

Payloads: https://kanorio.com/en/developers/webhooks/events

## Elements

- `<kanorio-analytics>`: Privacy-first pageview and SPA route-change tracking sent with a non-blocking beacon.

## Recent changes

- 2026-11-04: Localization: each locale can have its own URL slug
- 2026-11-03: SDK: locale routing, hreflang alternates and wildcard redirects at the edge
- 2026-11-03: Cache tags: per-record and per-locale invalidation, new localization events
- 2026-11-03: Delivery API: locale on every read
- 2026-11-03: Developer settings: headlessEnabled removed

Full changelog: https://kanorio.com/en/developers/changelog

## For site owners

Dashboard help: https://kanorio.com/zh-CN/help/seo