GASで売上データをAIで分析し
要点コメントを自動生成する方法

// 「明細」シート: A列=日付, B列=金額 を月ごとに合計する
function aggregateMonthlySales() {
  const sheet = SpreadsheetApp.getActive().getSheetByName("明細");
  const rows = sheet.getRange(2, 1, sheet.getLastRow() - 1, 2).getValues();

  const totals = {}; // { "2026-05": 3200000, ... }
  rows.forEach(([date, amount]) => {
    if (!(date instanceof Date) || !amount) return;
    const ym =
      date.getFullYear() +
      "-" +
      String(date.getMonth() + 1).padStart(2, "0");
    totals[ym] = (totals[ym] || 0) + Number(amount);
  });

  // 月順に並べた配列で返す
  return Object.keys(totals)
    .sort()
    .map((ym) => ({ month: ym, total: totals[ym] }));
}

// 直近3か月を取り出し、前月比までGAS側で計算しておく
function buildRecentStats(monthly) {
  const recent = monthly.slice(-3); // 直近3か月
  return recent.map((cur, i) => {
    const prev = recent[i - 1];
    let growth = null;
    if (prev && prev.total > 0) {
      // 前月比(%)を小数第1位まで。計算はAIに任せない
      growth = Math.round(((cur.total - prev.total) / prev.total) * 1000) / 10;
    }
    return {
      month: cur.month,
      total: cur.total,
      growthPercent: growth, // 例: 12.5 / -4.3 / null
    };
  });
}

function generateSalesComment(stats) {
  const apiKey =
    PropertiesService.getScriptProperties().getProperty("CLAUDE_API_KEY");

  const prompt =
    "あなたはECサイトの売上分析担当です。以下は月次売上の集計データです。\n" +
    "数値の再計算はせず、渡した値だけを使って、経営者向けに要点を日本語で説明してください。\n" +
    "growthPercentは前月比(%)です。nullは比較対象なしを意味します。\n\n" +
    JSON.stringify(stats, null, 2) +
    "\n\n次のJSON形式のみを返してください（前後に文章を付けない）:\n" +
    '{"summary":"全体の要点を2文以内","highlight":"最も注目すべき点を1文","caution":"注意点があれば1文、なければ空文字"}';

  const res = UrlFetchApp.fetch("https://api.anthropic.com/v1/messages", {
    method: "post",
    contentType: "application/json",
    headers: {
      "x-api-key": apiKey,
      "anthropic-version": "2023-06-01",
    },
    payload: JSON.stringify({
      model: "claude-sonnet-4-5",
      max_tokens: 600,
      messages: [{ role: "user", content: prompt }],
    }),
    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));
}

// AIの返答から最初のJSON部分だけを取り出す保険
function extractJson(text) {
  const start = text.indexOf("{");
  const end = text.lastIndexOf("}");
  return text.slice(start, end + 1);
}

// 「月次サマリー」シート: A列=月, B列=売上, C列=要点, D列=注目点, E列=注意点
function updateMonthlySummary() {
  const monthly = aggregateMonthlySales();
  const stats = buildRecentStats(monthly);
  const target = stats[stats.length - 1]; // 最新月

  const sheet = SpreadsheetApp.getActive().getSheetByName("月次サマリー");
  const data = sheet.getDataRange().getValues();

  // すでにコメント済みの月はスキップ（二重生成防止）
  const done = data.some(
    (row) => row[0] === target.month && row[2]
  );
  if (done) {
    Logger.log(target.month + " は生成済みのためスキップ");
    return;
  }

  const comment = generateSalesComment(stats);
  sheet.appendRow([
    target.month,
    target.total,
    comment.summary,
    comment.highlight,
    comment.caution,
  ]);
}

// 毎月1日の午前8時に前月分のコメントを自動生成
function createMonthlyTrigger() {
  ScriptApp.newTrigger("updateMonthlySummary")
    .timeBased()
    .onMonthDay(1)
    .atHour(8)
    .create();
}