# 配信、検索、計測の公開

> 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/ja/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**

配信とは、Kanorioがサイトをホストしているか、あるいは独自のフロントエンドを構築しているかにかかわらず、公開されたコンテンツが訪問者、検索エンジン、AIアシスタントにどのように届くかを指します。

## 範囲

- **Content Delivery API.** バージョンキーとキャッシュタグを使用した、匿名かつエッジキャッシュされた読み取り。公開により、数秒以内にサイトが新しいバージョンへ移行します。
- **検索.** ページ、投稿、製品全体にわたる全文検索。
- **SEOおよびAIファイル.** 独自のドメインを指すリンクを含む、サイトマップ、robots.txt、llms.txt、フィード、JSON-LD。
- **エッジルール.** ミドルウェア内の `@kanorio/sdk/edge` によって適用されるリダイレクト、AIクローラーのブロック、IndexNowキーファイル。
- **アクセス解析.** `<kanorio-analytics>` によって報告される、ファーストパーティのページビューおよびAIアシスタントからの参照。
- **ドメイン.** カスタムドメインとその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/ja/help/seo
