Kanorio

雲端基礎設施

發佈傳遞、探索與測量

邊緣快取的 Content Delivery API、網站搜尋、SEO 與 AI 檔案、邊緣重新導向、第一方分析與自訂網域。

部分

傳遞是指已發佈的內容如何觸及訪客、搜尋引擎與 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 會回報分析里程碑以及外部前端的問題。

API 開放的範圍

  • Full-text site search可用
    API
    Delivery GET /search; Management API site.search
    託管網站
    Hosted site search box
  • Site speed & Core Web Vitals monitor (/seo/speed)可用
    託管網站
    /seo/speed (CrUX field data & PageSpeed Insights lab data)
  • On-site promotional widgets (/marketing/on-site/topbar, modal, floating buttons)僅限託管
    託管網站
    /marketing/on-site/topbar, /marketing/on-site/modal, /marketing/on-site/floating (injected into Kanorio-hosted DOM; hidden in backoffice when frontendMode is HEADLESS)
    替代做法
    Model announcements as a custom Collection in /data and render your own banner or modal component in your frontend.
  • Brand identity: logo, site icon, brand colors, color scheme, fonts & corner radius (/settings/brand)可用
    API
    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
    Elements
    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)僅限託管
    託管網站
    /editor visual site builder (hidden in backoffice when frontendMode is HEADLESS)
    替代做法
    Page content (sections[]), headers, footer and seo metadata are exposed via Delivery API /pages and /globals/*, and brand identity via GET /site brand; visual layout is owned by your frontend codebase.
  • Automatic OG image generation, sitemap.xml, robots.txt & JSON-LD output可用
    API
    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可用
    API
    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)部分
    API
    Delivery POST /analytics/pageview (anonymous, per-IP rate-limited, records path / referrer / UA category); Management API analytics.*
    Elements
    <KanorioAnalytics />
    託管網站
    /analytics

API 參考

Webhook 事件

Elements

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

近期變更

  • 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
查看完整變更紀錄

給網站擁有者

在後台如何使用這項產品,請見說明中心。

開啟說明中心