Maps intelligence for local SEO: geo-grid rank tracking, GBP profile auditing via API, review intelligence across Google/Tripadvisor/Trustpilot, cross-platform NAP verification, competitor radius mapping, and LocalBusiness schema generation. Three tiers: free (Overpass + Geoapify), DataForSEO, and DataForSEO + Google. Use when user says "maps", "geo-grid", "rank tracking", "GBP audit", "review velocity", "competitor radius", or "SoLV".
地圖情報（2026年3月）
針對在地商家進行地圖平台分析。透過外部API評估商家在Google Maps、Bing Places、Apple Maps及OpenStreetMap上的曝光狀況。
與seo-local的界線： 此技能透過API分析商家在「地圖平台」上的表現。seo-local則透過HTML擷取分析「網站」上的在地SEO訊號。請勿重複seo-local的頁面分析。建議使用 /seo local <url> 進行網站層級的檢查。
快速參考
| 指令 | 功能 | 層級 |
|---|---|---|
/seo maps <url> |
完整地圖曝光審核（自動選擇層級） | 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+ |
三層級能力偵測
在進行任何分析前，先偵測可用的能力層級：
層級0（免費）
偵測方式： DataForSEO MCP工具不可用。
能力： Overpass API競爭者探索、Geoapify POI搜尋、Nominatim地理編碼、靜態GBP檢查清單、結構化資料產生、跨平台NAP指引。
載入： ../seo/references/maps-free-apis.md
層級1（DataForSEO）
偵測方式： business_data_business_listings_search MCP工具可用。
能力： 層級0的所有功能，加上地理網格排名追蹤、即時GBP個人資料審核、評論情報（速度、情感、分佈）、GBP貼文活動、問答資料、Tripadvisor/Trustpilot評論。
載入： ../seo/references/maps-api-endpoints.md
層級2（DataForSEO + Google Maps Platform）
偵測方式： 層級1可用，且環境中有Google Maps API金鑰。
能力： 層級1的所有功能，加上Google Places詳細資料、即時商家狀態、AI驅動的地點摘要、照片分析。
注意： Google服務條款限制僅能儲存 place_id。經緯度最多快取30天。
在分析開始時，務必向使用者告知偵測到的層級。
地理網格排名追蹤（層級1+）
模擬從多個GPS座標搜尋Google Maps，顯示排名在整個地理區域內的變化。需要DataForSEO。
載入： ../seo/references/maps-geo-grid.md 以取得演算法、SoLV公式、熱力圖格式。
載入： ../seo/references/maps-api-endpoints.md 以取得Maps SERP端點詳細資訊。
工作流程
- 將商家地址地理編碼，取得中心點經緯度
- 使用Haversine偏移公式產生網格點（預設：7x7，半徑5公里）
- 顯示費用估算，並在繼續前要求使用者確認
- 對每個網格點以
location_coordinate呼叫DataForSEO Maps SERP API - 找出目標商家在每個點上的排名
- 計算SoLV：
(top_3_count / total_points) * 100 - 在輸出中呈現ASCII熱力圖
費用警告（必要）
在每次地理網格掃描前，顯示：
地理網格掃描：[keyword] 於 [location]
網格：7x7（49個點）| 關鍵字：[N] | 預估費用：$[amount]
將消耗DataForSEO點數。是否繼續？
GBP個人資料審核（層級1優先，層級0手動）
審核影響Google商家檔案品質與排名的25個欄位。
載入： ../seo/references/maps-gbp-checklist.md 以取得完整檢查清單與評分。
AI與2026年背景（第三方報導）： Ask Maps，據AP News報導為2026年3月12日推出的Gemini對話式地圖功能（iOS/Android，美國+印度）。AI模式（月活躍用戶超過10億，據Google I/O 2026主題演講報導；未經Google官方來源確認）在第三方術語中越來越多地顯示1-2個商家在地AI介面，而代理預約/通話功能（適用於家庭維修、美容、寵物照護等在地服務）將於2026年夏季向所有美國用戶推出（Google可代使用者致電商家）。2026年GBP API新增功能：評論媒體網址、定期在地貼文排程、評論回覆狀態/審核，以及邀請Place ID。來源：blog.google/products-and-platforms/products/search/search-io-2026/ · developers.google.com/my-business/content/latest-updates
層級1工作流程
- 透過DataForSEO My Business Info API（使用關鍵字或CID）取得商家檔案
- 將API回應欄位對應到25欄檢查清單
- 為每個欄位評分：存在且最佳化=2分，存在=1分，缺失=0分
- 套用行業特定的權重乘數
- 標準化為0-100分
層級0工作流程
- 透過WebFetch取得商家網站
- 擷取任何可見的GBP訊號（地圖嵌入、地點參考、評論小工具）
- 根據可偵測的訊號套用靜態檢查清單
- 將無法偵測的欄位標記為「未知（需DataForSEO取得即時資料）」
評論情報（層級1+）
跨平台評論分析：速度、情感、評分分佈、假評論偵測。
參考： ../seo/references/local-seo-signals.md 以取得基準（與seo-local共用）。
工作流程
- 透過DataForSEO Reviews API取得Google評論（按最新排序）
- 計算評論速度：過去6個月每月評論數
- 檢查18天規則（Sterling Sky）：任何3週間隔=排名風險
- 分析評分分佈：健康狀態應為偏向5星的鐘形曲線
- 計算商家回覆率：回覆數/總評論數
- 取得Tripadvisor和Trustpilot評論（如有）
- 跨平台比較表
假評論偵測訊號
標記符合以下2個以上模式的評論：
- 時間一致（多則評論在同一天/同一小時）
- 評論者帳號歷史有限或僅有一則評論
- 地理位置不一致（評論者位置與商家位置不符）
- 僅有5星的速度高峰（與歷史基準相比）
- 評論文字完全相同或極為相似
- 突然的大量增加，且無對應的行銷活動
競爭者半徑地圖繪製（層級0+）
識別並分析指定半徑內的競爭者。
層級0（Overpass API）
載入： ../seo/references/maps-free-apis.md 以取得查詢範本。
- 將商家地址地理編碼
- 查詢Overpass API，尋找半徑內具有相同OSM標籤的商家
- 解析結果：名稱、地址、電話、網站、距中心點距離
- 按距離排序，以競爭者地圖表呈現
層級1（DataForSEO）
- 使用Maps SERP API搭配商家關鍵字與地點
- 擷取前20名競爭者的完整個人資料
- 比較：評分、評論數、類別、照片、屬性
- 計算競爭密度分數：每平方公里競爭者數
跨平台NAP驗證（層級0+）
檢查商家資訊在Google、Bing Places、Apple和OSM上的一致性。
工作流程
- 在各平台搜尋商家名稱：
- Google：從GBP資料或Maps SERP結果推斷
- Bing：
WebFetch https://www.bing.com/maps?q=BUSINESS+NAME+LOCATION - Apple：手動檢查（無公開API——確認/聲明Apple商家列表存在；將Apple Business啟動/更名聲明視為TechRadar來源，直到Apple官方確認）
- OSM：Overpass或Nominatim搜尋
- 從各來源擷取NAP（名稱、地址、電話）
- 比較一致性：完全相符、部分相符、缺失或衝突
- 將不一致標記為：嚴重（名稱不符）、高（地址不符）、中（電話不符）
- 建議聲明未聲明的個人資料
結構化資料產生（層級0+）
從收集的資料產生LocalBusiness JSON-LD標記。
參考： ../seo/references/local-schema-types.md 以取得行業子類型（與seo-local共用）。
工作流程
- 確定該行業最具體的結構化資料子類型
- 填入必要屬性：
@type、name、address、image - 加入建議屬性：
telephone、url、geo、openingHoursSpecification、priceRange - 為多據點加入策略屬性：
branchOf、areaServed、sameAs - 如有評論資料，加入
aggregateRating - 輸出可供實作的JSON-LD區塊
請勿產生自我服務的評論標記——Google會忽略商家自行標記的LocalBusiness評論。僅標記頁面上可見的第三方評論。
參考檔案
按需載入（請勿在啟動時全部載入）：
../seo/references/maps-api-endpoints.md：DataForSEO端點詳細資訊、參數、費用../seo/references/maps-free-apis.md：Overpass、Geoapify、Nominatim查詢範本../seo/references/maps-geo-grid.md：網格演算法、SoLV公式、熱力圖呈現../seo/references/maps-gbp-checklist.md：25欄GBP審核，含行業權重../seo/references/local-seo-signals.md：排名因素、評論基準（共用）../seo/references/local-schema-types.md：按行業分類的LocalBusiness子類型（共用）
輸出
產生 MAPS-ANALYSIS-{domain}.md，包含：
- 地圖健康分數：XX/100，附維度細項表
- 偵測到的能力層級（層級0或層級1），說明可用功能
- 地理網格熱力圖（層級1）：ASCII網格，含SoLV百分比與平均排名
- GBP個人資料審核：逐欄評分，含行業特定權重
- 評論情報：速度圖表、評分分佈、回覆率、跨平台比較
- 競爭者地圖：半徑內數量、前5名評分/評論數、競爭密度
- 跨平台曝光：Google/Bing/Apple/OSM列表狀態
- 結構化資料建議：產生的LocalBusiness JSON-LD（若缺失或不完整）
- 前10項優先行動（嚴重>高>中>低）
- 費用報告：分析期間消耗的DataForSEO點數（僅層級1）
- 限制聲明：當前層級無法評估的項目
跨技能委派
- 網站頁面在地訊號：建議使用
/seo local <url> - 完整AI搜尋曝光：建議使用
/seo geo <url> - 結構化資料驗證與修正：建議使用
/seo schema <url> - 即時SERP與關鍵字資料：建議使用
/seo dataforseo [command]
錯誤處理
| 情境 | 處理方式 |
|---|---|
| DataForSEO MCP不可用 | 降級至層級0。告知使用者：「未偵測到DataForSEO。執行免費層級分析。如需地理網格追蹤與評論情報，請安裝DataForSEO擴充功能。」 |
| 在地圖SERP中找不到商家 | 嘗試以關鍵字使用My Business Info。若仍找不到，回報「在此地點的Google Maps中找不到該商家。」 |
| 地理編碼失敗（Nominatim） | 要求使用者提供座標或更具體的地址。 |
| API速率限制 | 回報限制。建議等待或使用標準（佇列）方法而非即時。 |
| 找不到評論 | 回報零評論狀態。建議以18天節奏為目標的評論產生策略。 |
| 偵測到多據點 | 詢問使用者要分析哪個據點，或提供批次模式及每個據點的費用估算。 |
