GASで名刺画像をAIで読み取り
スプレッドシートに自動登録する方法

// スクリプトプロパティに以下を保存しておく
//   ANTHROPIC_API_KEY : AnthropicのAPIキー
//   INBOX_FOLDER_ID   : 未処理の名刺画像を置くDriveフォルダのID
//   DONE_FOLDER_ID    : 処理済み画像の移動先フォルダのID
function getProp(name) {
  const value = PropertiesService.getScriptProperties().getProperty(name);
  if (!value) throw new Error(name + " が未設定です。");
  return value;
}

// フォルダIDは、Driveでフォルダを開いたときのURL末尾の文字列
// https://drive.google.com/drive/folders/【この部分】

// 未処理フォルダから画像ファイルだけを取り出す
// 1回の実行で扱う件数に上限を設け、6分の実行時間制限に収める
const MAX_FILES_PER_RUN = 15;

// Claude APIが受け取れる画像形式だけを対象にする
const SUPPORTED_TYPES = ["image/jpeg", "image/png", "image/gif", "image/webp"];

function listCardImages() {
  const folder = DriveApp.getFolderById(getProp("INBOX_FOLDER_ID"));
  const it = folder.getFiles();

  const files = [];
  while (it.hasNext() && files.length < MAX_FILES_PER_RUN) {
    const file = it.next();
    // 画像以外（メモやPDF）はスキップする
    if (SUPPORTED_TYPES.indexOf(file.getBlob().getContentType()) !== -1) {
      files.push(file);
    }
  }
  return files;
}

// 名刺画像そのものをClaude APIに渡し、項目をJSONで受け取る
function extractCard(file) {
  const url = "https://api.anthropic.com/v1/messages";

  const blob = file.getBlob();
  const mediaType = blob.getContentType();          // 例: "image/jpeg"
  const base64 = Utilities.base64Encode(blob.getBytes()); // 画像を文字列に変換

  const instruction =
    "添付の画像は名刺です。以下のJSONだけを出力してください。\n" +
    "前置きも説明文もコードブロックの記号も付けないでください。\n\n" +
    "{\n" +
    '  "company": "会社名",\n' +
    '  "name": "氏名",\n' +
    '  "kana": "氏名のふりがな。記載がなければ空文字",\n' +
    '  "department": "部署名",\n' +
    '  "title": "役職",\n' +
    '  "phone": "電話番号（TEL）",\n' +
    '  "mobile": "携帯番号",\n' +
    '  "fax": "FAX番号",\n' +
    '  "email": "メールアドレス",\n' +
    '  "website": "URL",\n' +
    '  "address": "住所",\n' +
    '  "confidence": "high | medium | low"\n' +
    "}\n\n" +
    "ルール:\n" +
    "・名刺に書かれていない項目は空文字 \"\" にする。推測で埋めない。\n" +
    "・TELと明記された番号を phone、FAXと明記された番号を fax に入れる。\n" +
    "・ラベルのない番号は phone に入れる。携帯番号は mobile に入れる。\n" +
    "・文字がかすれて読み取りに自信がない場合は confidence を low にする。";

  const payload = {
    model: "claude-haiku-4-5",
    max_tokens: 1000,
    messages: [{
      role: "user",
      content: [
        {
          type: "image",
          source: {
            type: "base64",
            media_type: mediaType,
            data: base64
          }
        },
        { type: "text", text: instruction }
      ]
    }]
  };

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

  if (res.getResponseCode() !== 200) {
    throw new Error("API エラー (" + res.getResponseCode() + "): " + res.getContentText());
  }

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

// AIの返答からJSONを取り出す
// 「JSONだけ」と指示しても前後に文が付くことがあるため、最初の { から最後の } までを拾う
function parseJson(text) {
  const start = text.indexOf("{");
  const end = text.lastIndexOf("}");
  if (start === -1 || end === -1) {
    throw new Error("JSONが見つかりません: " + text.slice(0, 200));
  }
  return JSON.parse(text.slice(start, end + 1));
}

// メールアドレスを照合用に正規化する（前後の空白を除き、小文字にそろえる）
function normalizeEmail(value) {
  return String(value || "").trim().toLowerCase();
}

// すでに登録済みのメールアドレスの集合を作る
// 名刺は同じ人から何度ももらうため、メールで重複を防ぐ
function loadKnownEmails(sheet) {
  const last = sheet.getLastRow();
  const known = {};
  if (last < 2) return known; // 見出し行だけなら空

  // メールアドレスは9列目（見出しの並びに合わせて調整する）
  const values = sheet.getRange(2, 9, last - 1, 1).getValues();
  values.forEach(function (row) {
    const email = normalizeEmail(row[0]);
    if (email) known[email] = true;
  });
  return known;
}

// 本体：名刺画像を1件ずつ読み取り、シートに登録して、処理済みへ移す
function importNameCards() {
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("名刺");
  const doneFolder = DriveApp.getFolderById(getProp("DONE_FOLDER_ID"));
  const files = listCardImages();
  const known = loadKnownEmails(sheet);

  files.forEach(function (file) {
    try {
      const data = extractCard(file);
      const email = normalizeEmail(data.email);

      // 同じメールがすでにあれば、登録せず処理済みへ移すだけ
      if (email && known[email]) {
        file.moveTo(doneFolder);
        return;
      }

      sheet.appendRow([
        new Date(),               // 取込日時
        data.company || "",       // 会社名
        data.name || "",          // 氏名
        data.kana || "",          // ふりがな
        data.department || "",    // 部署
        data.title || "",         // 役職
        data.phone || "",         // 電話
        data.mobile || "",        // 携帯
        data.email || "",         // メール（9列目：重複チェックのキー）
        data.fax || "",           // FAX
        data.website || "",       // URL
        data.address || "",       // 住所
        data.confidence || "",    // 確信度
        file.getUrl()             // 元画像へのリンク
      ]);

      if (email) known[email] = true; // 同じ実行内での二重登録も防ぐ
      file.moveTo(doneFolder);        // 登録に成功した画像だけ移動する

    } catch (e) {
      // 1件の失敗で全体を止めない。画像は未処理フォルダに残す
      console.error(file.getName() + ": " + e.message);
    }
  });
}

// 30分おきに importNameCards を自動実行する
// この関数は一度だけ手動で実行する（実行のたびに重複登録されるため）
function createCardTrigger() {
  ScriptApp.getProjectTriggers().forEach(function (t) {
    if (t.getHandlerFunction() === "importNameCards") {
      ScriptApp.deleteTrigger(t);
    }
  });

  ScriptApp.newTrigger("importNameCards")
    .timeBased()
    .everyMinutes(30)
    .create();
}

// 確信度が low の行だけ、後から目視で確認すればよい
// スプレッドシートの条件付き書式で confidence 列が "low" の行に色を付けておくと早い