株式会社デイワンの月森です。
自社のオウンドメディアは microCMS で動いていて、記事は約240本あります。
この数か月、記事の下書き・既存記事の手直し・FAQ や誘導の欄の書き換え・画像の片付けを、管理画面ではなくほぼ API で行ってきました。
記事の本文や図は AI の担当を分けて作り、microCMS への出し入れは小さな Python の道具に任せています。
microCMS は API がまっすぐで、数百本を道具で回す使い方にもよく応えてくれました。
ここでは、その回し方と、API で運用するときに押さえておくと楽になる点をまとめます。
全体の回し方
道具は1本の Python のスクリプトで、サブコマンドに分けています。
| コマンド | すること |
|---|---|
| html | 手元の本文ファイルを microCMS 用の HTML にし、本文の文字が一致するかだけ確かめる |
| upload | アイキャッチと本文の画像をメディアに上げる（上げ済みは飛ばす） |
| create | 同じ ID の記事が無いことを確かめてから、下書きを作る |
| update | 管理画面で直されていないことを確かめてから、下書きを直す |
| verify | 読み戻して、公開されていないことと本文の一致を確かめる |
| pull / status | 公開版を手元に控え、控えから変わっていないかを見る |
| fix | 公開版の本文の決まった文字だけを置き換える（小さな手入れ） |
| revise | 公開版はそのままで、直しを下書きとして重ねる（大きな手直し） |
外に書き込むのは --go を付けたときだけにしています。
付けなければ、何を送るかを表示して止まります。
下書きまでを道具で、公開は人で
道具が作るのは下書きまでで、公開は人が管理画面で押しています。
API で下書きの記事に更新を送っても公開には切り替わらなかったので、この分け方にしました。
結果として、公開の前に必ず人の目が入る形になり、AI が書いた本文を数十本同時に作るときの安心材料になっています。
入れたら読み戻す
一番効いたのは、「入れたら読み戻す」を道具に組み込んだことです。
下書きを作ったら、本文の文字と、見出し・表・画像などの数が手元と一致するかを毎回確かめます。
AI に本文を書かせて数十本を同時に作っても崩れなかったのは、この読み戻しのおかげです。
押さえておく点
API で回すうえで、知っておくと最初から避けられる点です。
- キーを2本使い分ける。 書き込み用のキーで読むと、下書きがある記事は下書きの中身が返ります。公開版を確かめるときは読み取りだけのキーを使います。下書きしかない記事はこのキーで 404 になるので、「まだ公開されていない」の確認にも使えます。
- 埋め込みのカードに注意する。 管理画面で URL を貼って作った埋め込みのカード（iframely）は、本文を API で保存し直すと消えました。手直しの道具は、埋め込みのある記事を見つけたら止まるようにしています。
-
装飾は入れ子の順に頼らない。 リンクを独自のクラスの
spanで囲む装飾は、API で保存するとspanとaの順が入れ替わり、CSS が当たらなくなる所がありました。 - 画像の片付けは参照を確かめてから。 下書きを作り直すたびに使わない画像がメディアに残るので、管理 API のメディアの削除で片付けています。消す前に、すべての API の全件（下書きを含む）に画像の URL が出てこないことを確かめ、消したあとは本番のページで画像が表示されることを確かめます。
- 管理 API には User-Agent を付ける。 付けないと 403 で弾かれることがありました。
おわりに
管理画面で1本ずつ直していた作業の多くは、下書き・読み戻し・人の公開という分担で、道具に任せられるようになりました。
これから API で記事を回す方の参考になればうれしいです。