whitespark-tool

Whitespark ツール

注: Local SEO Data（localseodata-tool）では、citation_audit によるサイテーション監査が利用できるようになりました。サイテーションデータには、デフォルトで Local SEO Data を使用してください。サイテーション構築、順位追跡、レビュー生成キャンペーン（Reputation Builder）には、引き続き Whitespark が推奨ツールです。

Whitespark には MCP サーバーがありません。2 つの製品、Local Rank Tracker と Local Ranking Grids（ジオグリッド）は現在ベータ版の REST API を公開しており、エージェントはそれらの順位データとグリッドデータを直接取得できます。サイテーション関連製品には API がなく、引き続きダッシュボードまたは管理サービスを利用するため、サイテーションについてエージェントが担う役割は、Whitespark で何をすべきかユーザーに案内し、ユーザーが提供するデータを解釈することです。以下の Whitespark API セクションを参照してください。

Whitespark と他のツールの使い分け

必要なこと	Whitespark を使用	代わりに使用
サイテーションのギャップ分析（競合と自社の比較）	✅ Local Citation Finder	BrightLocal（こちらも対応しており、MCP を利用可能）
管理型サイテーション構築（代行サービス）	✅ サービス品質が最も高い	BrightLocal（こちらも提供）
レビュー生成キャンペーン（メール／SMS）	✅ Reputation Builder	—
レビューのモニタリング	✅	BrightLocal（MCP を利用でき、エージェントからのアクセスに適している場合があります）
ローカル順位の追跡	✅	Local SEO Data、Local Falcon（ローカル検索にはジオグリッドが優れています）
サイテーションの正確性監査	⚠️ 対応可能	BrightLocal（NAP の正確性スコアリングに優れています）
キーワード調査	❌	Local SEO Data、Semrush、Ahrefs
被リンク分析	❌	Local SEO Data、Ahrefs
技術監査	❌	Screaming Frog
ジオグリッドの順位	✅	Local SEO Data、Local Falcon

Whitespark と BrightLocal の比較

この 2 つのツールは機能が大きく重複しています。使い分けの目安は次のとおりです。

機能	Whitespark	BrightLocal
サイテーション構築の品質	✅ 品質が高い（手動レビュー）	良好ですが、自動化の範囲が広い
サイテーションギャップの検出	✅ より徹底的	✅ こちらも優れています
NAP の正確性スコアリング	基本的	✅ より優れたスコアリングシステム
MCP サーバーの有無	❌ なし	✅ あり
レビュー生成	✅ Reputation Builder	✅ こちらにもあります
ホワイトラベルレポート	基本的	✅ レポート機能がより優れています
業界での評判	✅ サイテーションの専門家	✅ ローカル SEO のオールインワン
価格	サービスごと	サブスクリプション

推奨: MCP 接続が重要な場合（エージェントがデータを直接取得できる場合）は、BrightLocal を使用してください。サイテーション構築の品質を優先し、ユーザーがダッシュボードを利用する意思がある場合は、Whitespark の管理サービスが優れています。

主なワークフロー

サイテーションギャップ分析

利用する場合: 競合が掲載されている一方で、自社が掲載されていないディレクトリを見つけたい場合。

Whitespark で行うこと:

1. 対象のビジネスと競合 2～3 社について、Local Citation Finder を実行します
2. すべてのビジネスのサイテーションソースを比較します
3. 競合は掲載されているが、ユーザーは掲載されていないディレクトリを特定します

エージェントができること:

• 確認する競合をユーザーに案内します
• ユーザーが結果を共有した際に、サイテーションギャップレポートを解釈します
• 優先的に対処するディレクトリを決めます

サイテーションの優先度の目安:

1. Tier 1（必須）：Google、Apple、Bing、Yelp、Facebook、データアグリゲーター
2. Tier 2（重要）：業界別ディレクトリ（Healthgrades、Avvo、Angi など）
3. Tier 3（あると便利）：地域のディレクトリ、商工会議所、BBB
4. Tier 4（優先度低）：一般的なウェブディレクトリ、ニッチなサイト

管理型サイテーション構築

利用する場合: サイテーションギャップを特定し、構築のサポートを必要としている場合。

Whitespark が行うこと:

• ディレクトリに手動で登録します（自動ツールより高品質です）
• リスティングが公開済みで正確であることを確認します
• 継続的なメンテナンスオプションを提供します

ユーザーに伝えること:

1. 正確な NAP を用意します（GBP と一致している必要があります）
2. ビジネスの説明、カテゴリ、写真を用意します
3. ギャップ分析で特定した対象ディレクトリを指定します
4. ほとんどのディレクトリで、完了まで 2～4 週間かかる見込みです
5. 6～8 週間後に再監査し、すべてが公開済みで正確であることを確認します

レビュー生成（評判の構築）

使用する場面： Google のレビューを継続的に増やしたい場合。

Reputation Builder の仕組み：

• 顧客リスト（メールアドレスまたは電話番号）をインポートします
• メールまたは SMS でレビュー依頼を自動送信します
• 満足している顧客を Google のレビュー投稿ページに誘導します
• 依頼を受け取った人、レビューを投稿した人を追跡します

エージェントが案内すべきこと：

1. タイミング： サービス完了後 1〜3 日でレビューを依頼します
2. メッセージ： 短く、個人的な内容にし、Google のレビュー投稿リンクを直接含めます
3. 件数： 50 件を一度に依頼するより、毎週 5〜10 件を継続的に依頼するほうが効果的です
4. 対象の選別： 不満を抱えていると分かっている顧客には送信しないでください（否定的なレビューを避けます）
5. コンプライアンス： レビューを投稿する見返りを提供しないでください。また、評価に基づいて投稿先を分けないでください

業種別のレビュー獲得目標：

業種	月間レビュー目標	理由
レストラン	15-30	取引件数が多い
医療機関	8-15	患者数が中程度
住宅サービス	5-10	利用頻度が低い
法律事務所	3-5	顧客数が少なく、依頼しにくい
B2B サービス	2-4	件数は少ないが、価値が高い

ローカル検索順位の追跡

使用する場面： ユーザーが Whitespark の順位トラッカーを利用している場合。

Whitespark の順位トラッカーは地点ベース（単一地点）であり、ジオグリッドではありません。

エージェントが把握しておくべきこと：

• これはキーワードごとに 1 地点での順位を示すもので、地域全体での掲載状況は示しません
• ローカルビジネスでは、Local Falcon のジオグリッドのほうがはるかに有用です
• Whitespark の順位追跡は、ジオグリッドと併用してオーガニック検索キーワードを追跡する用途には適しています

Whitespark API

Whitespark の 2 つの製品では REST API を利用できます。どちらもベータ版であり、エンドポイントやレスポンスの形式は変更される可能性があります。また、どちらも MCP サーバーではないため、呼び出しはエージェントコネクター経由ではなく、直接行うか、カスタムインテグレーションを通じて行います。引用 API はありません。引用の構築と監査は、引き続きダッシュボードまたはマネージドサービスで行います。

引用のデータには、LocalSEOData（citation_audit）を標準で使用します。グリッド API で取得できる範囲を超えるジオグリッドの詳細データには、LocalSEOData（geogrid_scan）または Local Falcon を使用します。

Local Ranking Grids（ジオグリッド）API

リファレンス：https://lrg.whitespark.ca/api-docs

レポートとの連携を目的としており、グリッドの概要を取得して、グリッドのビジュアルをレポートやダッシュボードに埋め込みます。基盤となるグリッドのデータポイントは公開していません。

認証： Authorization ヘッダーに Bearer トークンを指定します。アプリ内のプロフィールのドロップダウン → API Access からトークンを生成します。

エンドポイント：

• GET /grids — 順位グリッドのページ分割された一覧と、視認性スコア、平均順位、レビュー評価の概要指標を返します。ページ分割には page（既定値 1）と per_page（既定値 50、最大 100）を使用します。レスポンスには data と meta オブジェクト（current_page、last_page、per_page、total）が含まれます。
• GET /grid/{grid_id}/download-screenshot/{mode} — グリッドの最新スクリーンショットを返します。mode は with-metrics または without-metrics です。grid_id はグリッドの URL に含まれる UUID です。スクリーンショットが存在しない場合は 404 を返します。<img> を使って埋め込めます。スキャンが完了するたびにこの URL が更新されるよう、API access ページで Automatic screenshots を有効にしてください。

API では利用できない機能（ダッシュボードのみ）： グリッド内の個々のデータポイント、競合他社のデータポイント、グリッドの作成、グリッドや実行スケジュールの変更。

用途： 常に最新のジオグリッド画像を埋め込み、視認性スコア／平均順位／レビュー評価を月次レポートやポートフォリオの集計に取り込みます。地点ごとの順位や競合他社のグリッドが必要な場合は、こちらを使用せず、geogrid_scan（LocalSEOData）または Local Falcon を使用してください。

Local Rank Tracker API

リファレンス：https://whitespark-api.apidocumentation.com/rank-tracker-api-reference

ベータ版（v1.0.0、OpenAPI 3.0.0）で、本番環境とテスト環境のベース URL が分かれています。認証： API キーをヘッダーとして渡します。

3 つのリソースグループを中心に構成されています。

• campaigns — ランク追跡キャンペーンの一覧表示と読み取り（キャンペーンは、ビジネスの追跡対象キーワードと場所をまとめるコンテナです）
• campaign — 単一のキャンペーンを操作します
• rankings — 追跡対象キーワードのランキング結果を取得します

基盤となるトラッカーは、Google と Bing のローカルパック、マップ、オーガニック検索を、デスクトップとモバイルで対象としており、最大 100 位まで、地域ターゲティングと加重 Visibility Score に対応しています。正確なパス、パラメーター、レスポンススキーマは、上記の API リファレンスで確認してください。ベータ版ドキュメントが信頼できる情報源であり、そこにある「Download OpenAPI Document」リンクから完全なスキーマを入手できます。ベータ版に関する質問は [email protected] までお寄せください。

次の用途に使用： オーガニック検索／ローカルパックのキーワード順位と Visibility Score を、ジオグリッドデータと併せて定期レポートに取り込む作業の自動化。次のような場合には使用しないでください： 単一地点の順位よりも地理的なカバレッジが重要な場合。そうした用途には grids API と geogrid_scan を使用します。

次に行うこと

確認できた内容	次のアクション	スキル
引用の不足を特定した	Tier 1 から順に、不足している引用を構築する	local-citations
引用を構築済みで、反映を待っている	待機中（4-8 週間）に、他の最適化に取り組む	gbp-optimization, review-management
レビュー獲得キャンペーンを実施中	反応率が低い場合は、推移を監視してメッセージを調整する	review-management
レポートに引用データが必要	監査レポートまたは月次レポートに含める	client-deliverables, local-reporting
MCP からアクセスできる引用データが必要	代わりに BrightLocal を使用する	brightlocal-tool
レポートにグリッドのビジュアルやサマリー指標が必要	Local Ranking Grids API から取得する	local-reporting, client-deliverables
レポートにキーワード順位や Visibility Score が必要	Local Rank Tracker API から取得する	local-reporting

次の基本ステップ： Whitespark の強みは、引用の管理サービスです。自動化された、エージェントからアクセスできる引用データが必要な場合は、BrightLocal を使用してください。最高品質の引用構築が必要な場合は、Whitespark の管理サービスを利用してください。