# はじめに

> できることと、5分で動かす手順（script を1行 → 属性を付ける → 管理画面で確かめる）。

URL: https://sitekit.example/docs

## SiteKit でできること

SiteKit は、できあがった静的サイト（HTML）に後から付ける部品です。サイトをどう作ったかは問いません。AI に作らせた HTML でも、手で書いた HTML でも同じように使えます。

付けられるものは3つです。

- **お店の人が直せる箇所（CMS）** — 営業時間・お知らせ・写真など、HTML に印を付けた箇所を、お店の人が管理画面から直せます
- **お問い合わせフォーム** — 送信の受付・保存、お店へのメールと Slack の通知、お客様へのお礼メール（自動返信）
- **流入元（UTM）の記録と GTM の読み込み** — 広告から来た人の `utm_*` などを覚えておき、フォームの送信に添えます

サイト側で JavaScript は書きません。hidden 項目を足す必要もありません。script を1行入れて、HTML に属性を付けるだけです。

**CMS が止まってもサイトは止まりません。** 値が届かないときは、HTML に書いた静的な文言がそのまま表示されます。だから HTML の文言は、それだけ読んで意味が通る内容にしておきます。

## 5分で動かす

### 1. サイトを登録して、サイト ID を受け取る （近日）

登録すると、無料の Dev プランでサイトが1つ作られ、サイト ID（例: `hanaya`）が決まります。セルフサービスの登録画面は準備中です。開発用・プレビュー用のドメイン（`localhost` や `*.pages.dev` など）で動かせます。詳しくは [プランと上限](https://sitekit.example/docs/plans)。

### 2. script を1行入れる

`</body>` の直前か、`<head>` に `defer` 付きで入れます。`data-site` にサイト ID を書きます。

```html
<script src="https://cdn.sitekit.example/sitekit.js" data-site="hanaya" defer></script>
```

### 3. 属性を付ける

フォームは、`<form>` に `data-sitekit-form` を付けるだけです。送信処理は script が行います。

```html
<form data-sitekit-form="contact">
  <label>お名前 <input name="name" required></label>
  <label>メール <input type="email" name="email" required></label>
  <label>お問い合わせ内容 <textarea name="message"></textarea></label>

  <!-- ボット対策。人には見えない場所に置く（必須） -->
  <input type="text" name="_hp" tabindex="-1" autocomplete="off"
         style="position:absolute;left:-9999px" aria-hidden="true">

  <button type="submit">送信する</button>
</form>

<div data-sitekit-success role="status" aria-live="polite" hidden>お問い合わせありがとうございました。</div>
<div data-sitekit-error role="status" aria-live="polite" hidden></div>
```

お店の人に直してもらう箇所には `data-cms` を付けます。中の文言は、値が届かないときにそのまま出る既定の文言です。

```html
<dl>
  <dt>営業日</dt>
  <dd data-cms="hours.days">月〜土</dd>
  <dt>時間</dt>
  <dd data-cms="hours.time">10:00 - 18:00</dd>
</dl>
```

### 4. schema.json で「何を直せるか」「どんなフォームか」を決める

上の HTML に合わせると、こう書きます。`forms[].key` がフォームの `data-sitekit-form` の値と、`fields[].key` が入力の `name` と一致している必要があります。

```json
{
  "locales": ["ja"],
  "groups": [
    { "key": "hours", "label": "営業時間", "fields": [
      { "key": "days", "label": "営業日", "type": "text" },
      { "key": "time", "label": "時間", "type": "text" }
    ] }
  ],
  "forms": [
    { "key": "contact", "label": "お問い合わせ", "fields": [
      { "key": "name", "label": "お名前", "type": "text", "required": true },
      { "key": "email", "label": "メールアドレス", "type": "email", "required": true },
      { "key": "message", "label": "お問い合わせ内容", "type": "textarea" }
    ] }
  ]
}
```

書き方の全体は [schema.json の書き方](https://sitekit.example/docs/schema)。schema.json をサイトに反映する手段（管理画面でのサイト追加、CLI の `schema push`、MCP）はセルフサービス版とあわせて提供します （近日）。

### 5. 管理画面で確かめる

[管理画面](https://app.sitekit.example) にログインすると、schema.json に書いた項目が入力欄として並びます。値を直して公開すると、最長1分でサイトに反映されます（サイトの再デプロイは要りません）。フォームから送ったお問い合わせも、管理画面の一覧に届きます。

> 値をサーバー側で HTML に埋め込むには、Cloudflare Pages の中継（Pages Functions）を使います。ほかのホスティングでは script の `data-embed` で表示時に埋め込みます。違いは [中継とホスティング](https://sitekit.example/docs/hosting) にあります。

## 用語

| 用語 | 意味 |
|---|---|
| サイト ID | サイトごとの識別子。script の `data-site`、API の URL に入る |
| schema.json | お店の人が直せる項目と、フォームの項目を宣言するファイル |
| 公開 JSON | 公開中の内容をまとめた JSON。中継や `data-embed` がこれを読んで HTML に埋める |
| 中継 | Cloudflare Pages の Pages Functions。配信前に公開 JSON の値を HTML に埋め込む |
| 主言語 | schema.json の `locales` の先頭。お店の人が入力する言語で、翻訳が無いときの表示にも使う |

## 次に読む

- [script タグ](https://sitekit.example/docs/script) — 属性の一覧と、script だけで動くもの
- [直せる箇所の印（CMS）](https://sitekit.example/docs/cms) — テキスト・写真・お知らせの一覧・多言語
- [フォーム](https://sitekit.example/docs/forms) — 表示・通知・自動返信・テスト送信
- [AI エージェントに渡す](https://sitekit.example/docs/agents) — Claude Code や Cursor にそのまま貼れる指示文