Googleスプレッドシート×ラッコキーワードAPIでメディア運営を効率化しよう！【初心者向け】

// ==========================================
// ラッコキーワードAPI 設定
// ==========================================
// 取得したAPIキーを以下の「YOUR_API_KEY_HERE」に置き換えてください。
const API_KEY = "YOUR_API_KEY_HERE";

/**
 * 関連キーワードを取得し、スプレッドシートに出力するメイン関数
 * （この関数をマクロとしてインポートします）
 */
function fetchRelatedKeywords() {
  const ui = SpreadsheetApp.getUi();

  // 1. キーワード入力のプロンプトを表示
  const promptResponse = ui.prompt(
    'ラッコキーワードAPI',
    '取得したい関連キーワードを入力してください:',
    ui.ButtonSet.OK_CANCEL
  );

  // キャンセルボタンが押された場合や、×ボタンで閉じた場合は終了
  if (promptResponse.getSelectedButton() !== ui.Button.OK) {
    return;
  }

  const inputKeyword = promptResponse.getResponseText().trim();
  if (!inputKeyword) {
    ui.alert('エラー', 'キーワードが入力されていません。', ui.ButtonSet.OK);
    return;
  }

  // 2. APIリクエストの設定
  // エンドポイント: 関連キーワード取得
  const apiUrl = 'https://api.rakkokeyword.com/v1/related-keywords';

  // 検索条件の指定
  const payload = {
    keyword: inputKeyword,
    sortBy: 'searchVolume', // 並び順: 月間検索数
    orderBy: 'desc',        // 並び順: 多い順（降順）
    limit: 100              // 取得件数: 100件
  };

  const options = {
    method: 'post',
    headers: {
      'X-API-Key': API_KEY,
      'Content-Type': 'application/json'
    },
    payload: JSON.stringify(payload),
    muteHttpExceptions: true // エラー時もレスポンスを受け取る設定
  };

  try {
    // 3. API通信の実行
    const response = UrlFetchApp.fetch(apiUrl, options);
    const responseCode = response.getResponseCode();
    const responseBody = JSON.parse(response.getContentText());

    // エラーハンドリング
    if (responseCode !== 200) {
      const errorMessage = responseBody.errors ? responseBody.errors.join(', ') : '不明なエラー';
      ui.alert('APIエラー', `通信に失敗しました。\nステータスコード: ${responseCode}\nエラー詳細: ${errorMessage}`, ui.ButtonSet.OK);
      return;
    }

    // 結果データアイテムの配列を取得
    const items = responseBody.data.items;

    if (!items || items.length === 0) {
      ui.alert('結果', '関連キーワードが見つかりませんでした。', ui.ButtonSet.OK);
      return;
    }

    // 4. スプレッドシートへの書き込み準備
    const outputData = [];
    // 1行目にヘッダーを追加
    outputData.push(['キーワード', '月間検索数']);

    // 取得したデータを配列に格納
    items.forEach(item => {
      const kw = item.keyword;
      // 月間検索数が取得できない場合(nullなど)は未定義表記にする
      const searchVolume = (item.metrics && item.metrics.searchVolume !== null) ? item.metrics.searchVolume : 'データなし';

      outputData.push([kw, searchVolume]);
    });

    // 5. スプレッドシートへの書き込み実行
    const sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
    sheet.clearContents(); // 現在のシートのデータをすべて消去（上書き準備）

    // 出力データのサイズに合わせて範囲を指定し、一括で書き込み
    sheet.getRange(1, 1, outputData.length, outputData[0].length).setValues(outputData);

    ui.alert('完了', 'データの取得と書き込みが完了しました！', ui.ButtonSet.OK);

  } catch (error) {
    ui.alert('システムエラー', '処理中にエラーが発生しました:\n' + error.message, ui.ButtonSet.OK);
  }
}

/**
 * スプレッドシートを開いたときに専用メニューを自動追加する関数（おまけ）
 * マクロからだけでなく、メニューバーからも1クリックで実行できるようにしています。
 */
function onOpen() {
  const ui = SpreadsheetApp.getUi();
  ui.createMenu('ラッコAPI実行')
    .addItem('関連キーワードを取得', 'fetchRelatedKeywords')
    .addToUi();
}

ラッコキーワードAPIの仕様に基づき、Google Apps Script（GAS）のコードを作成してください。

【やりたいこと】
ラッコキーワードAPIを使って、関連キーワードを取得し、スプレッドシートに出力したいです。

【データ取得における条件】
・取得件数：100件
・並び順：月間検索数が多い順

【スプレッドシートに出力する項目】
・キーワード
・月間検索数

【期待する動作】
・スクリプトを実行すると、画面にキーワードを入力する枠が表示される
・キーワードを入力するとデータを取得し、現在のシートの内容を上書きして結果を表示する
・1行目の見出し（ヘッダー）はスクリプトで自動的に作ってほしい
・GASはスプレッドシートのメニュー「マクロ」から実行できるようにする

【その他のお願い】
・APIキーを入れる場所は、コードの一番上に「YOUR_API_KEY_HERE」のように分かりやすく定義し、後ほど手動で書き換えやすいようにすること
・関数名や変数名などは、AI側で分かりやすいものにしてください

// ==========================================
// 設定項目
// ==========================================
// ラッコキーワードのAPIキーを設定してください
const RAKKO_API_KEY = "YOUR_API_KEY_HERE";

// ==========================================
// メイン処理（トリガー設定用）
// ==========================================
function fetchAndAppendSuggestKeywords() {
  try {
    const ss = SpreadsheetApp.getActiveSpreadsheet();

    // 先頭シート（デフォルトシート）を取得
    const inputSheet = ss.getSheets()[0];

    if (!inputSheet) {
      throw new Error("シートが存在しません。");
    }

    // A1セルのキーワードを取得
    const targetKeyword = inputSheet.getRange("A1").getValue();

    if (!targetKeyword) {
      throw new Error(
        `シート「${inputSheet.getName()}」のA1セルにキーワードを入力してください`
      );
    }

    // 「出力シート」を取得（存在しない場合は新規作成）
    let outputSheet = ss.getSheetByName("出力シート");

    if (!outputSheet) {
      outputSheet = ss.insertSheet("出力シート");
    }

    // 出力シートが空の場合はヘッダーを作成
    if (outputSheet.getLastRow() === 0) {
      outputSheet.appendRow([
        "取得日時",
        "検索キーワード",
        "サジェストキーワード",
        "サジェストクラス",
        "SEO難易度",
        "月間検索数",
        "出現時期"
      ]);
    }

    // 既存キーワード取得（C列）
    const lastRow = outputSheet.getLastRow();
    let existingKeywords = new Set();

    if (lastRow > 1) {
      const cValues = outputSheet
        .getRange(2, 3, lastRow - 1, 1)
        .getValues();

      existingKeywords = new Set(
        cValues.flat().filter(String)
      );
    }

    // APIリクエスト
    const payload = {
      keyword: String(targetKeyword),
      increaseKeyword: true,
      filter: {
        firstSeenRange: {
          include: "last_7_days"
        },
        searchVolume: {
          max: 10000
        }
      },
      sortBy: "firstSeenRange",
      orderBy: "desc",
      limit: 100
    };

    const options = {
      method: "post",
      headers: {
        "Content-Type": "application/json",
        "Accept": "application/json",
        "X-API-Key": RAKKO_API_KEY
      },
      payload: JSON.stringify(payload),
      muteHttpExceptions: true
    };

    const url = "https://api.rakkokeyword.com/v1/suggest-keywords";

    const response = UrlFetchApp.fetch(url, options);

    const statusCode = response.getResponseCode();
    const responseText = response.getContentText();

    if (statusCode !== 200) {
      throw new Error(
        `APIエラー: ステータスコード ${statusCode}\n${responseText}`
      );
    }

    const json = JSON.parse(responseText);

    if (!json.result) {
      throw new Error(
        `APIリクエストが失敗しました。\n${JSON.stringify(json.errors)}`
      );
    }

    const items = json?.data?.items || [];

    const rowsToAppend = [];

    const now = Utilities.formatDate(
      new Date(),
      Session.getScriptTimeZone(),
      "yyyy/MM/dd HH:mm:ss"
    );

    items.forEach(item => {
      const suggestKeyword = item.keyword;

      if (!existingKeywords.has(suggestKeyword)) {
        rowsToAppend.push([
          now,
          targetKeyword,
          suggestKeyword,
          item.suggestClass,
          item.metrics?.seoDifficulty ?? "",
          item.metrics?.searchVolume ?? "",
          item.metrics?.firstSeenRange ?? ""
        ]);

        existingKeywords.add(suggestKeyword);
      }
    });

    if (rowsToAppend.length > 0) {
      outputSheet
        .getRange(
          outputSheet.getLastRow() + 1,
          1,
          rowsToAppend.length,
          rowsToAppend[0].length
        )
        .setValues(rowsToAppend);

      Logger.log(
        `${rowsToAppend.length}件のデータを「出力シート」に追記しました。`
      );
    } else {
      Logger.log(
        "新しいサジェストキーワードはありませんでした（すべて重複、または条件に一致する結果が0件）。"
      );
    }

  } catch (e) {
    Logger.log(
      "スクリプトの実行中にエラーが発生しました: " + e.message
    );

    if (e.stack) {
      Logger.log(e.stack);
    }

    // トリガー実行履歴で「失敗」にする
    throw e;
  }
}

ラッコキーワードAPIの仕様に基づき、Google Apps Script（GAS）のコードを作成してください。

【やりたいこと】
ラッコキーワードAPIを使って「サジェストキーワード」を取得し、Googleスプレッドシートに自動で一括取得・追記する処理を実装したいです。トリガーでの定期実行を想定しています。

【データの取得条件】
・オプション：[キーワード増量オプションを使う]
・フィルタ：[出現時期7日以内]、[月間検索ボリューム10000以下]
・並び順：[出現時期の降順]

【検索キーワード】
・A1セルの値を検索キーワードとして使用してください

【出力結果について】
・別シート（「出力シート」という名前をつけて）に結果を出力してください
・既存のデータを上書きせず、一番最後の行の下に追記していってください
・すでに出力シートに存在するサジェストキーワードは除外し、重複して追記しないようにしてください

【出力する項目】
・A列：取得日時（yyyy/MM/dd HH:mm:ss）
・B列：検索キーワード（シートA1セルの値）
・C列：サジェストキーワード
・[D列：サジェスト区分]
・[E列：SEO難易度]
・[F列：月間検索数]
・[G列：出現時期]

【その他のお願い】
・APIキーを入れる場所は、コードの一番上に「YOUR_API_KEY_HERE」と分かりやすく定義してください

const API_KEY = "YOUR_API_KEY_HERE";

function runRewriteInfoFetch() {
  const ui = SpreadsheetApp.getUi();

  // 1. モーダルで入力を受け付ける
  const keywordPrompt = ui.prompt('リライト情報取得', 'キーワードを入力してください', ui.ButtonSet.OK_CANCEL);
  if (keywordPrompt.getSelectedButton() !== ui.Button.OK) return;
  const keyword = keywordPrompt.getResponseText().trim();
  if (!keyword) {
    ui.alert('キーワードが入力されていません。処理を中断します。');
    return;
  }

  const urlPrompt = ui.prompt('リライト情報取得', 'リライト対象記事のURLを入力してください', ui.ButtonSet.OK_CANCEL);
  if (urlPrompt.getSelectedButton() !== ui.Button.OK) return;
  const url = urlPrompt.getResponseText().trim();
  if (!url) {
    ui.alert('URLが入力されていません。処理を中断します。');
    return;
  }

  // 2. シートの準備（存在しなければ作成、存在すればクリア）
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const sheetNames = ["共起語", "LSI/PAA", "見出し抽出", "リライト対象記事"];
  const sheets = {};

  sheetNames.forEach(name => {
    let sheet = ss.getSheetByName(name);
    if (!sheet) {
      sheet = ss.insertSheet(name);
    } else {
      sheet.clear();
    }
    sheets[name] = sheet;
  });

  // APIリクエストの共通オプション
  const options = {
    method: "post",
    headers: {
      "Content-Type": "application/json",
      "Accept": "application/json",
      "X-API-Key": API_KEY
    },
    muteHttpExceptions: true
  };

  // --- ① 共起語 ---
  try {
    const coOccPayload = { keyword: keyword };
    const coOccRes = UrlFetchApp.fetch("https://api.rakkokeyword.com/v1/co-occurrence", {
      ...options,
      payload: JSON.stringify(coOccPayload)
    });

    sheets["共起語"].getRange("A1").setValue(keyword);
    if (coOccRes.getResponseCode() === 200) {
      const data = JSON.parse(coOccRes.getContentText()).data;
      if (data && data.items && data.items.length > 0) {
        const rows = data.items.map(item => [item.word]);
        sheets["共起語"].getRange(1, 2, rows.length, 1).setValues(rows);
      }
    }
  } catch (e) {
    sheets["共起語"].getRange("A2").setValue("取得エラー: " + e.message);
  }

  // --- ② LSI/PAA ---
  try {
    const otherPayload = { keyword: keyword };
    const otherRes = UrlFetchApp.fetch("https://api.rakkokeyword.com/v1/other-keywords", {
      ...options,
      payload: JSON.stringify(otherPayload)
    });

    sheets["LSI/PAA"].getRange("A1").setValue(keyword);
    if (otherRes.getResponseCode() === 200) {
      const data = JSON.parse(otherRes.getContentText()).data;
      if (data && data.items && data.items.length > 0) {
        const rows = data.items.map(item => {
          const typeLabel = item.type.toUpperCase();
          const text = item.type === "lsi" ? item.keyword : item.question;
          return [typeLabel, text];
        });
        sheets["LSI/PAA"].getRange(1, 2, rows.length, 2).setValues(rows);
      }
    }
  } catch (e) {
    sheets["LSI/PAA"].getRange("A2").setValue("取得エラー: " + e.message);
  }

  // --- ③ 見出し抽出 ---
  try {
    const headlinePayload = {
      keyword: keyword,
      lessCharacters: true, // 文字数1000未満のページを除外
      h1: true,
      h2: true,
      h3: true,
      h4: false, // h4タグを除外
      h5: false, // h5タグを除外
      h6: false, // h6タグを除外
      limit: 10  // 取得件数を上位10件
    };
    const headlineRes = UrlFetchApp.fetch("https://api.rakkokeyword.com/v1/headline", {
      ...options,
      payload: JSON.stringify(headlinePayload)
    });

    sheets["見出し抽出"].getRange("A1").setValue(keyword);
    if (headlineRes.getResponseCode() === 200) {
      const data = JSON.parse(headlineRes.getContentText()).data;
      if (data && data.items && data.items.length > 0) {
        const rows = [];
        data.items.forEach(pageItem => {
          const rank = pageItem.metrics.position + "位";
          const title = pageItem.page.title;
          if (pageItem.headlines && pageItem.headlines.length > 0) {
            pageItem.headlines.forEach(hl => {
              rows.push([rank, title, hl.level.toUpperCase(), hl.text]);
            });
          }
        });
        if (rows.length > 0) {
          sheets["見出し抽出"].getRange(1, 2, rows.length, 4).setValues(rows);
        }
      }
    }
  } catch (e) {
    sheets["見出し抽出"].getRange("A2").setValue("取得エラー: " + e.message);
  }

  // --- ④ リライト対象記事（スクレイピング） ---
  try {
    sheets["リライト対象記事"].getRange("A1").setValue(url);
    const html = UrlFetchApp.fetch(url, {muteHttpExceptions: true}).getContentText();

    // 不要なタグ（script, style）を除去
    let cleanHtml = html.replace(/<script\b[^<]*(?:(?!<\/script>)<[^<]*)*<\/script>/gi, "")
                        .replace(/<style\b[^<]*(?:(?!<\/style>)<[^<]*)*<\/style>/gi, "");

    // 見出しタグ(h1~h3)とその中のコンテンツ（次の見出しタグまたは終了タグまで）を抽出する正規表現
    const regex = /<h([1-3])[^>]*>(.*?)<\/h\1>([\s\S]*?)(?=<h[1-6][^>]*>|<\/body>|$)/gi;
    let match;
    const scrapeRows = [];

    while ((match = regex.exec(cleanHtml)) !== null) {
      let level = "h" + match[1];

      // HTMLタグを除去し、特殊文字をデコードしてプレーンテキスト化
      let headingText = decodeHtmlEntities(match[2].replace(/<[^>]+>/g, '').trim());
      // 本文からHTMLタグを除去し、連続する空白・改行を1つのスペースに圧縮
      let contentText = decodeHtmlEntities(match[3].replace(/<[^>]+>/g, '').replace(/\s+/g, ' ').trim());

      if (headingText || contentText) {
        scrapeRows.push([level, headingText, contentText]);
      }
    }

    if (scrapeRows.length > 0) {
      sheets["リライト対象記事"].getRange(1, 2, scrapeRows.length, 3).setValues(scrapeRows);
    } else {
      sheets["リライト対象記事"].getRange("B1").setValue("見出し（h1~h3）が取得できませんでした。");
    }
  } catch (e) {
    sheets["リライト対象記事"].getRange("A2").setValue("スクレイピングエラー: " + e.message);
  }

  ui.alert('処理が完了しました！各シートをご確認ください。');
}

// 簡単なHTMLエンティティデコード関数
function decodeHtmlEntities(text) {
  if (!text) return "";
  return text.replace(/&amp;/g, '&')
             .replace(/&lt;/g, '<')
             .replace(/&gt;/g, '>')
             .replace(/&quot;/g, '"')
             .replace(/&#39;/g, "'")
             .replace(/&nbsp;/g, ' ');
}

添付したGoogleスプレッドシートのデータを分析して、検索上位を狙える「記事のリライト案」を作成してください。

【やりたいこと】
今の記事の自然な流れや良いところは残しつつ、足りない情報を追加して、読者の疑問をしっかり解決できる記事に書き直したいです。

【入力データについて】
添付したGoogleスプレッドシート内にある、以下のデータを使って分析してください。

・現在の記事データ：リライト対象記事シート
・APIで抽出したデータ：共起語、LSI/PAA、見出し抽出シート

【リライトについて】
以下手順で実施してください

①2つのデータを比べて「今の記事に足りないけれど、絶対に書くべき重要なトピック」を見つけ出す
②見つけ出したトピックをもとに見出し（h2、h3）を追加・修正する
③②で追加・修正した見出しの本文を生成する

既存の記事の文章で活かせる部分は残しつつ、新しく追加する情報とスムーズに繋がるよう、全体の文脈や表現を整えてください。

【出力結果について】
以下の順番と形式で出力してください。

①分析まとめ
今の記事に何が足りなかったのか、どのような意図で要素や文章を追加・修正したのかを簡単に解説してください。

②リライト後の記事（構成＋文章）
1.新しく追加・修正した見出しについて
・見出し前には必ず（h1～h3）をつけて作成してください
2.既存の文章について
・追加や修正が必要ない場合は全文出力せず、[既存の文章]と出力してください

新しく追加・修正した見出しや文章の箇所が一目でわかるように「✨新規追加」マークをつけてください

【その他のお願い】
・ライバルサイトが書いているトピックや、読者のよくある疑問は必ず網羅し、読者が納得できる丁寧な文章で解説してください。

ラッコキーワードAPI仕様に基づき、Google Apps Script（GAS）のコードを作成してください。

【やりたいこと】
記事のリライトに使う情報を、まとめてGoogleスプレッドシートに取得したいです。

【GAS実行時のルール】
実行時は以下をモーダル入力できるようにしてください。
・キーワード
・リライト対象記事のURL
GASを実行する前に必ず既存シートのデータをクリアしてください。

【取得・出力したい内容】
①共起語
②LSI/PAA
③見出し抽出
・オプション：[文字数1000未満のページを除外]、[h4～h6タグの見出しを除外]、[取得件数を上位10件]
④リライト対象記事（URLからスクレイピング）
それぞれ別のシートに出力してください。

【出力する項目】
■「共起語」シート
・A1セル：対象のキーワード
・B列：質問テキスト

■「LSI/PAA」シート
 * A1セル：対象のキーワード
・[B列：種類（LSI または PAA）]
・[C列：キーワードまたは質問テキスト]

■「見出し抽出」シート
・A1セル：対象のキーワード
・[B列：順位(〇位)]
・[C列：ページタイトル]
・[D列：見出しレベル(大文字)]
・[E列：見出しテキスト]

■「リライト対象記事」シート
・A1セル：対象のURL
・[B列：見出しレベル(h1, h2, h3)]
・[C列：見出しテキスト（HTMLタグを除去したプレーンテキスト）]
・[D列：見出し内文章（HTMLタグを除去したプレーンテキスト）]

【その他】
・APIキーはコードの一番上に「YOUR_API_KEY_HERE」として定義してください
・カスタムメニューは作らないでください