seo-ai-social-report

SEO + AI + ソーシャルの統合レポート

レポートの作成では、クライアントが3つのツールを別々に確認しなければならないことがよくあります。このレポートでは、SE Ranking の検索順位と AI 検索での可視性、Planable のソーシャルエンゲージメントを1つの画面にまとめ、受信トレイ向けの簡潔なテキスト結論と、詳細確認用のインタラクティブな HTML レポートを作成します。

前提条件

• SE Ranking MCP が接続されていること（プロジェクトがある場合、順位の推移を最も明確に把握できます。Data API の履歴はプロジェクトがなくても利用できます）。
• Planable MCP が接続されており、ワークスペースと接続済みのページがあること。
• ユーザーから次の情報が提供されること：ドメインとブランド、市場／国（デフォルトは us）、Planable ワークスペース、レポート期間（デフォルトは前月）、および任意でシェア・オブ・ボイスを比較する競合他社。

コネクターの稼働状況チェック

ほかの作業に進む前に、両方の MCP に接続できることを確認します。

• SE Ranking： DATA_getSubscription を呼び出します。失敗するか認証エラーが返された場合は、直ちに処理を中止し、ユーザーに次のように伝えます。

  "The SE Ranking connector isn't responding — please reconnect it before we continue. Setup guide: https://seranking.com/api/integrations/mcp/"

• Planable： list_workspaces を呼び出します。失敗するか認証エラーが返された場合は、直ちに処理を中止し、ユーザーに次のように伝えます。

  "The Planable connector isn't responding — please reconnect it before we continue. Setup guide: https://help.planable.io/hc/en-us/articles/27538577098780-How-to-connect-Planable-MCP-to-your-AI-tools"

両方の呼び出しが正常な応答を返した場合に限り、以下の手順に進みます。

手順

1. 範囲の確認

ドメイン、Planable ワークスペース、期間、競合他社を確認します。期間を明確な開始日と終了日に変換します。

2. SEO データの取得（SE Ranking）

• プロジェクトがある場合： 順位の推移を確認するため、PROJECT_getSummary と PROJECT_getPositionHistory(site_id, type: avg_pos | visibility, date_from, date_to) を呼び出します。必要に応じて、完了済みのサイト監査（PROJECT_listAudits → getAuditReport）を再利用して、サイトの健全性を示す数値を取得します。
• プロジェクトがない場合： スナップショットとして DATA_getDomainOverviewWorldwide を呼び出します。
• ショートカット： ステップ3の AI 概要の呼び出し（時系列ビュー）では、選択した国の月別 organic_traffic ／ overall_traffic のデータも返されます。これらを別途履歴を取得する代わりに、オーガニックトレンドのグラフに再利用できます。

3. AI 検索データの取得（SE Ranking）

• デフォルトの時系列ビューで DATA_getAiSearchOverview(target, source, brand?) を呼び出します。ブランドの表示状況、リンクの表示状況、AI の機会トラフィック、平均順位に加え、月別のトレンドデータ（オーガニック／全体のトラフィックを含む）が取得できます。previous が null の場合は、これをベースラインとして扱います。change_percent の 100 を成長として表示しないでください。
• 競合他社が指定されている場合に限り、競合他社とのシェア・オブ・ボイスを確認するために DATA_getAiSearchLeaderboard(primary, competitors[], source, engines[]) を呼び出します。リクエストごとのエンジンと競合他社の数を絞ってください。リクエストが大きいとタイムアウトすることがあります。

4. ソーシャルデータの取得（Planable）

• list_pages(workspaceId) → ページ ID を取得します。
• get_page_metrics_summary(workspaceId, pageIds, startDate, endDate) — アカウント単位のオーディエンス数／インプレッション数／エンゲージメント率を取得します。
• get_post_metrics_summary(workspaceId, pageIds, startDate, endDate) — 期間内に公開された投稿の合計を取得します（ページのインプレッション数とは対象範囲が異なるため、別々に扱います）。
• get_post_metrics(workspaceId, pageIds, ..., limit: 5) — 上位の投稿を取得します。
• list_posts(...) — 期間中に公開された投稿を取得します（投稿数／頻度の確認用）。
• 月別のソーシャルトレンドを確認するには、月ごとに get_page_metrics_summary を呼び出します。

5. 簡潔な結論を作成する（チャット）

約10〜15行のプレーンテキストで要約します。SEO、AI 検索、ソーシャルの3領域それぞれの主な動きを示し、さらに「何が動いたか」「何に注意すべきか」といった具体的な指摘を2〜3点加えます。多くの人が実際に読むのはこの部分なので、余計な文言を省き、数値を中心に明快にまとめてください。

6. インタラクティブな HTML レポートを作成する

付属のテンプレート assets/report-template.html をベースとして使用します。このテンプレートには、Planable のカラーパレット、カードとセクションのレイアウト、Chart.js（CDN）が組み込まれており、二軸のトレンドチャートも用意されています。取得した実データを入力します。

• KPI カード： オーガニックトラフィック、AI のプレゼンス／シェア・オブ・ボイス、ソーシャルインプレッション、エンゲージメント率、投稿数。それぞれについて、前期間比の変化が実データとして得られる場合は記載します（得られない場合は差分を空欄にし、決して捏造しないでください）。
• トレンドチャート（インタラクティブ）： ランキング／オーガニックのトレンド、AI のプレゼンストレンド、ソーシャルインプレッションとエンゲージメント。2 つの系列のスケールが大きく異なる場合（例：数千単位のオーガニックトラフィックと数百単位の AI 機会トラフィック、またはインプレッションとエンゲージメント）は、二軸を使うか、別々のチャートにします。同じ軸に押し込んで小さい方の線が平坦にならないようにしてください。
• シェア・オブ・ボイス： ブランドと競合他社の棒グラフ（競合他社がいない場合は省略）。
• トップ投稿と変化した点／注目点 — テキストの概要と同じ内容にします。

データは JavaScript 配列としてファイル内に直接記述します（外部データファイルや localStorage は使用しません）。出力フォルダーに {client}-{period}-cross-channel-report.html として保存し、present_files で共有します。提示する前に、インラインスクリプトが解析できることを確認してください（簡単な node --check 相当のチェックで構いません）。

出力

1. 簡単な結論 — チャットに短いテキストの概要を記載します（数値と 2～3 件の要点）。
2. インタラクティブな HTML レポート — KPI カード、ホバー可能なトレンドチャート、シェア・オブ・ボイス、トップ投稿を含む自己完結型ファイルを present_files で提示します。

ヒント

• チャットの概要は簡潔にします。詳細は HTML の成果物に記載してください。チャットにレポート全体を重複して記載しないでください。
• レポートのフッターにデータソース（検索／AI は SE Ranking、ソーシャルは Planable）を明記し、生成日と正確な日付範囲を記載します。
• 読みやすいように数値を丸めます（48K、4.2%）。トレンドを決して捏造しないでください。系列のデータポイントが 1 つの場合は、その点を表示し、トレンドラインは省略します。
• 期間が部分的な場合（例：月初から現在までのデータ）は、そのことが明確にわかるようにし、短い棒が減少と誤解されないようにします。

例外と制限

• GA4／Looker Studio はありません。 このレポートは 2 つの MCP が返すデータ、つまり検索／AI の可視性とソーシャルエンゲージメントを対象とし、チャネル横断のコンバージョンアトリビューションは対象外です。その旨をフッターに記載してください。
• ページレベルのソーシャル分析は限定的です： Twitter/X、Pinterest、Threads、Google Business Profile では、通常、コネクター経由でページレベルの指標を取得できません。これらは unsupportedPages に表示されます。合計は対応チャネルを基準にし、残りは「データなし」と記載してください。
• データが少ない期間： 投稿が少ない場合やランキングの変動がほとんどない場合は、ノイズを大げさに扱わず、そのまま明記してください。
• 競合他社が指定されていない場合： 空のチャートを残さず、シェア・オブ・ボイスのセクションを省略してください。