GASでClaude APIのWeb検索ツールで
最新情報を回答させる方法

// Web検索ツールの定義。これだけでAIがWebを検索できるようになる
const WEB_SEARCH_TOOL = {
  type: "web_search_20260209", // ツールのバージョン。対応モデルと対で決まる
  name: "web_search",
  max_uses: 5,                 // 1リクエストあたりの検索回数の上限（必須級）
};

// Claude APIを1回呼ぶ。tools に検索ツールを入れるだけ
const API_URL = "https://api.anthropic.com/v1/messages";
const MODEL = "claude-opus-4-8";

function callClaude(messages) {
  const apiKey = PropertiesService.getScriptProperties()
    .getProperty("ANTHROPIC_API_KEY");

  const payload = {
    model: MODEL,
    max_tokens: 4096,
    system:
      "あなたは調査アシスタントです。最新の情報が必要な質問には、" +
      "記憶で答えず必ずWeb検索してから回答してください。" +
      "分からないことは分からないと答えてください。",
    tools: [WEB_SEARCH_TOOL],
    messages: messages,
  };

  const res = UrlFetchApp.fetch(API_URL, {
    method: "post",
    contentType: "application/json",
    headers: {
      "x-api-key": apiKey,
      "anthropic-version": "2023-06-01",
    },
    payload: JSON.stringify(payload),
    muteHttpExceptions: true, // エラーを例外にせず、自分でコードと本文を確認する
  });

  const code = res.getResponseCode();
  if (code !== 200) {
    throw new Error("Claude API エラー(" + code + "): " + res.getContentText());
  }
  return JSON.parse(res.getContentText());
}

// Web検索が走ったときのレスポンス例（抜粋）
{
  "stop_reason": "end_turn",
  "content": [
    { "type": "text", "text": "調べます。" },
    {
      "type": "server_tool_use",       // ← AIが実行した検索（クエリが見える）
      "id": "srvtoolu_01...",
      "name": "web_search",
      "input": { "query": "Claude API 最新モデル 2026" }
    },
    {
      "type": "web_search_tool_result", // ← 検索結果。ここに出典が入る
      "tool_use_id": "srvtoolu_01...",
      "content": [
        {
          "type": "web_search_result",
          "url": "https://example.com/blog/...",
          "title": "○○を発表しました"
        }
      ]
    },
    { "type": "text", "text": "検索結果によると..." } // ← 最終回答
  ]
}

// 回答テキストと出典URLを取り出す
function extractAnswer(res) {
  const text = res.content
    .filter((block) => block.type === "text")
    .map((block) => block.text)
    .join("");

  const sources = [];
  res.content
    .filter((block) => block.type === "web_search_tool_result")
    .forEach((block) => {
      // 成功時は配列、エラー時は error_code を持つオブジェクトが入る
      if (!Array.isArray(block.content)) {
        Logger.log("検索エラー: " + block.content.error_code);
        return;
      }
      block.content.forEach((result) => {
        sources.push({ title: result.title, url: result.url });
      });
    });

  return { text: text, sources: sources };
}

// pause_turn に対応した呼び出しループ
const MAX_CONTINUATIONS = 3; // GASの6分制限を意識して上限を決める

function research(question) {
  const messages = [{ role: "user", content: question }];

  for (let i = 0; i <= MAX_CONTINUATIONS; i++) {
    const res = callClaude(messages);

    if (res.stop_reason !== "pause_turn") {
      return extractAnswer(res); // 完了
    }

    // 中断された場合は、AIの発言をそのまま履歴に積んで再送するだけ。
    // 「続けて」などのメッセージを足してはいけない。
    messages.push({ role: "assistant", content: res.content });
  }

  throw new Error("再開の上限に達しました。質問を分けてください。");
}

// 情報源を絞り、暴走を防ぐ設定
const WEB_SEARCH_TOOL = {
  type: "web_search_20260209",
  name: "web_search",
  max_uses: 3,
  // 信頼できるドメインだけに絞る（blocked_domains とは併用できない）
  allowed_domains: [
    "anthropic.com",
    "developers.google.com",
  ],
  // 地域を伝えると、ローカル情報の精度が上がる
  user_location: {
    type: "approximate",
    country: "JP",
    timezone: "Asia/Tokyo",
  },
};

// スプレッドシートの調査リストを一括で処理する
// A列: 調査したいこと / B列: 回答 / C列: 出典
function researchSheet() {
  const sheet = SpreadsheetApp.getActive().getSheetByName("調査");
  const rows = sheet.getDataRange().getValues();
  const start = Date.now();

  for (let i = 1; i < rows.length; i++) {
    if (!rows[i][0]) continue;      // 質問が空の行は飛ばす
    if (rows[i][1]) continue;       // 調査済みの行は飛ばす（再実行に強くする）

    // 6分制限の手前で安全に打ち切る。残りは次回のトリガーに任せる
    if (Date.now() - start > 4 * 60 * 1000) {
      Logger.log("時間切れのため中断しました。次回の実行で続きから処理します。");
      return;
    }

    try {
      const result = research(rows[i][0]);
      sheet.getRange(i + 1, 2).setValue(result.text);
      sheet.getRange(i + 1, 3).setValue(
        result.sources.map((s) => s.url).join("\n")
      );
    } catch (e) {
      sheet.getRange(i + 1, 2).setValue("エラー: " + e.message);
    }
    SpreadsheetApp.flush(); // 途中で止まっても、ここまでの結果を確実に残す
  }
}