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;
}

// 氏名の配列を渡し、ふりがなの配列を受け取る
function fetchFurigana(names) {
  const prompt =
    "次の日本人の氏名それぞれに、ひらがなの読み仮名を付けてください。\n" +
    "姓と名の読みを分け、最も自然な読み方を1つ選んでください。\n" +
    "余計な説明は出力せず、JSON配列だけを返してください。\n" +
    "形式: [{\"index\":0,\"sei\":\"やまだ\",\"mei\":\"たろう\"}]\n\n" +
    "氏名リスト:\n" +
    names.map((n, i) => i + ": " + n).join("\n");

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

  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 text = JSON.parse(res.getContentText()).content[0].text;
  return JSON.parse(extractJson(text));
}

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

// A列=氏名 / B列=せい / C列=めい を想定
function generateFuriganaAll() {
  const sheet = SpreadsheetApp.getActive().getSheetByName("名簿");
  const last = sheet.getLastRow();
  if (last < 2) return;

  const values = sheet.getRange(2, 1, last - 1, 3).getValues();
  const BATCH = 20;

  // ふりがな未入力の行だけを対象にする
  const targets = [];
  values.forEach((row, i) => {
    const name = String(row[0]).trim();
    const done = String(row[1]).trim() !== "";
    if (name && !done) targets.push({ rowIndex: i, name: name });
  });

  for (let s = 0; s < targets.length; s += BATCH) {
    const chunk = targets.slice(s, s + BATCH);
    const result = fetchFuriganaWithRetry(chunk.map((t) => t.name));

    result.forEach((r) => {
      const target = chunk[r.index];
      if (!target) return;
      values[target.rowIndex][1] = r.sei || "";
      values[target.rowIndex][2] = r.mei || "";
    });

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

  sheet.getRange(2, 1, values.length, 3).setValues(values);
}

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

// シートを開いたときにカスタムメニューを追加する
function onOpen() {
  SpreadsheetApp.getUi()
    .createMenu("ふりがなツール")
    .addItem("未入力の行にふりがなを生成", "generateFuriganaAll")
    .addToUi();
}

// ひらがなを全角カタカナに変換する
function toKatakana(hiragana) {
  return String(hiragana).replace(/[\u3041-\u3096]/g, (ch) =>
    String.fromCharCode(ch.charCodeAt(0) + 0x60)
  );
}