コンテンツにスキップ

Claude Codeでイベントログを使った匿名アンケートを作ってCloudflareに公開する

アンケートを作りたい。回答を集めて、集計もしたい。

Cloudflare には、起きたことを記録していくだけの置き場がある。一度書いたら書き換えず、あとからまとめて数える。3か月経つと古いものから消えていく。アクセスログに近い性質だが、テキストファイルではない。この記事では、そこにアンケートの回答を貯める。

最後には、回答し終わった人に「あなたは〇〇タイプです」と診断結果を返すところまでやる。そこまでやると、Google フォームでは作れないものになる。

データをブラウザの外に置くとき、置き方は3つある(→ Webアプリの2つのタイプ)。この記事はそのうち「集計」を作る。

置き方どういうことか技術
集計集めて数える。1件ずつは取り出さないWorkers Analytics Engine(この記事)
出し入れ1件ずつ出し入れする。あとから直す・消すもできるD1
リアルタイムその場で見える、その場で決まるDurable Objects

アンケートの回答は起きてしまった出来事で、あとから書き換えることがない。全体で何票かが分かればよく、「この人の回答」を1件だけ引くこともない。だから集計で足りる。

レストランに例えるなら、こうなる。

  • 冷蔵庫:食材を出し入れする。中身を入れ替える。使えば減る
  • 伝票の束(今回):書いたら綴じるだけ。書き換えない。あとで枚数を数える。古い綴りから処分していく

掲示板の投稿はあとから消したり直したりするので冷蔵庫が要る。アンケートは伝票で足りる。

作りは Cloudflare Workers(画面もバックエンドも)と Workers Analytics Engine(データの置き場)。D1でデータ共有型Webアプリを作るを先にやった人は、置き場が D1 から変わっただけと読める。やっていなくても、この記事だけで完結する。

参加者のレベルをざっくり診断するアンケートを作る。

  • 選択式の質問に答えると、その場で診断結果が出る
  • 同じ人が何度答えても1票として数える
  • 締切を過ぎたら受け付けない
  • 集計は、主催者が Claude Code に頼んで見る

完成するとこうなる。

4つの質問が並んだアンケートページ。上部に締切の日時が表示されている

答え終わるとこうなる。

「あなたは 自走型」と大きく表示された診断結果の画面

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 でやるので、状態を持たなくてよい。

かからない。今回使うものは、すべて 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つのタイプ)。アンケートは集めて数えるだけなので、軽いほうで足りる。

WranglerでCloudflareに公開するまでを済ませていること。wrangler が使えて、Cloudflare にログインできていればよい。

ここを飛ばすと、あとのデプロイが失敗する。しかも失敗の仕方が分かりにくいので、先にやっておく。

Cloudflare のダッシュボードで Storage & databases から Analytics Engine を開き、右上の Enable を押す。

Analytics Engine の画面。右上に Enable ボタンがある

押すとボタンの位置が Create Dataset に変わる。作業はこれだけ。

Create Dataset は押さなくてよい。データを入れる箱(データセット)は、最初に書き込んだ瞬間に自動で作られる。

Terminal window
npx wrangler whoami

アカウント名やメールアドレスが表示されればよい。表示されない場合はWranglerハンズオンの1章を参照してインストール・ログインする。

ここでのログインが、あとで集計を読むときにもそのまま使われる(5章)。

新しく作った作業フォルダ ~/claude/my-survey を Claudeデスクトップアプリで開く。フォルダの名前は、次の章で決めるベース名にそろえておく。

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)。

アンケート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 の診断の節に書き足した。気に入らなければ、あとから「診断の分け方を見直して」と頼めばよい。

質問と選択肢は、回答を集め始めたら変えない。集計は質問と選択肢の並びで数えるので、途中で変えると数が合わなくなる。公開する前に決めきっておく。

仕様と中身が書けたら、まとめて頼む。

プロンプト
AGENTS.md と survey.md のとおりにアンケートを作って、公開して。

公開すると、https://my-survey.<アカウントのサブドメイン>.workers.dev の形の URL が出る。この URL を配る。

開いて、自分で1回答えてみる。答え終わると診断結果が出る。

イベントログは手元で試せない。 ローカルで動かしても、Analytics Engine には書き込まれない。書き込みを確かめられるのは、公開したあとだけ。

この章のプロンプトを決めるときに、Claude Code(Sonnet 5.5)に作らせた。安全のための作りは、次のものが入った(3章で足した2行によるものを除く)。

安全策何を防ぐか
回答は POST だけで受け付ける。URL を開いただけ(GET)では書き込まないリンクのプレビューやブラウザの先読みで、誰も答えていないのに票が入ること(下の note)
送り元(Origin)が自分のサイトでなければ断るほかのサイトから回答を送り込まれること
回答者の ID はサーバーが作り、ページの JavaScript から読めない cookie(HttpOnly)に入れる回答者を指す値が、ページから読まれたり外に送られたりすること
IP アドレスもブラウザの種類も記録しない匿名のはずの回答から、人が分かること
存在しない質問や選択肢は断るおかしな値で集計を乱されること
締切はサーバー側で判定する画面を書き換えて、締切後に送られること
回答にアンケートIDを入れる次のアンケートの回答と混ざること
プロンプト
アンケートの集計結果を見せて

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で絞っているのも大事なところ。この表には過去のアンケートも入っているので、絞らないと混ざる。

Analytics Engine は、データが大量になると、全部ではなく一部だけを残して全体を推定する(サンプリング)。間引きは、書き込むときに指定する indexes という値ごとに起きる。

前の版を作ったとき、indexes にアンケートIDだけを入れたら、13行送って5行しか残らなかった。全部の回答が1つの値に集中したため。少ない行数でも起きる。

3章で足した「回答が多くても、集計で数が欠けないようにする」で、Claude Code は2つのことをした。

  • indexes に回答者ごとの値を入れて、間引きが1か所に集まらないようにした
  • 集計で、件数を数える代わりに「この1行は何行ぶんか」(_sample_interval)を足し合わせ、間引かれていても元の数に戻るようにした

同じ人が2回答えたときに2票と数えないために、回答者を見分ける必要がある。ただし名前もメールアドレスも聞かない。サーバーが発行した意味のない文字列を cookie に入れておくだけ。

ブラウザの localStorage に保存する方法もあるが、試したときの Claude Code は cookie を選んだ。cookie のほうがよい理由が3つある。

  • 勝手に消えない。Safari は localStorage を7日ほど使わないと消してしまう(→ ブラウザに保存したデータは消える)。アンケートの途中で消えると、同じ人が別人として数えられる。サーバーが発行した cookie はこの削除の対象外
  • 期限を決められる。締切と同時に切れるようにできる(7章)
  • ページ側から読めない。HttpOnly を付けた cookie は、ページの JavaScript から読めない。回答者を指す値がページ側に一切出てこない

シークレットウィンドウや別のブラウザで答えれば、別人として数えられる。厳密な一人一票にはならない(8-2)。

締切は survey.md に書いた1行で決まる。この1行で、3つのことが同時に決まる。

  1. この時刻を過ぎたら回答を受け付けない
  2. 回答者を見分ける cookie も、この時刻に切れる
  3. 締切後に開いた人にはフォームを出さず、終了したことを伝える

「受付を終了しました」と表示された画面

2つ目は見落としやすい。cookie が締切で切れるので、次に別のアンケートを取るとき、前回の回答者と結びつかない。3章で足した「別のアンケートの回答者とは結びつかないようにする」の行が、これを Claude Code に伝えている。

8-1. もう一度アンケートを取るとき

Section titled “8-1. もう一度アンケートを取るとき”

survey.md のアンケートID・締切・質問を書き換えて、作り直して公開する。

プロンプト
survey.md を書き換えたので、アンケートを作り直して公開して

ベース名もデータセットも変えなくてよい。Worker もデータセットもそのまま使い回す。Analytics Engine のデータは消せないが、回答にアンケートIDが入っているので、集計のときに今回の分だけを取り出せる。

過去のアンケートの集計も残っている(3か月以内なら)。アンケートIDを言えば見られる。

プロンプト
level-2026-11 の集計結果を見せて
  • その場で結果を見せたい。集計への反映に数十秒かかる
  • 厳密な一人一票。シークレットウィンドウや別のブラウザを使えば別人になる
  • 長く残したい。Analytics Engine のデータは3か月で消える。残したい集計は、消える前に Claude Code に書き出してもらう

3つ目が引っかかるなら、D1でデータ共有型Webアプリを作るに進む。

選択式ではなく自由に書いてもらうこともできる。ただし考えることが増える。

  • 集計の形が変わる。数えられないので一覧を出すことになる
  • 画面に出すときのエスケープが必要になる。選択肢は決まった値だけだったので危険がなかったが、自由記述は何でも入る
  • 匿名でなくなることがある。名前や所属を書いてしまう人がいる。仕組みでは防げないので、設問文で断るしかない

自由記述が主役になるなら、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 の期限が切れたときに自動で更新されるかは、確かめていない