Claude Codeでイベントログを使った匿名アンケートを作ってCloudflareに公開する
アンケートを作りたい。回答を集めて、集計もしたい。
Cloudflare には、起きたことを記録していくだけの置き場がある。一度書いたら書き換えず、あとからまとめて数える。3か月経つと古いものから消えていく。アクセスログに近い性質だが、テキストファイルではない。この記事では、そこにアンケートの回答を貯める。
最後には、回答し終わった人に「あなたは〇〇タイプです」と診断結果を返すところまでやる。そこまでやると、Google フォームでは作れないものになる。
本記事の位置付け
Section titled “本記事の位置付け”データをブラウザの外に置くとき、置き方は3つある(→ Webアプリの2つのタイプ)。この記事はそのうち「集計」を作る。
| 置き方 | どういうことか | 技術 |
|---|---|---|
| 集計 | 集めて数える。1件ずつは取り出さない | Workers Analytics Engine(この記事) |
| 出し入れ | 1件ずつ出し入れする。あとから直す・消すもできる | D1 |
| リアルタイム | その場で見える、その場で決まる | Durable Objects |
アンケートの回答は起きてしまった出来事で、あとから書き換えることがない。全体で何票かが分かればよく、「この人の回答」を1件だけ引くこともない。だから集計で足りる。
レストランに例えるなら、こうなる。
- 冷蔵庫:食材を出し入れする。中身を入れ替える。使えば減る
- 伝票の束(今回):書いたら綴じるだけ。書き換えない。あとで枚数を数える。古い綴りから処分していく
掲示板の投稿はあとから消したり直したりするので冷蔵庫が要る。アンケートは伝票で足りる。
作りは Cloudflare Workers(画面もバックエンドも)と Workers Analytics Engine(データの置き場)。D1でデータ共有型Webアプリを作るを先にやった人は、置き場が D1 から変わっただけと読める。やっていなくても、この記事だけで完結する。
1. 作るもの
Section titled “1. 作るもの”参加者のレベルをざっくり診断するアンケートを作る。
- 選択式の質問に答えると、その場で診断結果が出る
- 同じ人が何度答えても1票として数える
- 締切を過ぎたら受け付けない
- 集計は、主催者が Claude Code に頼んで見る
完成するとこうなる。
答え終わるとこうなる。
1-1. テーブルを作らずに、SQL で数える
Section titled “1-1. テーブルを作らずに、SQL で数える”回答を貯める先は Workers Analytics Engine という。名前のとおり分析用のもので、起きたことを1件ずつ記録していく使い方をする。
ただし「ログ」と聞いて思い浮かべるテキストファイルではない。表の形で貯まっていて、grep ではなく SQL で集計できる。それでいて、「テーブルを作る」「列の型を決める」という準備が要らない。
SQL:貯まったデータに対して「どの条件のものを、どう数えるか」を指示する言い方。この記事では Claude Code に「集計して」と頼めば SQL を書いて実行してくれる。自分で書けなくてよい。
イメージとしては、かなり変わったエクセルを思い浮かべるとよい。
- 行を足すことしかできない
- 一度入れたセルは書き換えられない。修正も削除もできない
- 列は最初から決まった数(文字列20個、数値20個、特別な1個)があって、増やせない
- 見出し行がない。「この列はアンケートID」と書いておく場所がない
- 3か月経った行から消えていく
不便に見えるが、そのぶん設計する作業がほとんど無い。テーブルを作らなくてよい。列の型を決めなくてよい。最初に書き込んだ瞬間に表ができる。
見出し行がないので、「1列目にアンケートIDを入れた」という決めごとは、表のどこにも残らない。だから Claude Code に、どの値をどの列に入れたかを AGENTS.md に書いてもらう。試したときは、頼まなくても書いた。これを残さないと、3か月後に「1列目は何だっけ」となったとき、表を見ても分からない。
もうひとつ大事な考え方がある。重複回答の排除を、書き込むときではなく集計するときにやる。
先に調べてから書くやり方なら、「この人はもう答えたか」を確認してから書き込む。そのために誰が答えたかを覚えておく必要があり、つまり状態を持つことになる。今回は何も調べずに書き込んで、数えるときに同じ人の回答をまとめる。集計の SQL でやるので、状態を持たなくてよい。
1-2. お金はかかるのか
Section titled “1-2. お金はかかるのか”かからない。今回使うものは、すべて Cloudflare の無料の範囲で動く。
Workers Analytics Engine の無料枠はこうなっている。
| 無料枠 | |
|---|---|
| 書き込み | 1日10万件 |
| 集計(読み出し) | 1日1万回 |
さらに公式ドキュメントには、現時点では Analytics Engine の利用料を請求していないと書かれている(Pricing)。将来課金する前提の書き方なので「ずっと無料」という約束ではないが、少なくとも今は無料枠を気にしなくてよい。
ページを置く Cloudflare Workers も、個人が使う範囲なら無料で足りる。静的ファイルの配信は無料・無制限で、リクエスト数に数えられるのはコードを呼んだときだけ(Billing and Limitations)。
1-3. データベースでも作れる。それでもこちらを選ぶ理由
Section titled “1-3. データベースでも作れる。それでもこちらを選ぶ理由”同じアンケートは D1(データベース)でも作れる。テーブルを1つ用意して、回答を1行ずつ入れて、GROUP BY で数えればよい。そちらのほうが素直なくらいで、「この回答を消す」「あとから直す」といった操作もできる。
それでもイベントログを選ぶ理由が2つある。
1つ目は、準備が要らないこと。テーブル設計もマイグレーションも無い(1-1)。アンケートは作って配って終わりのものなので、準備の重さがそのまま面倒さになる。
2つ目は、数の制限。D1 は無料プランだと10個までしか作れない。
| 無料プランの上限 | |
|---|---|
| D1 データベース | 10個(有料プランなら 50,000個) |
| イベントログのデータセット | 上限の記載なし |
10個は、試しているうちに意外と早く当たる。イベントログは1つのデータセットを使い回す作りにできる(アンケートごとにIDで分ける。→ 8-1)ので、アンケートを何回取っても増えない。
どちらが上、という話ではない。 1件ずつ読んだり直したりするならデータベースが要る(→ Webアプリの2つのタイプ)。アンケートは集めて数えるだけなので、軽いほうで足りる。
2. 事前準備
Section titled “2. 事前準備”WranglerでCloudflareに公開するまでを済ませていること。wrangler が使えて、Cloudflare にログインできていればよい。
2-1. Analytics Engine を有効にする
Section titled “2-1. Analytics Engine を有効にする”ここを飛ばすと、あとのデプロイが失敗する。しかも失敗の仕方が分かりにくいので、先にやっておく。
Cloudflare のダッシュボードで Storage & databases から Analytics Engine を開き、右上の Enable を押す。
押すとボタンの位置が Create Dataset に変わる。作業はこれだけ。
Create Dataset は押さなくてよい。データを入れる箱(データセット)は、最初に書き込んだ瞬間に自動で作られる。
2-2. Wrangler が使えるか確認する
Section titled “2-2. Wrangler が使えるか確認する”npx wrangler whoamiアカウント名やメールアドレスが表示されればよい。表示されない場合はWranglerハンズオンの1章を参照してインストール・ログインする。
ここでのログインが、あとで集計を読むときにもそのまま使われる(5章)。
2-3. 作業フォルダを用意する
Section titled “2-3. 作業フォルダを用意する”新しく作った作業フォルダ ~/claude/my-survey を Claudeデスクトップアプリで開く。フォルダの名前は、次の章で決めるベース名にそろえておく。
3. 名前と仕様を決める
Section titled “3. 名前と仕様を決める”Worker とデータセットに付ける名前の元になるベース名を決めて、作るものの仕様と一緒に AGENTS.md に書いてもらう。この記事では my-survey を例に使う。
このプロジェクトのベース名と、これから作るアプリの仕様を、以下のとおり AGENTS.md に書いてください。CLAUDE.md からは AGENTS.md を読み込むようにしてください。====## 名前- ベース名は my-survey- Worker 名 = ベース名- Analytics Engine のデータセット名 = ベース名のハイフンをアンダースコアに変えた名前
## 作るもの:匿名アンケート- アンケートの中身(アンケートID・締切・質問と選択肢・診断の方針)は survey.md に書く- 選択式の質問に答えると、その場で診断結果が出る- 同じ人が何度答えても1票として数える- 締切を過ぎたら受け付けない- 名前やメールアドレスは聞かない- 回答はイベントログ(Analytics Engine)に貯める。データベースは使わない- 次のアンケートも、同じデータセットに貯める- 集計ページは作らない。集計は、頼まれたときにエージェントが wrangler のログインで読んで出す- 別のアンケートの回答者とは結びつかないようにする- 回答が多くても、集計で数が欠けないようにするmy-survey を自分のベース名に置き換えて渡す。ベース名はそのまま公開 URL(https://my-survey.<アカウントのサブドメイン>.workers.dev)の先頭になる。短く、英小文字と数字とハイフンだけにしておく。
データセット名にハイフンは使えない。 データセット名がそのまま SQL のテーブル名になるため(
my-surveyならmy_survey)。この変換をAGENTS.mdに書いておけば、以降は考えなくてよくなる。
最後の2行は、安全のために足した行。
| 足した行 | 無いとどうなったか | 足すとどうなったか |
|---|---|---|
| 別のアンケートの回答者とは結びつかないようにする | 回答者を見分ける cookie の期限が1年になった。次のアンケートでも同じ ID が使われ、同じ人の回答を回をまたいで結びつけられる | cookie をアンケートごとに分け、期限を締切までにした。記録する ID もアンケートごとに別の値にした |
| 回答が多くても、集計で数が欠けないようにする | 間引きのしくみ(6-2)を考えない作りになった | 間引きが1か所に集まらない書き方にし、集計でも間引かれた分を戻して数えた |
集計ページを作らないのは、外から叩ける入口を増やさないため。集計は手元の Claude Code が、wrangler のログインを使って読む(5章)。専用のトークンを作る必要もない。
本記事は Claude Code を例に進めるが、Codex など他のコーディングエージェントでも同じプロンプトで進められる(CLAUDE.md と AGENTS.md の関係は → CLM)。
4. アンケートの中身を書く
Section titled “4. アンケートの中身を書く”アンケートID・締切・質問・診断の方針を、survey.md という1つのファイルにまとめる。
survey.md を作って。中身はこれ。====# あなたのレベル診断
- アンケートID:level-2026-11- 締切:2026年11月30日 23時59分(日本時間)
## ターミナル(黒い画面)を使ったことは?- 使ったことがない- コピペして実行したことがある- 自分でコマンドを打って操作できる
## Git や GitHub は?- 名前を聞いたことがある程度- コミットやプッシュをしたことがある- ブランチを分けて作業できる
## 作ったものを公開したことは?- まだない- サービスの画面から公開した- コマンドでデプロイした
## エラーが出たときは?- どうしていいか分からなくなる- エラー文を検索したり AI に聞く- ログを読んで原因を絞り込める
## 診断回答から3つくらいのタイプに分けて、答え終わった画面に出す。分け方とタイプの名前は任せる。否定的な名前にはしない。なぜ
AGENTS.mdと分けるのか。アプリの作りは変わらないが、アンケートの中身は回ごとに変わる。分けておけば、次のアンケートはsurvey.mdを書き換えて作り直すだけでよい(8-1)。前回の分をsurvey-2026-11.mdのように残しておくこともできる。
診断の節には、方針だけを書いている。分け方とタイプの名前は Claude Code に任せる。試したときは、選択肢に上から 0・1・2 点を付けて合計点で3つに分け、決めた分け方を survey.md の診断の節に書き足した。気に入らなければ、あとから「診断の分け方を見直して」と頼めばよい。
質問と選択肢は、回答を集め始めたら変えない。集計は質問と選択肢の並びで数えるので、途中で変えると数が合わなくなる。公開する前に決めきっておく。
5. 作って公開する
Section titled “5. 作って公開する”仕様と中身が書けたら、まとめて頼む。
AGENTS.md と survey.md のとおりにアンケートを作って、公開して。公開すると、https://my-survey.<アカウントのサブドメイン>.workers.dev の形の URL が出る。この URL を配る。
開いて、自分で1回答えてみる。答え終わると診断結果が出る。
イベントログは手元で試せない。 ローカルで動かしても、Analytics Engine には書き込まれない。書き込みを確かめられるのは、公開したあとだけ。
5-1. 言わなくても入った安全策
Section titled “5-1. 言わなくても入った安全策”この章のプロンプトを決めるときに、Claude Code(Sonnet 5.5)に作らせた。安全のための作りは、次のものが入った(3章で足した2行によるものを除く)。
| 安全策 | 何を防ぐか |
|---|---|
| 回答は POST だけで受け付ける。URL を開いただけ(GET)では書き込まない | リンクのプレビューやブラウザの先読みで、誰も答えていないのに票が入ること(下の note) |
| 送り元(Origin)が自分のサイトでなければ断る | ほかのサイトから回答を送り込まれること |
回答者の ID はサーバーが作り、ページの JavaScript から読めない cookie(HttpOnly)に入れる | 回答者を指す値が、ページから読まれたり外に送られたりすること |
| IP アドレスもブラウザの種類も記録しない | 匿名のはずの回答から、人が分かること |
| 存在しない質問や選択肢は断る | おかしな値で集計を乱されること |
| 締切はサーバー側で判定する | 画面を書き換えて、締切後に送られること |
| 回答にアンケートIDを入れる | 次のアンケートの回答と混ざること |
6. 結果を見る
Section titled “6. 結果を見る”アンケートの集計結果を見せてClaude Code が、wrangler のログイン(npx wrangler auth token)を使って Analytics Engine に SQL を投げ、質問ごと・診断ごとの数を出す。ダッシュボードには、貯めたデータを見る画面が無い。読み出す方法は SQL の API だけで、それを Claude Code に任せる形。
「どの質問で、上級者と初心者の答えが分かれたか」「診断ごとの人数は」のように、聞き方を変えれば別の集計も出せる。SQL を書くのは Claude Code なので、集計ページを作っていたら作り直しになる質問でも、その場で答えが返る。
ほかの人に結果を見せたいときは、集計結果をグラフのページにしてもらう。アーティファクト(Claude が作る、共有できるページ)が使える環境なら、それで足りる。
アンケートの集計結果を、ほかの人に見せられるグラフのページにして6-1. 重複回答をどう消しているか
Section titled “6-1. 重複回答をどう消しているか”集計するときに、回答者ごとにまとめて、いちばん新しい回答だけを取り出してから数えている。SQL にそのための書き方(argMax)があるので、ひとつのクエリでよい。
同じ人が答え直しても、票は増えずに移動するだけになる。書き込むときには何の判定もしていないのに、これが成り立つ。
数える前にアンケートIDで絞っているのも大事なところ。この表には過去のアンケートも入っているので、絞らないと混ざる。
6-2. 間引きと「数が欠けない」
Section titled “6-2. 間引きと「数が欠けない」”Analytics Engine は、データが大量になると、全部ではなく一部だけを残して全体を推定する(サンプリング)。間引きは、書き込むときに指定する indexes という値ごとに起きる。
前の版を作ったとき、indexes にアンケートIDだけを入れたら、13行送って5行しか残らなかった。全部の回答が1つの値に集中したため。少ない行数でも起きる。
3章で足した「回答が多くても、集計で数が欠けないようにする」で、Claude Code は2つのことをした。
indexesに回答者ごとの値を入れて、間引きが1か所に集まらないようにした- 集計で、件数を数える代わりに「この1行は何行ぶんか」(
_sample_interval)を足し合わせ、間引かれていても元の数に戻るようにした
6-3. 同じ人を見分ける
Section titled “6-3. 同じ人を見分ける”同じ人が2回答えたときに2票と数えないために、回答者を見分ける必要がある。ただし名前もメールアドレスも聞かない。サーバーが発行した意味のない文字列を cookie に入れておくだけ。
ブラウザの localStorage に保存する方法もあるが、試したときの Claude Code は cookie を選んだ。cookie のほうがよい理由が3つある。
- 勝手に消えない。Safari は
localStorageを7日ほど使わないと消してしまう(→ ブラウザに保存したデータは消える)。アンケートの途中で消えると、同じ人が別人として数えられる。サーバーが発行した cookie はこの削除の対象外 - 期限を決められる。締切と同時に切れるようにできる(7章)
- ページ側から読めない。
HttpOnlyを付けた cookie は、ページの JavaScript から読めない。回答者を指す値がページ側に一切出てこない
シークレットウィンドウや別のブラウザで答えれば、別人として数えられる。厳密な一人一票にはならない(8-2)。
締切は survey.md に書いた1行で決まる。この1行で、3つのことが同時に決まる。
- この時刻を過ぎたら回答を受け付けない
- 回答者を見分ける cookie も、この時刻に切れる
- 締切後に開いた人にはフォームを出さず、終了したことを伝える
2つ目は見落としやすい。cookie が締切で切れるので、次に別のアンケートを取るとき、前回の回答者と結びつかない。3章で足した「別のアンケートの回答者とは結びつかないようにする」の行が、これを Claude Code に伝えている。
8. ここから先
Section titled “8. ここから先”8-1. もう一度アンケートを取るとき
Section titled “8-1. もう一度アンケートを取るとき”survey.md のアンケートID・締切・質問を書き換えて、作り直して公開する。
survey.md を書き換えたので、アンケートを作り直して公開してベース名もデータセットも変えなくてよい。Worker もデータセットもそのまま使い回す。Analytics Engine のデータは消せないが、回答にアンケートIDが入っているので、集計のときに今回の分だけを取り出せる。
過去のアンケートの集計も残っている(3か月以内なら)。アンケートIDを言えば見られる。
level-2026-11 の集計結果を見せて8-2. この構成が向かないもの
Section titled “8-2. この構成が向かないもの”- その場で結果を見せたい。集計への反映に数十秒かかる
- 厳密な一人一票。シークレットウィンドウや別のブラウザを使えば別人になる
- 長く残したい。Analytics Engine のデータは3か月で消える。残したい集計は、消える前に Claude Code に書き出してもらう
3つ目が引っかかるなら、D1でデータ共有型Webアプリを作るに進む。
8-3. 自由記述を足したいとき
Section titled “8-3. 自由記述を足したいとき”選択式ではなく自由に書いてもらうこともできる。ただし考えることが増える。
- 集計の形が変わる。数えられないので一覧を出すことになる
- 画面に出すときのエスケープが必要になる。選択肢は決まった値だけだったので危険がなかったが、自由記述は何でも入る
- 匿名でなくなることがある。名前や所属を書いてしまう人がいる。仕組みでは防げないので、設問文で断るしかない
自由記述が主役になるなら、Google フォームを使うか、D1 を使うほうがよい。今回の構成は「数えるもの」に向いている。
8-4. この構成が要るのはどんなときか
Section titled “8-4. この構成が要るのはどんなときか”診断の部分は、イベントログを使っていない。画面の中だけで決まる。つまり診断だけなら、この記事の仕組みは要らない。
逆に「アンケートなら Google フォームでいいのでは」とも思うかもしれない。集めるだけなら、そのとおり。ただ診断を入れると事情が変わる。
| Google フォーム | この記事の構成 | |
|---|---|---|
| 回答後のメッセージ | 1つだけ。回答に応じて出し分けることはできない | 点数に応じて出し分けられる |
| 回答による分岐 | あるが、1問の回答による分岐。3問3択なら27通りのセクションを手で作ることになる | 質問が増えても点数を足すだけ |
| テスト機能のフィードバック | 設問ごとの解説であって、合計点に応じた出し分けではない | 合計点で区分を決める |
Apps Script を使えば判定はできる。ただし動くのは送信後のサーバー側なので、メールを送るか別のページに飛ばすかしかできない。「送信した瞬間に画面に出る」体験は作れない。
| やりたいこと | 必要なもの |
|---|---|
| 回答を集めるだけ | Google フォームで足りる |
| 診断を返すだけ | HTML を1枚公開するだけ(HTMLをアップロードして公開するの範囲) |
| 集めて、かつ返す | この記事の構成 |
8-5. 複数のサイトで1つのデータセットを使う
Section titled “8-5. 複数のサイトで1つのデータセットを使う”別のサイト(別の Worker)から、同じデータセットに書き込むこともできる。設定ファイルのデータセット名を同じにするだけで、同じ表に集まる。
まとめるなら、アンケートIDにサイト名を含めておく(siteA-level-2026-11 のように)。集計のときに絞れる。絞り忘れると他のサイトの回答が混ざる。
見る人を分けたいなら、データセットを分けても意味がない。 wrangler でそのアカウントにログインできる人は、アカウント内のどのデータセットも読める。
- 2026-10-29 に、工程ごとのプロンプト(画面 → 公開 → 受け口 → 集計ページ → 締切 → 診断を順に頼む形)から、仕様を書いて作ってもらう形に作り替えた。あわせて、API トークンを作って集計ページを置く作りをやめ、
wrangler auth tokenで Claude Code が集計する形にした - 5章のプロンプトは、Sonnet 5.5 で試した。試したのはデプロイの手前までで、実際の書き込みと集計は前の版で確かめたもの。作るたびに細かい作り(列の割り当て、1回の回答を何行に書くか)は変わる
wrangler auth tokenの期限が切れたときに自動で更新されるかは、確かめていない



