GASで商品リストからAIで
商品説明文を自動生成する方法

// 一度だけ実行してAPIキーをスクリプトプロパティに保存する
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;
}

// Claude APIにテキストを送り、返答文字列を受け取る共通関数
function callClaude(prompt) {
  const url = "https://api.anthropic.com/v1/messages";
  const payload = {
    model: "claude-haiku-4-5", // 軽量・低コスト。精度重視なら claude-sonnet-5 に差し替え
    max_tokens: 1024,
    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 json = JSON.parse(res.getContentText());
  return json.content[0].text; // 生成されたテキスト本文
}

// 商品情報から、JSON形式で説明文一式を生成するプロンプトを作る
function buildPrompt(name, features, tone) {
  return [
    "あなたはECサイトの商品コピーライターです。",
    "以下の商品について、日本語の商品説明を作成してください。",
    "",
    "商品名: " + name,
    "特徴・スペック: " + features,
    "トーン: " + (tone || "丁寧でわかりやすく"),
    "",
    "次のJSON形式だけを出力してください（前後に説明文やコードブロックは不要）。",
    "{",
    '  "catch": "20文字以内のキャッチコピー",',
    '  "body": "150〜250文字の商品説明本文",',
    '  "points": ["特徴を表す短い箇条書きを3つ"]',
    "}",
    "",
    "事実にない機能・効能・数値は書かないでください。",
  ].join("\n");
}

// 返答からJSON部分だけを安全に取り出す
function parseResult(text) {
  const start = text.indexOf("{");
  const end = text.lastIndexOf("}");
  if (start === -1 || end === -1) throw new Error("JSONが見つかりません: " + text);
  return JSON.parse(text.slice(start, end + 1));
}

// シート全体を走査し、未生成の行だけ説明文を作る
// 列: A=商品名 B=特徴 C=トーン D=キャッチ E=説明本文 F=特徴3点
function generateDescriptions() {
  const sheet = SpreadsheetApp.getActive().getSheetByName("商品リスト");
  const values = sheet.getDataRange().getValues();

  for (let row = 1; row < values.length; row++) { // 0行目はヘッダー
    const name = values[row][0];
    const already = values[row][4]; // E列（説明本文）
    if (!name || already) continue; // 商品名なし or 生成済みはスキップ

    try {
      const prompt = buildPrompt(name, values[row][1], values[row][2]);
      const result = parseResult(callClaudeWithRetry(prompt));

      sheet.getRange(row + 1, 4).setValue(result.catch);          // D列
      sheet.getRange(row + 1, 5).setValue(result.body);           // E列
      sheet.getRange(row + 1, 6).setValue(result.points.join("\n")); // F列
    } catch (e) {
      sheet.getRange(row + 1, 5).setValue("生成失敗: " + e.message);
    }

    Utilities.sleep(500); // レート制限対策に短い待機
  }
}

// 一時的なエラー（429/5xx）に備えて数回リトライする
function callClaudeWithRetry(prompt, maxRetries) {
  const retries = maxRetries || 3;
  for (let i = 0; i < retries; i++) {
    try {
      return callClaude(prompt);
    } catch (e) {
      const transient = /(^|\s)(429|5\d\d)(\s|:)/.test(e.message);
      if (!transient || i === retries - 1) throw e;
      Utilities.sleep(1000 * (i + 1)); // 1秒→2秒→3秒と待機を延ばす
    }
  }
}

// スプレッドシートを開いたときにカスタムメニューを追加
function onOpen() {
  SpreadsheetApp.getUi()
    .createMenu("AI商品説明")
    .addItem("未生成の行を一括生成", "generateDescriptions")
    .addToUi();
}