この記事は「microCMSで『つくった・試した・工夫した』をシェアしよう! by microCMS Advent Calendar 2026」の記事です。
はじめに
大学2年の文学部生です。この秋から、賞金や賞品のつく公募(小説・エッセイ・ハッカソン・ポスターなど)に、締切の近い順で応募していく遊びをしています。調べる・下書きを作る・進み具合を記録するのは、ほとんど Claude Code に任せています。
困ったのは「一覧が見にくい」ことでした。公募 1 件につき 1 フォルダ、その中の status.md の先頭に締切や状態を書く、という形で管理していて、気づけば 409 フォルダ になっていました。Claude Code にとっては読みやすい形でも、スマホで「今週締切のものはどれだっけ」と見るには向きません。
そこで、初めて microCMS を使って
-
status.mdの中身を microCMS に入れる(入稿は AI に MCP 経由でやらせる) - microCMS の API から「まだ出していない公募」を締切順に取り、1 枚の HTML にする
という小さな「公募締切ボード」を作りました。microCMS を触るのも、ヘッドレス CMS を使うのも今回が初めてです。
全体の形
contests/<締切>-<名前>/status.md (Claude Code が書き換える正典)
│ export.mjs で JSON に
▼
Claude Code ──MCP──▶ microCMS(contests API)
│ GET /api/v1/contests
▼
build.mjs ──▶ index.html(締切ボード)
ポイントは、正典は今までどおり手元の Markdown にしたことです。microCMS は「人間が見る・ちょっと直す」ための場所、という役割分担にしました。
1. API を作る
管理画面で「サービスを作成」→ サービス ID を koubo-board にして、リスト形式の API contests を作りました。フィールドは次の 7 つです。
| フィールドID | 種類 | 中身 |
|---|---|---|
| slug | テキスト(重複不可) | フォルダ名。1231-qiita-adc-microcms など |
| name | テキスト | 公募名 |
| due | 日時 | 締切 |
| dueLabel | テキスト | 締切の書き方(「毎週金曜 23:59 米東部」など原文のまま) |
| state | セレクト | todo / doing / waiting / deciding / submitted / result / skipped |
| nextStep | テキストエリア | 次の一手 |
| url | テキスト | 公式ページ |
あとで作り直せるように、スキーマは JSON に書き出してリポジトリに置いています(API 設定の「スキーマのエクスポート/インポート」で読み込めます)。
最初は dueLabel を作っていませんでした。ところが公募の締切は「1/10 00:59(JST)」「毎週金曜 23:59 米東部」「記事をカレンダーに紐付ける期限」など、日時 1 つでは言い表せないものが多く、due だけだと情報が落ちます。並べ替え用の due と、人間が読む用の dueLabel を分けたのが最初の工夫です。
2. status.md → JSON
status.md の先頭はこんな形です。
---
name: Qiita Advent Calendar 2026 microCMS
due: 2026-12-31T23:59
due_label: 12/31(記事をカレンダーに紐付ける期限)
state: 作業中
human:
recommend: 出す。microCMS で作った小さなサイトの記事
---
これを読んで、microCMS に入れる形の JSON にするスクリプトを書きました(Claude Code に書いてもらい、私が読んで直しました)。
const STATE = {
'未着手': 'todo', '作業中': 'doing', '本人待ち': 'waiting', '判断待ち': 'deciding',
'提出済': 'submitted', '提出済み': 'submitted', '結果待ち': 'result', '見送り': 'skipped',
};
function toIso(due) {
// "2026-12-31T23:59" や "2026-12-31" を JST として ISO 8601 にする
const m = due && due.match(/^(\d{4})-(\d{2})-(\d{2})(?:T(\d{2}):(\d{2}))?/);
if (!m) return null;
const [, y, mo, d, h = '23', mi = '59'] = m;
return new Date(`${y}-${mo}-${d}T${h}:${mi}:00+09:00`).toISOString();
}
ここで 2 つつまずきました。
-
タイムゾーン: 日時フィールドは ISO 8601 で入れます。
2026-12-31T23:59をそのまま渡すと、どの時刻として扱われるかがあいまいになります。手元のメモはすべて日本時間なので、+09:00を付けてから UTC に直して渡すようにしました。 - 表記ゆれ: 409 件を流してみると「提出済」と「提出済み」が混ざっていました。AI が書いた記録でもゆれは出ます。セレクトフィールドは決めた値しか入らないので、ここで変換表を通すことで、ゆれが microCMS 側に持ち込まれなくなりました。CMS のスキーマが「入口の検査」になってくれたのは、思っていなかった利点です。
実行するとこうなります。
$ node export.mjs ../.. contests.json
409 件を contests.json に書いた {
todo: 38, submitted: 115, result: 5, waiting: 46, doing: 102, skipped: 103
}
3. 入稿は MCP で AI に任せる
microCMS には MCP サーバーがあります。今回は手元で動く microcms-mcp-server を Claude Code につなぎました(今後はmicroCMSがホストするリモート MCP サーバーが推奨とのことなので、次はそちらを試したいです)。
{
"mcpServers": {
"microcms": {
"command": "npx",
"args": ["-y", "microcms-mcp-server@0.12.0"],
"env": {
"MICROCMS_SERVICE_ID": "koubo-board",
"MICROCMS_API_KEY": "<管理画面で作ったAPIキー>"
}
}
}
}
API キーは、管理画面の「APIキー」で contests への GET・POST・PATCH だけを許したものを作りました。AI に渡す鍵は、できることを絞っておくと安心です。
Claude Code にはこう頼みました。
contests.json を読んで、microCMS の contests に下書きとして入れて。slug が同じものが既にあれば、新しく作らずに中身を更新して。
Claude Code はまず microcms_get_api_info で contests のスキーマを確かめ、microcms_get_list で既存の slug を取ってから、新しいものは microcms_create_contents_bulk_draft でまとめて下書き作成、既にあるものは microcms_update_content_draft で更新、という順番で進めました。私が手順を指定したわけではなく、「スキーマを見てから入れる」「重複を避ける」を AI が自分で選んだのが面白かったところです。
下書きで入れた理由
いきなり公開で入れず、下書きで入れるようにしました。AI が入れた 409 件を、管理画面の一覧で目で見てから公開したかったからです。実際、一覧を見ると「締切が 2026 年なのに 2027 年で入っている」ものが 1 件見つかりました(元の status.md の書き間違いでした)。管理画面で直してから、公開は「下書きを全部公開にして」と頼んで microcms_patch_content_status で切り替えてもらいました。
AI に書かせる → 人間が管理画面で見る → 公開、という流れは、microCMS の「下書き」と「公開」が分かれているからこそ自然に作れました。
MCP で困ったこと
- 400 件を一度に頼むと、AI が途中で件数を数え間違えることがありました。50 件ずつに分けて、毎回
microcms_get_list_metaで総数を確かめてもらうようにしたら安定しました。 - セレクトフィールドは配列で渡す必要があります(
"state": ["doing"])。最初は文字列で渡してエラーになり、AI がエラー文を読んで自分で直しました。
4. 締切ボードを作る
表示側は、依存パッケージなしの Node スクリプト 1 本です。コンテンツ API から「締切がまだ先で、まだ出していないもの」を締切順に取り、7日以内・30日以内・90日以内・それより先に分けて HTML にします。
const now = new Date().toISOString();
const q = new URLSearchParams({
limit: '100', offset: String(offset), orders: 'due',
filters: `due[greater_than]${now}`,
fields: 'id,name,due,dueLabel,state,nextStep,url',
});
const res = await fetch(`${base}/api/v1/contests?${q}`, {
headers: { 'X-MICROCMS-API-KEY': key },
});
使ったのは次の 4 つです。
-
orders=dueで締切順 -
filters=due[greater_than]<今>で締切が過ぎたものを落とす -
fieldsで要る項目だけ取る -
limit=100とoffsetで 100 件ずつ取り、totalCountまで繰り返す
状態(出した・見送った)でも filters で絞れますが、「まだ出していない」は 4 つの値の OR になるので、今回は締切だけを API で絞り、状態は受け取ってから JS で落としました。
結果、409 件のうち 186 件 が「締切前で、まだ出していない」ものとして残りました。
7日以内 7件
30日以内 42件
90日以内 83件
それより先 54件
「本人待ち」(私が手を動かさないと進まないもの)は背景を黄色にしています。スマホでこのページを開くと、今週自分がやるべきものが一目でわかるようになりました。
API キーなしで試せるようにした
開発中に何度も本物の API を叩くのは気が引けたので、GET /api/v1/contests の limit・offset・orders・filters(due[greater_than] だけ)を真似る小さなモックサーバーも書きました。キーが違うと 401 を返すところまで真似ています。MICROCMS_BASE_URL を差し替えるだけで、本物とモックを行き来できます。
node mock-server.mjs contests.json 8787 &
MICROCMS_BASE_URL=http://127.0.0.1:8787 MICROCMS_API_KEY=mock-key node build.mjs
やってみてわかったこと
- 正典を CMS に移さなくてもいい。 手元の Markdown を正典のままにして、microCMS は「見る・直す」場所にしたことで、AI の作業の流れを何も変えずに済みました。
- スキーマが AI の書いたデータの検査になる。 セレクトや日時の型があるので、表記ゆれや形式の違いが入口で止まります。
- 下書き → 公開の 2 段階は、AI に入稿させるときにちょうどいい。 AI が入れたものを人間が確かめる「間」が、仕組みとして最初からあります。
- MCP は、件数を区切って確かめさせると安定する。 大量入稿では「50 件ずつ・毎回総数を確認」が効きました。
おわりに
初めての microCMS でしたが、API を作ってから締切ボードが出るまで、半日もかかりませんでした。次は、microCMS の Webhook で公開のたびにボードを作り直し、締切 3 日前のものを通知するところまでやってみたいです。
コード(export.mjs・build.mjs・mock-server.mjs・スキーマ JSON)は 1 フォルダ・依存なしで動くので、「たくさんの締切を管理したい」人のたたき台になればうれしいです。