ChatGPTやCodexで作った記事JSONをAirtableへ安全に登録する方法

ChatGPTやCodexが作ったJSONは、そのまま一括投入せず、 項目定義を固定 → JSON検証 → 1件だけ登録 → record IDで再取得 → 静的サイトを再生成 → 公開URL確認 の順に進めると事故を減らせます。

Airtableの表示名だけに依存せず、連携では安定したfield ID・record IDを使います。認証情報は記事JSONやログに混ぜません。

AIは構造化データの草案作成に向きますが、Airtable側にはフィールド型、リンク、選択肢、API上限があります。文章生成の成功とCMS登録の成功は分けて判定します。Web APIの一覧取得はページ分割され、API呼び出しにも上限があるため、全件処理はページング・バッチ・再試行を含めて設計します。

・必須項目：title、slug、article_type、content_group、本文、公開状態

・関係項目：ジャンル、カテゴリー、シリーズ、タグ、参照元

・品質項目：検索意図、冒頭回答、根拠確認日、品質スコア

・運用項目：重複判定、統合先、更新メモ

単一選択・複数リンク・長文などの型を先に記録し、AIにはその型だけを出力させます。

・表示名変更で連携が壊れる

・配列と文字列が混ざり、リンク項目が空になる

・slug重複で既存記事を上書きする

・API上限超過後の一部失敗を見落とす

・登録後の静的生成・公開URL確認を省く

・対象テーブルのfield IDと型を取得する

・AI出力をJSON Schemaまたは同等の検証規則で確認する

・slugと検索意図の重複を既存記事一覧で照合する

・下書き状態で1件だけ登録する

・返却されたrecord IDで再取得し、リンク・選択肢・改行を確認する

・問題なければ小さなバッチで続行する

・静的データを再生成し、代表URLをPC・モバイルで確認する

登録前に「作成・更新・スキップ」の件数と対象slugを表示し、実行後は成功・失敗・record IDを記録します。再実行時はslugだけで決めず、record IDと更新条件を使うと誤更新を減らせます。大量投入より、10件以下の小さな単位で確認する方が原因を追いやすくなります。

・article\_typeがnormal/3Qの方針と一致

・ジャンル・カテゴリー・シリーズは各1件

・タグがカテゴリー名の重複ではなく横断語になっている

・参照元2〜4件と確認日が入っている

・検索用ダミー動画が残っていない

・アフィリエイトなしの記事に購入リンクが混入していない

Airtableのセル表示だけで完了にしません。生成済みJSON、記事HTML、canonical、OGP、分類導線、動画カード、参照元カードを公開側で確認します。登録値と表示値が違う場合は、CMS変換処理を先に直し、記事ごとの上書きを増やさないことが重要です。

工程

合格条件

失敗時

生成

定義したキーだけを出力

プロンプト・スキーマを修正

検証

型・必須・slug重複が0件

登録しない

登録

record IDを取得

再試行前に重複確認

再取得

リンクと選択肢が一致

型変換を修正

公開

代表URLの表示・操作が正常

静的生成処理を修正

一度に何件入れるべき？

最初は1件、次に小さなバッチです。上限内でも全件一括は原因切り分けが難しくなります。

field IDは必須？

表示名でも扱える場面はありますが、名前変更の影響を避ける連携ではID基準が安全です。

AIに認証情報を渡してよい？

記事JSONへ埋め込まず、環境変数や権限を絞った認証で分離します。

安全な自動化の単位は「JSONを作る」ではなく、 Airtable登録から静的ページ表示までを1件で往復確認できること です。スキーマ・ID・差分・再取得・公開確認を固定してから件数を増やしてください。

• Airtable API limits

  Web APIは原則1ベース毎秒5リクエスト。429時の待機と再試行、バッチ処理を前提に設計する。

  公式情報 / 2026-07-14
• Airtable IDs

  ベース・テーブル・ビュー・レコードの安定したIDを確認し、表示名の変更に依存しない連携に使える。

  公式情報 / 2026-07-14
• Airtable Web API

  JSONベースのWeb APIでレコードの取得・作成・更新ができ、一覧取得は1ページ最大100件。認証はPersonal access tokenまたはOAuthを使う。

  公式情報 / 2026-07-14
• OpenAI公式｜Codex CLI

  Codex CLIはローカルのコードを確認・編集しコマンドを実行できるため、作業範囲と差分を人が確認する前提で使う。

  公式情報 / 2026-07-14