GASでキーワードからAIで
ブログ記事タイトル案を量産する方法

// スクリプトプロパティにAPIキーを保存（初回1回だけ実行）
function saveApiKey() {
  PropertiesService.getScriptProperties()
    .setProperty("CLAUDE_API_KEY", "sk-ant-xxxxxxxx");
}

function getApiKey() {
  const key = PropertiesService.getScriptProperties().getProperty("CLAUDE_API_KEY");
  if (!key) throw new Error("APIキーが未設定です。saveApiKey を実行してください。");
  return key;
}

// キーワードを並べるシートと、案の数などの設定
const SHEET_NAME = "キーワード";
const IDEAS_PER_KEYWORD = 5; // 1キーワードあたりに作るタイトル案の数
const MAX_TITLE_LENGTH = 32; // 検索結果で省略されにくい目安の文字数

// シートを用意する（無ければ作り、見出し行を入れる）
// A列: キーワード / B列: 状態 / C列以降: タイトル案（案1, 案2, ...）
function getKeywordSheet() {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  let sheet = ss.getSheetByName(SHEET_NAME);
  if (!sheet) {
    sheet = ss.insertSheet(SHEET_NAME);
    const header = ["キーワード", "状態"];
    for (let i = 1; i <= IDEAS_PER_KEYWORD; i++) header.push("案" + i);
    sheet.appendRow(header);
  }
  return sheet;
}

// 1つのキーワードから、狙い別のタイトル案をまとめて受け取る
function generateTitles(keyword) {
  const instruction =
    "あなたはSEOに強い日本語のWeb編集者です。\n" +
    "次のキーワードで検索するユーザーがクリックしたくなる、" +
    "ブログ記事のタイトル案を" + IDEAS_PER_KEYWORD + "個作ってください。\n" +
    "キーワード: " + keyword + "\n" +
    "条件:\n" +
    "・各案は全角" + MAX_TITLE_LENGTH + "文字以内。\n" +
    "・キーワードを自然に含める。\n" +
    "・狙い(type)を変える（例: 初心者向けの網羅型 / 数字で具体化する型 / 疑問形で悩みに寄り添う型 / 手順を示す型）。\n" +
    "・誇大表現や事実と異なる断定は避ける。\n" +
    "余計な説明は出力せず、JSON配列だけを返してください。\n" +
    '形式: [{"type":"狙い","title":"タイトル"}]';

  const payload = {
    model: "claude-sonnet-4-20250514",
    max_tokens: 1024,
    messages: [{ role: "user", content: instruction }],
  };

  const res = UrlFetchApp.fetch("https://api.anthropic.com/v1/messages", {
    method: "post",
    contentType: "application/json",
    headers: {
      "x-api-key": getApiKey(),
      "anthropic-version": "2023-06-01",
    },
    payload: JSON.stringify(payload),
    muteHttpExceptions: true,
  });

  if (res.getResponseCode() !== 200) {
    throw new Error("API error: " + res.getContentText());
  }

  const responseText = JSON.parse(res.getContentText()).content[0].text;
  return JSON.parse(extractJson(responseText)); // [{type, title}, ...]
}

// レスポンスから [ ... ] の部分だけを取り出す（前後の余計な文字対策）
function extractJson(text) {
  const start = text.indexOf("[");
  const end = text.lastIndexOf("]");
  return text.slice(start, end + 1);
}

// シートを回して、未処理のキーワードだけタイトル案を作る
function generateAllTitles() {
  const sheet = getKeywordSheet();
  const values = sheet.getDataRange().getValues();

  let count = 0;
  for (let row = 1; row < values.length && count < 15; row++) { // 1回最大15件
    const keyword = String(values[row][0]).trim();
    const status = String(values[row][1]).trim();
    if (!keyword) continue;      // 空行はスキップ
    if (status === "完了") continue; // 生成済みはスキップ

    const ideas = generateWithRetry(keyword);

    // C列以降にタイトル案を書き込む（長い案には印を付ける）
    for (let i = 0; i < IDEAS_PER_KEYWORD; i++) {
      const idea = ideas[i];
      let cell = "";
      if (idea && idea.title) {
        const over = [...idea.title].length > MAX_TITLE_LENGTH ? " ⚠️長い" : "";
        cell = "[" + (idea.type || "案") + "] " + idea.title + over;
      }
      sheet.getRange(row + 1, 3 + i).setValue(cell);
    }
    sheet.getRange(row + 1, 2).setValue("完了"); // B列に状態を記録

    count++;
    Utilities.sleep(500); // 連続呼び出しの間隔を少し空ける
  }

  Logger.log(count + "件のキーワードでタイトル案を生成しました。");
}

// 一時的なAPIエラー時に最大3回まで再試行する
function generateWithRetry(keyword, maxRetry) {
  const limit = maxRetry || 3;
  for (let attempt = 1; attempt <= limit; attempt++) {
    try {
      return generateTitles(keyword);
    } catch (e) {
      Logger.log("試行" + attempt + "回目で失敗: " + e.message);
      if (attempt === limit) {
        return [{ type: "生成失敗", title: "" }];
      }
      Utilities.sleep(1000 * attempt); // 待ち時間を伸ばして再試行
    }
  }
}

// スプレッドシートを開いたときにカスタムメニューを追加する
function onOpen() {
  SpreadsheetApp.getUi()
    .createMenu("タイトル生成")
    .addItem("未処理のキーワードを一括生成", "generateAllTitles")
    .addToUi();
}