GASで住所データをAIで
都道府県・市区町村に自動分割する方法

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

function getApiKey() {
  const key = PropertiesService.getScriptProperties()
    .getProperty("CLAUDE_API_KEY");
  if (!key) throw new Error("CLAUDE_API_KEY が未設定です");
  return key;
}

// 住所の表記ゆれをAIに渡す前にそろえる
function normalizeAddress(value) {
  return String(value)
    .trim()
    // 全角英数字を半角へ
    .replace(/[Ａ-Ｚａ-ｚ０-９]/g, (s) =>
      String.fromCharCode(s.charCodeAt(0) - 0xfee0)
    )
    // 各種ハイフン・長音を半角ハイフンに統一
    .replace(/[−ー‐―－]/g, "-")
    // 連続する空白を1つに
    .replace(/[\s\u3000]+/g, " ");
}

// 住所の配列をまとめてClaude APIに渡し、分割結果を受け取る
function splitAddresses(addresses) {
  const prompt =
    "次の日本の住所を、都道府県・市区町村・それ以降（番地や建物名）に分割してください。\n" +
    "政令指定都市の区は市区町村に含めます。郡がある場合は市区町村に含めます。\n" +
    "入力順を保ったまま、次の形式のJSON配列だけを返してください。前後に説明文は不要です。\n" +
    '[{"pref":"都道府県","city":"市区町村","rest":"それ以降"}]\n\n' +
    "住所リスト:\n" +
    addresses.map((a, i) => (i + 1) + ". " + a).join("\n");

  const payload = {
    model: "claude-sonnet-4-20250514",
    max_tokens: 1500,
    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 エラー: " + res.getContentText());
  }

  const text = JSON.parse(res.getContentText()).content[0].text;
  return extractJsonArray(text);
}

// レスポンスから配列部分だけを安全に取り出す
function extractJsonArray(text) {
  const start = text.indexOf("[");
  const end = text.lastIndexOf("]");
  if (start === -1 || end === -1) {
    throw new Error("JSON配列が見つかりません: " + text);
  }
  return JSON.parse(text.substring(start, end + 1));
}

// 47都道府県リストで妥当性を簡易チェック
const PREFS = [
  "北海道","青森県","岩手県","宮城県","秋田県","山形県","福島県",
  "茨城県","栃木県","群馬県","埼玉県","千葉県","東京都","神奈川県",
  "新潟県","富山県","石川県","福井県","山梨県","長野県","岐阜県",
  "静岡県","愛知県","三重県","滋賀県","京都府","大阪府","兵庫県",
  "奈良県","和歌山県","鳥取県","島根県","岡山県","広島県","山口県",
  "徳島県","香川県","愛媛県","高知県","福岡県","佐賀県","長崎県",
  "熊本県","大分県","宮崎県","鹿児島県","沖縄県",
];

function checkResult(r) {
  return r && PREFS.indexOf(r.pref) !== -1 && r.city;
}

// A列: 住所 / B列: 都道府県 / C列: 市区町村 / D列: それ以降 / E列: 状態
function runAddressSplit() {
  const sheet = SpreadsheetApp.getActive().getSheetByName("住所");
  const last = sheet.getLastRow();
  if (last < 2) return;

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

  for (let i = 0; i < values.length; i += BATCH) {
    // 未処理（E列が空）で住所がある行だけを集める
    const chunk = [];
    for (let j = i; j < Math.min(i + BATCH, values.length); j++) {
      if (values[j][0] && !values[j][4]) {
        chunk.push({ row: j, address: normalizeAddress(values[j][0]) });
      }
    }
    if (chunk.length === 0) continue;

    try {
      const results = splitAddresses(chunk.map((c) => c.address));
      chunk.forEach((c, idx) => {
        const r = results[idx] || {};
        const rowNum = c.row + 2;
        sheet.getRange(rowNum, 2).setValue(r.pref || "");
        sheet.getRange(rowNum, 3).setValue(r.city || "");
        sheet.getRange(rowNum, 4).setValue(r.rest || "");
        sheet.getRange(rowNum, 5).setValue(checkResult(r) ? "完了" : "要確認");
      });
    } catch (e) {
      Logger.log("バッチ失敗(" + i + "): " + e.message);
    }

    Utilities.sleep(1000); // レート制限対策
  }
}

// 毎日深夜に未処理の住所だけを自動で分割する
function createDailyTrigger() {
  ScriptApp.newTrigger("runAddressSplit")
    .timeBased()
    .everyDays(1)
    .atHour(2)
    .create();
}