seo-maps
ローカルSEO向けのマップインテリジェンス機能です。ジオグリッドのランク追跡、APIを通じたGBPプロフィール監査、Google・Tripadvisor・Trustpilotなど複数プラットフォームのレビュー分析、Google・Bing・Apple・OSM間のNAP(名前・住所・電話番号)検証、競合他社の半径マッピング、APIデータからのLocalBusinessスキーマ生成が可能です。3段階の機能レベルで対応でき、無料版(Overpass + Geoapify)、DataForSEO(フル機能)、DataForSEO + Google(最大カバレッジ)から選択できます。「maps」「geo-grid」「rank tracking」「GBP audit」「review velocity」「competitor radius」「maps analysis」「local rank tracking」「Share of Local Voice」「SoLV」などのキーワードで利用できます。
description の原文を見る
Maps intelligence for local SEO — geo-grid rank tracking, GBP profile auditing via API, review intelligence across Google/Tripadvisor/Trustpilot, cross-platform NAP verification (Google/Bing/Apple/OSM), competitor radius mapping, and LocalBusiness schema generation from API data. Three-tier capability: free (Overpass + Geoapify), DataForSEO (full intelligence), DataForSEO + Google (maximum coverage). Use when user says "maps", "geo-grid", "rank tracking", "GBP audit", "review velocity", "competitor radius", "maps analysis", "local rank tracking", "Share of Local Voice", or "SoLV".
SKILL.md 本文
マップスインテリジェンス(2026年3月)
ローカルビジネス向けマップスプラットフォーム分析。外部APIを利用して、Google Maps、Bing Places、Apple Maps、OpenStreetMapにおけるビジネスの表示状況を評価します。
seo-local との境界線: このスキルはマップスプラットフォーム上のビジネスを分析します(API経由)。seo-local はウェブサイト上のローカルSEOシグナルを分析します(HTML取得経由)。seo-local のオンページ分析を重複させないようにしてください。ウェブサイトレベルのチェックには /seo local <url> を推奨します。
クイックリファレンス
| コマンド | 機能 | Tier |
|---|---|---|
/seo maps <url> | マップスプレゼンス監査(Tierを自動選択) | 0+ |
/seo maps grid <keyword> <location> | ジオグリッドランク スキャン(7x7、デフォルト1キーワード) | 1+ |
/seo maps reviews <business> <location> | クロスプラットフォームレビューインテリジェンス | 1+ |
/seo maps competitors <keyword> <location> | 競合半径マッピング | 0+ |
/seo maps nap <business-name> | クロスプラットフォームNAP検証 | 0+ |
/seo maps schema <business-name> | データからLocalBusiness JSON-LD生成 | 0+ |
/seo maps gbp <business> <location> | GBP完全性監査 | 1+ |
3段階の機能検出
分析前に、利用可能な機能Tierを検出します。
Tier 0(無料)
検出: DataForSEO MCPツールが利用できない。
機能: Overpass API競合発見、Geoapify POI検索、Nominatimジオコーディング、静的GBPチェックリスト、スキーマ生成、クロスプラットフォームNAPガイダンス。
読み込み: references/maps-free-apis.md
Tier 1(DataForSEO)
検出: business_data_business_listings_search MCPツールが利用可能。
機能: Tier 0のすべての機能に加えて、ジオグリッドランク追跡、ライブGBPプロフィール監査、レビューインテリジェンス(速度、センチメント、分布)、GBP投稿アクティビティ、Q&Aデータ、Tripadvisor/Trustpilotレビュー。
読み込み: references/maps-api-endpoints.md
Tier 2(DataForSEO + Google Maps Platform)
検出: Tier 1が利用可能かつ環境にGoogle Maps APIキーが存在する。
機能: Tier 1のすべての機能に加えて、Google Places詳細、リアルタイムビジネスステータス、AI搭載プレイス要約、写真分析。
注: Google ToSは place_id のみへのストレージを制限しています。Lat/lngは最大30日間キャッシュできます。
分析開始時に、検出されたTierをユーザーに常に伝えてください。
ジオグリッドランク追跡(Tier 1+)
複数のGPS座標からGoogle Mapsの検索をシミュレートして、地理的領域全体でのランキング変動を表示します。DataForSEOが必要です。
読み込み: references/maps-geo-grid.md アルゴリズム、SoLV公式、ヒートマップフォーマット用。
読み込み: references/maps-api-endpoints.md Maps SERPエンドポイント詳細用。
ワークフロー
- ビジネスアドレスをジオコードして中心lat/lngを取得
- Haversineオフセット公式を使用してグリッドポイントを生成(デフォルト: 7x7、5km半径)
- コスト見積もりを表示し、進める前に確認を求める
- グリッドポイントごとに
location_coordinateを指定してDataForSEO Maps SERP APIコールを実行 - 各ポイントでターゲットビジネスのランクを検索
- SoLV を計算:
(top_3_count / total_points) * 100 - 出力にASCIIヒートマップをレンダリング
コスト警告(必須)
ジオグリッドスキャンの前に、以下を表示してください:
ジオグリッドスキャン: [keyword] at [location]
グリッド: 7x7 (49ポイント) | キーワード: [N] | 予想コスト: $[amount]
DataForSEOクレジットが消費されます。進みますか?
GBPプロフィール監査(Tier 1推奨、Tier 0手動)
Google Business Profile の品質とランキングに影響する25フィールドを監査します。
読み込み: references/maps-gbp-checklist.md 完全なチェックリストとスコアリング用。
Tier 1 ワークフロー
- DataForSEO My Business Info APIを経由してビジネスプロフィールを取得(キーワードまたはCID)
- APIレスポンスフィールドを25フィールドチェックリストにマッピング
- 各フィールドをスコアリング: 存在 + 最適化 = 2pt、存在 = 1pt、なし = 0pt
- 業界固有の重み付け乗数を適用
- 0-100スケールに正規化
Tier 0 ワークフロー
- WebFetch経由でビジネスウェブサイトを取得
- 検出可能なGBPシグナルを抽出(Mapsエンベッド、プレイス参照、レビューウィジェット)
- 検出可能なシグナルに基づいて静的チェックリストを適用
- 検出不可能なフィールドを「不明(ライブデータはDataForSEO必須)」と記す
レビューインテリジェンス(Tier 1+)
クロスプラットフォームレビュー分析: 速度、センチメント、評価分布、偽造検出。
参照: references/local-seo-signals.md ベンチマーク用(seo-local と共有)。
ワークフロー
- DataForSEO Reviews API経由でGoogleレビューを取得(最新順でソート)
- レビュー速度を計算: 過去6ヶ月間の月あたりレビュー数
- 18日ルール(Sterling Sky)をチェック: 3週間以上のギャップ = ランキングリスク
- 評価分布を分析: 健全性 = 5つ星に偏ったベルカーブ
- オーナー返信率を計算: 返信 / 総レビュー数
- Tripadvisor と Trustpilot レビューを取得(利用可能な場合)
- クロスプラットフォーム比較表
偽造レビュー検出シグナル
以下のパターンの2つ以上に一致するレビューをフラグ:
- 均一なタイミング(同日・同時刻の複数レビュー)
- 限定的な履歴またはレビュー1件のみのレビュアーアカウント
- 地理的矛盾(レビュアー所在地対ビジネス所在地)
- 独占的な5つ星速度スパイク(履歴ベースラインと比較)
- レビュー全体で同一または近似のテキスト
- 対応するマーケティング活動なしの突然のボリューム急増
競合半径マッピング(Tier 0+)
定義された半径内の競合企業を特定・分析します。
Tier 0(Overpass API)
読み込み: references/maps-free-apis.md クエリテンプレート用。
- ビジネスアドレスをジオコード
- Overpass APIにクエリして、半径内の同じOSMタグを持つビジネスを検索
- 結果をパース: 名前、住所、電話、ウェブサイト、中心からの距離
- 距離でソート、競合環境テーブルとして提示
Tier 1(DataForSEO)
- Maps SERP APIを使用してビジネスキーワード + 所在地でクエリ
- トップ20競合企業をフル プロフィールデータで抽出
- 比較: 評価、レビュー数、カテゴリー、写真、属性
- 競争密度スコアを計算: km^2あたりの競合企業数
クロスプラットフォーム NAP検証(Tier 0+)
Google、Bing Places、Apple、OSM全体でのビジネスリスティング一貫性をチェックします。
ワークフロー
- 各プラットフォームでビジネス名を検索:
- Google: GBPデータまたはMaps SERPが結果から推測
- Bing:
WebFetch https://www.bing.com/maps?q=BUSINESS+NAME+LOCATION - Apple: 手動チェック(公開APIなし — businessconnect.apple.comでApple Business Connectを推奨)
- OSM: Overpass または Nominatim 検索
- 各ソースからNAP(名前、住所、電話)を抽出
- 一貫性を比較: 完全一致、部分一致、欠落、矛盾
- 不一致をフラグ: 重大(名前不一致)、高(住所不一致)、中(電話不一致)
- クレーム前のプロフィールをお勧めします
スキーマ生成(Tier 0+)
収集したデータからLocalBusiness JSON-LD マークアップを生成します。
参照: references/local-schema-types.md 業界サブタイプ用(seo-local と共有)。
ワークフロー
- 業界向けの最も具体的なスキーマサブタイプを決定
- 必須プロパティを埋入:
@type、name、address、image - 推奨プロパティを追加:
telephone、url、geo、openingHoursSpecification、priceRange - マルチロケーション向け戦略的プロパティを追加:
branchOf、areaServed、sameAs - レビューデータ利用可能な場合は
aggregateRatingを追加 - 実装準備完了の有効なJSON-LD ブロックを出力
セルフサービングレビューマークアップを生成しないでください — Googleはビジネス自身によるLocalBusiness レビューマークアップを無視します。ページに表示される第三者レビューのみをマークアップしてください。
参照ファイル
必要に応じてオンデマンドで読み込む(起動時にすべてを読み込まないでください):
references/maps-api-endpoints.md: DataForSEOエンドポイント詳細、パラメータ、コストreferences/maps-free-apis.md: Overpass、Geoapify、Nominatimクエリテンプレートreferences/maps-geo-grid.md: グリッドアルゴリズム、SoLV公式、ヒートマップレンダリングreferences/maps-gbp-checklist.md: 業界重み付け付き25フィールドGBP監査references/local-seo-signals.md: ランキング要因、レビューベンチマーク(共有)references/local-schema-types.md: 業界別LocalBusiness サブタイプ(共有)
出力
MAPS-ANALYSIS-{domain}.md を生成して、以下を含めます:
- マップスヘルススコア: XX/100 ディメンション分類テーブル付き
- 検出された機能Tier(Tier 0 または Tier 1) 利用可能なものの説明付き
- ジオグリッドヒートマップ(Tier 1): SoLVパーセンテージと平均ランク付きASCIIグリッド
- GBPプロフィール監査: 業界固有の重み付け付きフィールドごとのスコアリング
- レビューインテリジェンス: 速度チャート、評価分布、返信率、クロスプラットフォーム比較
- 競合環境: 半径内のカウント、評価/レビュー別トップ5、競争密度
- クロスプラットフォームプレゼンス: Google/Bing/Apple/OSM リスティングステータス
- スキーマ推奨: 生成されたLocalBusiness JSON-LD (欠落または不完全な場合)
- 優先度付きトップ10アクション(重大 > 高 > 中 > 低)
- コストレポート: 分析中に消費されたDataForSEO クレジット(Tier 1のみ)
- 制限事項免責: 現在のTierで評価できなかったもの
スキル間委譲
- ウェブサイトオンページローカルシグナル:
/seo local <url>を推奨 - 完全なAI検索可視性:
/seo geo <url>を推奨 - スキーマ検証と修正:
/seo schema <url>を推奨 - ライブSERPおよびキーワードデータ:
/seo dataforseo [command]を推奨
エラーハンドリング
| シナリオ | アクション |
|---|---|
| DataForSEO MCPが利用できない | Tier 0にドロップします。ユーザーに通知: 「DataForSEOが検出されません。フリーティア分析を実行しています。ジオグリッド追跡とレビューインテリジェンスについては、DataForSEO拡張機能をインストールしてください。」 |
| ビジネスがMaps SERPで見つからない | My Business InfoをキーワードでTry。それでも見つからない場合は、「このロケーションのGoogle Mapsでビジネスが見つかりません」と報告します。 |
| ジオコーディングが失敗(Nominatim) | ユーザーに座標またはより具体的なアドレスの提供を依頼します。 |
| APIレート制限に達した | 制限を報告します。ライブの代わりに標準(キュー登録)方法の使用を提案します。 |
| レビューが見つからない | ゼロレビュー状態を報告します。18日間の周期目標でレビュー生成戦略を推奨します。 |
| マルチロケーションが検出された | ユーザーにどのロケーションを分析するかを尋ねるか、ロケーションごとのコスト見積もり付きバッチモードを提供します。 |
ライセンス: MIT(寛容ライセンスのため全文を引用しています) · 原本リポジトリ
詳細情報
- 作者
- AgriciDaniel
- ライセンス
- MIT
- 最終更新
- 2026/5/11
Source: https://github.com/AgriciDaniel/claude-seo / ライセンス: MIT