GASで画像をAIで解析し
alt属性を自動生成する方法

// スクリプトプロパティに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;
}

// 対象フォルダのIDと、結果を書き込むシートを設定する
const FOLDER_ID = "ここに画像フォルダのIDを貼る"; // フォルダURLの末尾の文字列
const SHEET_NAME = "alt一覧";

// 記録シートを用意する（無ければ作り、見出し行を入れる）
function getResultSheet() {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  let sheet = ss.getSheetByName(SHEET_NAME);
  if (!sheet) {
    sheet = ss.insertSheet(SHEET_NAME);
    sheet.appendRow(["ファイル名", "ファイルID", "alt属性", "キャプション", "確信度", "処理日時"]);
  }
  return sheet;
}

// 1枚の画像をClaude APIに渡し、altとキャプションを受け取る
function describeImage(file) {
  const blob = file.getBlob();
  const base64 = Utilities.base64Encode(blob.getBytes()); // 画像を文字列に変換
  const mimeType = blob.getContentType();                 // 例: image/jpeg

  const instruction =
    "あなたは画像の代替テキストを作る専門家です。\n" +
    "この画像について、次の3つを日本語で作ってください。\n" +
    "1) alt: 画面読み上げ用の簡潔な代替テキスト（40字以内、末尾に句点なし）\n" +
    "2) caption: もう少し詳しい説明文（80字以内）\n" +
    "3) confidence: 説明の確信度（high / medium / low）\n" +
    "画像から確実に読み取れることだけを書き、写っていないブランド名や固有名詞は推測しないでください。\n" +
    "余計な説明は出力せず、JSONだけを返してください。\n" +
    '形式: {"alt":"...","caption":"...","confidence":"high"}';

  const payload = {
    model: "claude-sonnet-4-20250514",
    max_tokens: 512,
    messages: [
      {
        role: "user",
        content: [
          { type: "image", source: { type: "base64", media_type: mimeType, data: base64 } },
          { type: "text", text: 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));
}

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

// フォルダ内の画像を順に処理し、シートに書き込む
function generateAltTexts() {
  const sheet = getResultSheet();
  const done = getProcessedIds(sheet); // 処理済みファイルIDの一覧
  const files = DriveApp.getFolderById(FOLDER_ID).getFiles();

  let count = 0;
  while (files.hasNext() && count < 20) { // 1回あたり最大20枚に絞る
    const file = files.next();
    const mime = file.getBlob().getContentType();

    if (mime.indexOf("image/") !== 0) continue; // 画像形式だけを対象にする
    if (done[file.getId()]) continue;           // 処理済みはスキップ

    const result = describeWithRetry(file);
    sheet.appendRow([
      file.getName(),
      file.getId(),
      result.alt || "",
      result.caption || "",
      result.confidence || "",
      new Date(),
    ]);
    count++;
    Utilities.sleep(500); // 連続呼び出しの間隔を少し空ける
  }

  Logger.log(count + "枚のalt属性を生成しました。");
}

// 既にシートに記録済みのファイルIDを集める
function getProcessedIds(sheet) {
  const values = sheet.getDataRange().getValues();
  const map = {};
  for (let i = 1; i < values.length; i++) {
    map[values[i][1]] = true; // B列 = ファイルID
  }
  return map;
}

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

// 毎日深夜に自動実行するトリガーを作る（初回1回だけ実行）
function createDailyTrigger() {
  ScriptApp.newTrigger("generateAltTexts")
    .timeBased()
    .atHour(2)    // 2〜3時の間に実行される
    .everyDays(1) // 毎日
    .create();
}