{
  "spec_version": "0.2",
  "namespace": "WW_Yang",
  "app_name": "google-maps-leads-keyword",
  "app_id": "app_41dd2133c3fc",
  "status": "published",
  "open_to": "public",
  "accepting_runs": true,
  "source_locale": "zh-CN",
  "identity": {
    "app_name": "google-maps-leads-keyword",
    "name": "谷歌地图线索采集（按关键词）",
    "summary": "给一个搜索关键词，返回谷歌地图该关键词下的商家线索，含名称、类别、地址、电话、官网、评分、评论数、营业时间与经纬度",
    "type": "data",
    "version": "0.1.1"
  },
  "discovery": {
    "capability": "data-acquisition",
    "keywords": [
      "谷歌地图",
      "商家线索",
      "按关键词",
      "本地商家",
      "拓客"
    ],
    "boundary": "单次任务处理 1 个搜索关键词，采集条数上限默认 3 条、可上调（越大耗时与费用越高）；仅覆盖页面公开展示的商家信息，部分商家缺少官网、电话或附加信息。"
  },
  "input": {
    "schema": {
      "type": "object",
      "properties": {
        "keyword": {
          "type": "string",
          "title": "搜索关键词",
          "description": "在地图上要搜索的关键词，建议写成「品类 + 地点」的形式，例如 coffee shops in New York；请填写真实可检索的关键词",
          "prefill": "coffee shops in New York"
        },
        "page_turns": {
          "type": "integer",
          "title": "翻页次数",
          "description": "在首个结果页之外继续向下翻页的次数，不填默认 1 次；次数越多耗时和费用越高",
          "default": 1,
          "minimum": 1
        },
        "max_collected_rows": {
          "type": "integer",
          "title": "采集条数上限",
          "description": "本次任务最多采集多少条商家线索，不填默认 3 条，数值越大耗时和费用越高",
          "default": 3,
          "minimum": 1
        }
      },
      "required": [
        "keyword"
      ],
      "additionalProperties": false
    }
  },
  "output": {
    "id_field": "place_id",
    "schema": {
      "type": "object",
      "properties": {
        "title": {
          "type": "string",
          "title": "商家名称",
          "description": "商家在地图上展示的名称",
          "prefill": "787 Coffee Co."
        },
        "category_listing": {
          "type": "string",
          "title": "主类别",
          "description": "商家在列表页展示的主要类别",
          "prefill": "Coffee shop"
        },
        "category_detail": {
          "type": "string",
          "title": "细分类别",
          "description": "商家详情页展示的类别",
          "prefill": "Coffee shop"
        },
        "address": {
          "type": "string",
          "title": "地址",
          "description": "商家的完整街道地址",
          "prefill": "251 W 30th St, New York, NY 10001"
        },
        "city": {
          "type": "string",
          "title": "城市",
          "description": "商家所在城市",
          "prefill": "New York"
        },
        "state": {
          "type": "string",
          "title": "州/省",
          "description": "商家所在的州或省级行政区",
          "prefill": "New York"
        },
        "country": {
          "type": "string",
          "title": "国家",
          "description": "商家所在国家或地区的代码",
          "prefill": "US"
        },
        "phone": {
          "type": "string",
          "title": "电话",
          "description": "商家的联系电话，部分商家没有",
          "prefill": "(646) 454-0133"
        },
        "website": {
          "type": "string",
          "title": "官网",
          "description": "商家官网链接，部分商家没有",
          "prefill": "http://www.787coffee.com/"
        },
        "rating": {
          "type": "string",
          "title": "评分",
          "description": "商家在地图上展示的评分，5 分制",
          "prefill": "4.8"
        },
        "review_count": {
          "type": "string",
          "title": "评论数",
          "description": "商家的累计评价条数",
          "prefill": "5858"
        },
        "current_status": {
          "type": "string",
          "title": "当前状态",
          "description": "取数当时商家的营业状态，如「Closed · Opens 7AM」",
          "prefill": "Closed · Opens 7AM"
        },
        "open_time_monday": {
          "type": "string",
          "title": "周一营业时间",
          "description": "周一当天的营业时间与日期",
          "prefill": "Monday 1 7AM–8PM 2026-9-14"
        },
        "open_time_tuesday": {
          "type": "string",
          "title": "周二营业时间",
          "description": "周二当天的营业时间与日期",
          "prefill": "Tuesday 2 7AM–8PM 2026-9-15"
        },
        "open_time_wednesday": {
          "type": "string",
          "title": "周三营业时间",
          "description": "周三当天的营业时间与日期",
          "prefill": "Wednesday 3 7AM–8PM 2026-9-16"
        },
        "open_time_thursday": {
          "type": "string",
          "title": "周四营业时间",
          "description": "周四当天的营业时间与日期",
          "prefill": "Thursday 4 7AM–8PM 2026-9-17"
        },
        "open_time_friday": {
          "type": "string",
          "title": "周五营业时间",
          "description": "周五当天的营业时间与日期",
          "prefill": "Friday 5 7AM–8PM 2026-9-11"
        },
        "open_time_saturday": {
          "type": "string",
          "title": "周六营业时间",
          "description": "周六当天的营业时间与日期",
          "prefill": "Saturday 6 7AM–8PM 2026-9-12"
        },
        "open_time_sunday": {
          "type": "string",
          "title": "周日营业时间",
          "description": "周日当天的营业时间与日期",
          "prefill": "Sunday 7 8AM–8PM 2026-9-13"
        },
        "plus_code": {
          "type": "string",
          "title": "Plus Code",
          "description": "商家的 Plus Code 位置编码",
          "prefill": "P2X4+P7 New York"
        },
        "plus_code_url": {
          "type": "string",
          "title": "Plus Code 链接",
          "description": "Plus Code 对应的定位链接",
          "prefill": "https://plus.codes/P2X4+P7 New York"
        },
        "google_id": {
          "type": "string",
          "title": "Google ID",
          "description": "商家在地图上的标识，十六进制键值对形式",
          "prefill": "0x89c259a171bd55e3:0x92a55ea34c9f9354"
        },
        "place_id": {
          "type": "string",
          "title": "地点 ID",
          "description": "商家在地图上的唯一地点标识",
          "prefill": "ChIJ41W9caFZwokRVJOfTKNepZI"
        },
        "latitude": {
          "type": "string",
          "title": "纬度",
          "description": "商家所在地点的纬度",
          "prefill": "40.7493629"
        },
        "longitude": {
          "type": "string",
          "title": "经度",
          "description": "商家所在地点的经度",
          "prefill": "-73.9942691"
        },
        "main_image": {
          "type": "string",
          "title": "主图",
          "description": "商家在地图上展示的主图链接",
          "prefill": "https://lh3.googleusercontent.com/gps-cs-s/AHRPTWkOsZ8N7i_3JXSlnHI7HdfrJV8F8xhiFLPpXPHGaT7SOxF7-2lyUYcOabd4jijOkjicVFVmwdZXrs07nVepUJMQwjGcVyaS-E-yX8TWpAkkY6KxCOXZJQry1ItlYxvaydYBY8N1RQ=w426-h240-k-no"
        },
        "additional_info": {
          "type": "string",
          "title": "附加信息",
          "description": "商家页展示的属性标签，多个以逗号并列，部分商家没有",
          "prefill": "Identifies as Latino-owned,Identifies as LGBTQ+ owned"
        },
        "accessibility": {
          "type": "string",
          "title": "无障碍设施",
          "description": "商家的无障碍设施信息，如轮椅可达的停车位或洗手间，部分商家没有",
          "prefill": "Wheelchair accessible restroom"
        }
      },
      "required": [],
      "additionalProperties": false
    }
  },
  "execution": {
    "mode": "async",
    "timeout_seconds": 2100,
    "cancel_notify": false,
    "recovers_partial_on_cancel": false
  },
  "knowledge": {
    "when_to_use": [
      "需要按关键词批量获取某地区某类商家的线索清单时",
      "需要商家的名称、类别、地址、电话、官网、评分与营业时间做本地化拓客或门店盘点时"
    ],
    "when_not_to_use": [
      "需要按已知的地图链接采集而非按关键词搜索时——用按链接采集的地图应用",
      "需要秒级返回结果时——本应用在后台执行采集，完成时间取决于商家数量与页数"
    ],
    "failure_handling": [
      "部分数据获取是异步返回的：商家较多时，采集会耗时较长、无法立即返回；请耐心等待抓取完成，任务状态显示「运行中」表示仍在采集，并非异常",
      "任务失败属可重试错误，可原样重新提交",
      "返回空结果通常是关键词过于生僻或该地区无可采集商家，换成「品类 + 地点」的写法重试"
    ]
  },
  "pricing": {
    "events": [
      {
        "event": "record",
        "label": "返回一条商家线索",
        "unit_price": 0.004,
        "qty_from": "",
        "unit_size": 1
      },
      {
        "event": "start",
        "label": "提交一次任务",
        "unit_price": 0.001,
        "qty_from": "",
        "unit_size": null
      }
    ]
  },
  "examples": [
    {
      "id": "basic",
      "goal": "采集纽约市区咖啡店线索，最多 3 条",
      "input": {
        "keyword": "coffee shops in New York",
        "page_turns": 1,
        "max_collected_rows": 3
      },
      "use_as_test": true
    }
  ],
  "published_at": "2026-09-16T09:47:41.791900+00:00",
  "publisher": {
    "id": "WW_Yang",
    "name": "WW_Yang"
  },
  "maintainers": [
    {
      "id": "WW_Yang",
      "name": "WW_Yang"
    }
  ],
  "trust_tier": "community",
  "readme": "想快速拿到某个地区某类商家的名单和联系方式吗？给它一个搜索关键词，它会把地图上这个关键词下的商家一次性取回来，每条带名称、类别、地址、电话、官网、评分、评论数、营业时间和经纬度，可以直接导出成表格，接进你的客户系统或拓客名单。\n\n做本地化拓客、门店盘点或渠道摸排时，最费时的往往是\"一家家点开地图、把电话和地址抄下来\"。这份数据把同一个关键词下的商家批量取回，电话、官网、地址和营业时间都带着，适合当作线索清洗、区域覆盖分析和电话拜访名单的原始底表。\n\n## 数据说明\n\n商家清单取自谷歌地图的公开搜索结果页，按该页原有的展示顺序返回，不做二次排序或去重。评分是商家在地图上展示的评分，满分 5 分；评论数是累计评价条数。电话与官网只在商家页展示时才有，部分商家没有这两项。营业时间按周一到周日逐日给出，每格同时带当天的日期；「当前状态」是取数当时商家的营业情况（如「Closed · Opens 7AM」）。经纬度是商家的实际位置，可用于地图标注或路线规划。「附加信息」是商家的经营属性标签（如女性经营、少数族裔经营），「无障碍设施」是轮椅可达的停车位或洗手间信息，两者都只有部分商家提供。只覆盖公开可见的商家，已关停或需登录才能看到的商家不在其中。数据为取数当时页面展示的快照，评分、评论数与营业状态会随时间变化。\n\n## 结果长什么样\n\n每条记录是一个商家：\n\n| 商家名称 | 主类别 | 电话 | 评分 | 评论数 |\n|---|---|---|---|---|\n| 787 Coffee Co. | Coffee shop | (646) 454-0133 | 4.8 | 5858 |\n| L B Coffee | Coffee shop | (646) 410-2818 | 4.9 | 391 |\n\n另有「地址」「城市」「州/省」「官网」「营业时间（周一至周日）」「经纬度」「当前状态」等字段。\n\n## 应用场景\n\n- 做电话拓客时，用「电话」和「官网」拿到联系方式，按「城市」「州/省」分区域派单。\n- 做区域覆盖分析时，把「纬度」「经度」投到地图上看商家分布疏密，判断哪片区域还是空白。\n- 做门店选址参考时，用「评分」和「评论数」挑出人气旺的商圈，再看同类商家在旁边扎堆的情况。\n- 做拜访排期时，按「营业时间」和「当前状态」避开休息日，把外勤路线排在同一天营业的商家上。\n",
  "favorite_count": 0,
  "labels": {
    "industry": [
      {
        "slug": "general",
        "label": "通用"
      },
      {
        "slug": "local_services",
        "label": "本地生活"
      }
    ],
    "platform": [
      {
        "slug": "google_maps",
        "label": "Google Maps"
      }
    ],
    "content": [
      {
        "slug": "serp",
        "label": "搜索结果"
      }
    ]
  },
  "display_locale": "zh-CN",
  "translation_origin": null,
  "version": "0.1.1"
}