GASでスプレッドシートの文章を
AIで校正・誤字脱字チェックする方法

// 一度だけ実行してAPIキーを安全に保存する
function saveApiKey() {
  // 実行後、この関数のキー文字列は削除しておく
  PropertiesService.getScriptProperties()
    .setProperty("ANTHROPIC_API_KEY", "sk-ant-xxxxxxxx");
}

// コードからはキー名で読み出す（直書きしない）
function getApiKey() {
  const key = PropertiesService.getScriptProperties()
    .getProperty("ANTHROPIC_API_KEY");
  if (!key) throw new Error("APIキーが未設定です。saveApiKeyを実行してください。");
  return key;
}

// 文章を校正し、校正後の文と指摘一覧をJSONで返す
// 戻り値: { corrected: "校正後の文", issues: [{ original, suggestion, reason }] }
function proofreadText(text) {
  const url = "https://api.anthropic.com/v1/messages";

  const prompt =
    "あなたは日本語のビジネス文書の校正者です。\n" +
    "次の文章の誤字脱字・変換ミス・不自然な表現・敬語の誤りを直してください。\n" +
    "・意味は変えず、最小限の修正にとどめる。\n" +
    "・下のJSON形式だけを出力し、前置きや注釈は書かない。\n" +
    "・修正が不要ならissuesは空配列にする。\n\n" +
    'JSON形式: {"corrected":"校正後の全文","issues":[{"original":"元の語句","suggestion":"修正案","reason":"理由"}]}\n\n' +
    "文章:\n" + text;

  const payload = {
    model: "claude-haiku-4-5",
    max_tokens: 1500,
    messages: [{ role: "user", content: prompt }]
  };

  const options = {
    method: "post",
    contentType: "application/json",
    headers: {
      "x-api-key": getApiKey(),
      "anthropic-version": "2023-06-01"
    },
    payload: JSON.stringify(payload),
    muteHttpExceptions: true // エラー時も例外にせずレスポンスを受け取る
  };

  const res = UrlFetchApp.fetch(url, options);
  const code = res.getResponseCode();
  if (code !== 200) {
    throw new Error("API エラー (" + code + "): " + res.getContentText());
  }

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

// 返答からJSON部分だけを取り出して読み込む
function parseResult(answer) {
  // いちばん外側の { ... } を抜き出す（前置きが混ざっても解析できる）
  const start = answer.indexOf("{");
  const end = answer.lastIndexOf("}");
  if (start === -1 || end === -1) {
    throw new Error("JSONが見つかりません: " + answer);
  }
  return JSON.parse(answer.substring(start, end + 1));
}

// 一時的なエラー時に少し待って再試行する
function proofreadWithRetry(text, maxRetry) {
  maxRetry = maxRetry || 3;

  for (let i = 0; i < maxRetry; i++) {
    try {
      return proofreadText(text);
    } catch (e) {
      // 最後の試行で失敗したら、そのまま呼び出し元に投げる
      if (i === maxRetry - 1) throw e;
      // 待ち時間を1秒・2秒・4秒と伸ばす（指数バックオフ）
      Utilities.sleep(1000 * Math.pow(2, i));
    }
  }
}

// A列の原文を校正し、B列に校正後・C列に指摘理由を書き込む
// シート構成: A=原文, B=校正後, C=指摘（Bが空の行だけ処理する）
function proofreadColumn() {
  const sheet = SpreadsheetApp.getActive().getSheetByName("校正");
  const lastRow = sheet.getLastRow();
  if (lastRow < 2) return; // データなし（1行目はヘッダー想定）

  // A(原文)・B(校正後)・C(指摘)をまとめて読み込む
  const rows = sheet.getRange(2, 1, lastRow - 1, 3).getValues();

  let count = 0;
  for (let i = 0; i < rows.length; i++) {
    const source = String(rows[i][0]).trim();
    const done = String(rows[i][1]).trim();

    if (!source) continue;   // 原文が空ならスキップ
    if (done) continue;      // すでに校正済みならスキップ

    let result;
    try {
      result = proofreadWithRetry(source);
    } catch (e) {
      // 解析やAPIで失敗した行は記録して次へ進む（全体は止めない）
      sheet.getRange(i + 2, 3).setValue("エラー: " + e.message);
      continue;
    }

    // 指摘一覧を1セルに読みやすく整形する
    const notes = (result.issues || [])
      .map(function (x) { return "・" + x.original + " → " + x.suggestion + "（" + x.reason + "）"; })
      .join("\n");

    sheet.getRange(i + 2, 2).setValue(result.corrected);        // B列: 校正後
    sheet.getRange(i + 2, 3).setValue(notes || "修正なし");      // C列: 指摘
    SpreadsheetApp.flush(); // 途中経過をすぐ画面に反映する

    count++;
    if (count >= 20) break;  // 1回20件までに区切る（実行時間制限対策）
    Utilities.sleep(300);    // 連続呼び出しの間隔をあける
  }
}

// シートを開いたときに校正メニューを追加する
function onOpen() {
  SpreadsheetApp.getUi()
    .createMenu("AI校正")
    .addItem("空の行を校正する", "proofreadColumn")
    .addToUi();
}