CLI

Kanorio CLIは、スクリプトやCI向けにManagement APIをラップし、型生成とヘッドレスフロントエンドのヘルスチェックという2つの開発者ツールを提供します。

npx @kanorio/cli --help

サインイン

npx @kanorio/cli login --token knr_pat_...

トークンは、所有者のみがアクセス可能な権限で ~/.config/kanorio/config.json に保存されます。CI環境では、保存されたトークンよりも優先される KANORIO_TOKEN を設定してください。サービスアカウントのトークンも使用可能です。

一般的なコマンド

kanorio sites list
kanorio pages list ws_example123
kanorio pages replace-sections ws_example123 pg_example456 --file sections.json
kanorio media upload ws_example123 --file hero.jpg
kanorio publish ws_example123
kanorio domains status ws_example123

コンテンツを上書きするコマンドは、実行前にリソースを読み込み、そのタイムスタンプを送信します。そのため、他者の編集を上書きすることなく CONFLICT エラーで失敗するようになっています。コマンドの全リストを確認するには kanorio --help を実行してください。

出力と終了コード

• --json を追加すると、エラーを含む生のAPIレスポンスが出力され、スクリプト処理に利用できます。
• エラーは stderr に <CODE> (HTTP <status>): <message> の形式で出力され、終了コード 1 で終了します。使用方法の誤りは終了コード 2 で終了します。
• 非推奨の操作に関する警告は stderr に出力されます。

型の生成

kanorio types --site https://s-xxxxxxxxxxxx.kanorio.com --out src/kanorio.d.ts

types コマンドは、サイトの公開コレクションスキーマを読み取り、すべてのコレクションに対する FieldData、Expanded、Item 型を生成します。さらに、ページ、グローバル、サイトメタデータの型も生成されます。スキーマが変更された際に再度実行するか、collections.schema.changed Webhook を購読して自動化してください。

ヘッドレスフロントエンドのチェック

kanorio doctor --site ws_example123

doctor コマンドは、フロントエンドがサイトマップ、robots.txt、llms.txt、フィード、JSON-LD、IndexNowキーファイルを正しく提供しているか、ページコンテンツが同期されているか、ページビューとWebhookが正常に到達しているかを確認します。Kanorioホストのサイトから独自のフロントエンドへドメインを移行する前に --switching を追加して実行してください。