尋找商家
search_google_maps搜尋某個類別和地點。接收最多 20 家商家,包含可用的清單、聯絡方式、評分和評論數欄位。
q · page · extra
探索 Search API三個工具 / 一次連線
每個工具直接傳回結果。選擇任務所需的操作,並明確指定所需頁數。
search_google_maps搜尋某個類別和地點。接收最多 20 家商家,包含可用的清單、聯絡方式、評分和評論數欄位。
q · page · extra
探索 Search APIget_google_maps_reviews使用地點的 feature ID 請求最多 10 則評論。可選相關性、最新、最高評分或最低評分。
fid · page · sort_by
探索 Reviews APIget_google_maps_photos取得某個地點最多 20 筆照片和影片中繼資料記錄。讀取傳回的媒體 URL 和分頁旗標。
fid · page
探索 Photos APIReviews 和 Photos 接受來自搜尋結果 place.dataId 的 Maps feature ID。Search 使用第 1–10 頁;媒體工具傳回 next,供您的 AI 助理判斷是否需要下一頁。
MCP 連線
您的用戶端負責初始化和工具探索,然後在每個請求中攜帶您的 API 金鑰。
POST https://gmapscrawl.com/api/mcp
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json
Accept: application/json, text/event-stream用戶端設定
建立 API 金鑰,然後複製對應用戶端的設定。將金鑰保存在其環境或受保護的 input 設定中。
將此伺服器新增到 .mcp.json。確保 GMSCRAPER_API_KEY 在啟動 Claude Code 的環境中可用。
{
"mcpServers": {
"google-maps-data": {
"type": "http",
"url": "https://gmapscrawl.com/api/mcp",
"headers": {
"Authorization": "Bearer ${GMSCRAPER_API_KEY}"
}
}
}
}儲存設定後,重新連線並確認出現這三個工具。按照分步設定指南操作。
您的第一個工作流程
先用測試金鑰和模擬資料開始。準備好使用 API 額度後再切換到正式金鑰。
選擇 API 產品並建立帶 scrapes:write 的測試金鑰。您的 API 方案必須允許 MCP;線上擷取工具和瀏覽器擴充功能有獨立額度。
建立金鑰連接您的用戶端,檢視 search_google_maps,並請求一頁資料。為新任務產生新的請求 ID,重試同一請求時保留該 ID。
檢視用戶端設定讀取 structuredContent.businesses 和 total。將測試結果標記為模擬資料,保留缺失值,並在所請求的頁面處停止。
瞭解這些欄位每次新搜尋都替換請求 ID。此範例不會在頁面上執行請求。
{
"q": "coffee shops in Seattle",
"page": 1,
"hl": "en",
"extra": false,
"client_request_id": "replace-with-a-fresh-uuid"
}傳回的內容
結果直接傳回,無需任務輪詢。將 JSON 轉成表格或報告時,請保留來源觀測日期。
範例提示詞
連線後使用這些提示詞。需要時提供真實的 feature ID,並讓您的 AI 助理將測試結果標記為模擬資料。
“對西雅圖的咖啡店使用一次 search_google_maps,第 1 頁,extra 為 false。傳回商家的名稱、網站、電話號碼、評分和評論數。缺失欄位留空並顯示觀測日期。處理完本頁後停止。”
預期結果
一張最多 20 家傳回商家的表格,保留來源時間戳記和缺失值。
“對於我選定的商家,將其 place.dataId 作為 fid。用 sort_by 2 請求 get_google_maps_reviews 的第 1 頁。只總結這些傳回評論中的主題並註明日期。不要取得額外頁面。”
預期結果
一份基於最多 10 則評論的有限總結,不會把一頁資料當作所有客戶的體驗。
“對這個提供的 feature ID 使用 get_google_maps_photos,僅第 1 頁。列出傳回的 photoUrl 和可選 videoUrl 欄位,並回報 next 是否為 true。不要下載檔案或取得下一頁。”
預期結果
最多 20 筆相簿記錄以及傳回的分頁狀態,供您自己的應用程式檢查。
REST + MCP
免費和付費 API 方案均可使用 MCP。每個成功的正式來源頁(包括空白頁)消耗一個 API 請求單位。
測試金鑰傳回模擬資料,消耗 0 個請求單位。它們用於驗證您的整合,而不是產生真實的潛在客戶。
管理 API 金鑰只請求任務所需的頁面和地點。新任務使用新的請求 ID;對不確定的請求用相同輸入和 ID 重試。
閱讀用量指引Google Maps Data Agent Skill 為同樣的工具增加工作流程指引、操作參考和 REST 備用方案。
探索 Agent Skill探索 API 中心 → 線上擷取工具和瀏覽器擴充功能方案有各自的額度。
連線協助
根據連線狀態和傳回的錯誤選擇下一步。
它提供 search_google_maps、get_google_maps_reviews 和 get_google_maps_photos。Search 每頁最多傳回 20 家商家;評論最多傳回 10 筆記錄,照片最多傳回 20 筆相簿記錄。這些工具直接傳回結構化資料。
使用支援遠端 Streamable HTTP 和私密 Authorization 請求標頭的 Claude Code、Cursor、VS Code、Codex 或其他 MCP 用戶端版本。上方四種用戶端設定使用同一端點和 API 工作區金鑰。
在您的 API 工作區建立帶 scrapes:write 的 API 金鑰,並將其以私密方式設定為 Bearer 請求標頭。瀏覽器 Cookie 無法驗證 MCP。請將金鑰放在提示詞、URL 和已提交的原始碼之外。
將 Maps feature ID 作為 fid 傳入。您可以使用傳回商家中的 place.dataId。評論還接受 sort_by:1 表示相關性,2 表示最新,3 表示最高評分,4 表示最低評分。在考慮下一頁媒體資料前先讀取 next。
MCP 與 REST API 共用額度,免費和付費 API 方案均可使用。一個成功的正式頁消耗一個請求單位,包括空白頁。測試憑證傳回模擬資料,消耗 0 個單位。線上擷取工具和瀏覽器擴充功能的額度是獨立的。
MCP 伺服器可以獨立運作。可選的 Google Maps Data Agent Skill 會額外提供可重複使用說明、操作參考,以及在您設定的 MCP 連線不可用時用於 REST 備用方案的輔助工具。