Article Growth Insights セットアップガイド

本ガイドでは、「Article Growth Insights」プラグインをWordPressサイトに導入し、Google Search Console（GSC）と連携して診断を開始するまでの手順を説明します。

プラグインのインストールと有効化

WordPress管理画面の左側メニューから 「プラグイン」 > 「新規追加」 を開きます。
画面上部の 「プラグインのアップロード」 をクリックし、配布された article-growth-insights.zip を選択して「今すぐインストール」を押します。（※直接サーバーにアップロードする場合は、wp-content/plugins/ ディレクトリ内にフォルダごと配置してください）
インストール完了後、「プラグインを有効化」 をクリックします。
有効化すると、左メニューの一番上に 「記事伸びしろ診断」 というメニューが追加されます。

Google Cloud プロジェクトの準備（API連携）

当プラグインは、Google Search Consoleのデータを取得するために「Google Cloud」のAPI設定が必要です。

Google Cloud Console にアクセスし、Googleアカウントでログインします。（サイトのGSC権限を持っているアカウントを使用してください）
画面左上のプロジェクト選択メニューから 「新しいプロジェクト」 を作成します。（プロジェクト名は「WP Plugin API」など任意で構いません）
メニューの 「APIとサービス」 > 「ライブラリ」 を開き、検索窓で 「Google Search Console API」 と検索して選択し、「有効にする」 をクリックします。

OAuth 同意画面の設定

次に、アプリの認証画面を設定します。

メニューから 「APIとサービス」 > 「OAuth 同意画面」 を開きます。
User Type（ユーザーの種類）で 「外部 (External)」 を選び、「作成」をクリックします。
以下の必須項目のみを入力し、一番下の「保存して次へ」を押します。
- アプリ名: Article Growth Insights （など任意）
- ユーザーサポートメール: 自分のメールアドレス
- デベロッパーの連絡先情報: 自分のメールアドレス
次の「スコープ」画面はそのまま「保存して次へ」を押します。
【重要】「テストユーザー」画面の「+ ADD USERS（ユーザーを追加）」ボタンを押し、自分が普段WordPressとGSCを使っているGoogleアカウントのメールアドレスを追加して保存します。
- ※ここに追加したアカウントのみが、当プラグインで認証・ログインできるようになります。

クライアントID・クライアントシークレットの取得

プラグインに設定する鍵（IDとパスワードのようなもの）を発行します。

メニューから 「APIとサービス」 > 「認証情報」 を開きます。
画面上部の 「+ 認証情報を作成」 を押し、「OAuth クライアント ID」 を選びます。
以下の通り設定します：
- アプリケーションの種類: ウェブアプリケーション
- 名前: Article Growth Insights （任意）
- 承認済みのリダイレクト URI: ここには、WordPressの「設定」メニュー内に表示されている『コールバックURL』をコピーして貼り付けてください。（例: https://your-site.com/wp-admin/admin.php?page=article-growth-insights-setting）
「作成」をクリックすると、画面に 「クライアント ID」 と 「クライアントシークレット」 が表示されますので、コピーして控えておきます。

WordPress側での連携完了

WordPress管理画面の 「記事伸びしろ診断」>「設定」 を開きます。
「Client ID」 と 「Client Secret」 の欄に、先ほど取得した文字列をそれぞれ貼り付け、「設定を保存」します。
保存すると、画面下部に 「Googleと認証連携する」 というボタンが表示されるのでクリックします。
Googleのログイン画面が開くので、テストユーザーとして登録したGoogleアカウントを選択し、アクセスを「許可」します。（※「このアプリはGoogleで確認されていません」と出た場合は「詳細（Advanced）」をクリックして「安全ではないページに移動」から進んでください）
WordPressの設定画面に戻り、「✓ 認証済みです」と表示され、「対象のGoogleプロパティ（自動設定）」にご自身のサイトURLが表示されれば連携完了です！

これで、基本的なGSCデータの同期と診断機能が利用可能になります。

【オプション】Gemini AI 連携による自動提案機能の設定

当プラグインの「詳細・ToDo」で表示される課題や検索クエリ結果を元に、AIに「魅力的なTitle」と「Meta Description」を3パターン自動生成＆自動適用させる機能を使うための設定です。

Gemini API キーの取得

Googleが提供する「Google AI Studio」から無料でAPIキーを取得できます。

Google AI Studio – Get API Key へアクセスし、Googleアカウントでログインします（※Search Consoleと同じアカウントである必要はありません）。
左メニューの 「Get API key」 をクリックします。
青い 「Create API key」 ボタンをクリックします。
プロジェクトの選択画面が出た場合は、「Search in existing projects」から既存のGoogle Cloudプロジェクトを選ぶか、「Create API key in new project」を選択して新規作成します。
生成されたAPIキー（AIza から始まる長い文字列）をコピーします。
- ※このキーは他人に教えないように厳重に管理してください。

プラグインへのキー登録

WordPress管理画面の 「設定」（Article Growth Insights メニュー内）を開きます。
画面中段の 「Gemini API連携設定」 にある「Gemini API Key」の入力欄に、先ほどコピーしたキーを貼り付けます。
ページ下部の 「設定を保存」 ボタンをクリックします。
入力欄の右側に「✓ 設定済み」と表示されれば完了です。

AI提案機能の使い方

「診断」 管理画面を開きます。
スコアの高い（改善余地のある）記事の一覧から、右端の 「詳細・ToDo」ボタン をクリックします。
モーダル画面（詳細ウィンドウ）が開き、記事の課題や流入クエリが表示されます。
その下にある青い 「AIに改善案を3パターン作ってもらう」 ボタンをクリックします。
数秒待つと、「バランス型」「アピール型」「専門性重視型」の3つのパターンの Title と Description の候補が表示されます。
気に入った候補の横にある 「この記事に両方適用する」 を押すと、その記事のSEO編集画面に値が自動で保存・適用され、検索結果へ最優先で出力されるようになります。（テキストエリアの文章を自分好みに修正してから「適用」することも可能です）

データ同期と診断の開始

メニューの 「GSCデータ同期」 を開き、「今すぐ同期」 ボタンを押します。
- 直近28日間のデータ（検索クエリや表示回数）がデータベースに保存されます。
- 月間PVが多いサイトの場合、数秒〜数十秒かかる場合があります。
同期が完了したら、メニューの 「診断」 を開きます。
- 改善の余地がある（伸びしろがある）記事が一覧で表示されます。
- 「詳細・ToDo」ボタンを押して、具体的なアクションに沿って記事の修正（リライト）を行ってみましょう！