---
name: local-business-site-selection
description: "当用户需要使用咕咕数据公开 API 完成本地生活选址、业务数据组合、参数传递、接口选型或结果校验时使用；不适用于绕过接口详情页、购买规则或人工复核要求的场景。"
---

# 本地生活选址与区域运营 Skill

面向本地生活选址、区域运营分析、门店信息页和城市服务看板的公开 API 组合。

## 业务场景

用于本地生活选址、区域运营分析、门店信息页、城市服务看板和活动排期。适合把行政区划、坐标转换、医院机构、IP 定位、天气、空气质量、日出日落、号码归属、页面性能和搜索可见性组合成区域运营链路。

- 数据范围：覆盖省市区街道村、坐标转换、三甲医院、国内外 IP 定位、天气、空气质量、日出日落、手机归属、页面性能和搜索可见性。
- 关键数据维度：位置维度：国家、省、市、区县、街道、地址、IP、经纬度和坐标系。；运营维度：候选门店、周边机构、活动日期、天气、空气质量和门店 URL。；页面维度：性能、搜索可见性、地区信息和内容完整度。

## 何时使用

- 把候选地址标准化为省市区街道和坐标口径。
- 结合周边机构、天气空气质量和门店页面质量评估区域运营条件。
- 为本地服务页面、门店页和活动页提供位置与内容校验。

## 不适用场景

- 用户只需要查看某一个接口的完整参数、响应字段、价格或购买入口时，直接打开接口详情页。
- 用户希望绕过接口开通、鉴权、配额或人工复核要求时，不应使用 Skill 作为替代。
- 任务需要法律、医疗、金融投资或升学录取的最终决策时，Skill 只能提供数据辅助和复核线索。

## 用户需要提供的信息

- 目标城市、区县、街道、候选地址、经纬度、IP、门店 URL、活动日期和行业类型。
- 输出目标：区域画像、门店页面、选址辅助、天气风险或本地 SEO 检查。
- 调用接口所需的 AppKey、开通状态和接口详情页限制。

## 推荐工作流

1. 先用行政区划、坐标转换和定位接口确认位置口径。
2. 再结合医院等机构数据、天气、空气质量和日出日落补充区域上下文。
3. 最后用页面性能和搜索可见性接口检查门店或城市页面。

## 参数传递关系

- 先用行政区划确定城市、区县和街道层级，再用坐标转换或 IP 定位补齐位置上下文。
- 医院、院校等机构数据可作为周边资源参考，不能直接代表客流或经营结果。
- 日期和城市继续传给天气、空气质量和日出日落接口，用于活动或门店运营提醒。
- 门店 URL 传给页面性能和搜索可见性接口，判断本地页面是否具备基础展示质量。

## 典型任务模板

- 门店选址辅助：输入城市、街道和候选坐标；输出行政区划、周边机构、天气空气质量和复核提示。
- 本地页面检查：输入门店 URL；输出页面性能、可见性、地区信息和内容缺口。
- 活动排期：输入城市和日期；输出天气、日出日落、空气质量和物料建议。

## 接口与关键参数

统一鉴权：调用接口前需要准备咕咕数据 AppKey。推荐在服务端通过 Header 传递 AppKey；历史 Query 参数 `appkey` 仍以接口详情页说明为准。

### 全国省市区街道村信息

- 业务角色：省市区街道村
- 调用阶段：位置基础
- 接口地址：`GET https://api.gugudata.com/location/chinaregions`
- 产出用途：用于标准化行政区划。
- 参数来源：地区参数来自用户输入、行政区划查询结果或定位结果
- 接口资料：详情页 https://www.gugudata.com/api/details/chinaregions；接口 Markdown https://www.gugudata.com/api/details/chinaregions/llm.md

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `regioncode` | 是 | `string` | YOUR_VALUE | 需要查询的父级区域编码，传递 0 获取全国所有省级别数据；编码格式为 00000000，每两位分别对应省、市、区、镇/街道编码（注意：v2 版本会在国家 6 位行政区划标准代码后添加 00 两位编码以保持接口兼容，v3 版本为 12 位编码格式） | 地区参数来自用户输入、行政区划查询结果或定位结果 |
| `version` | 是 | `integer` | 3 | 当传递参数值为 2 时，调用 v2 版本的接口，regioncode 遵循国家行政区划代码标准，同时可返回新增区划中心点坐标。当传递参数值为 3 时，调用 v3 版本的接口（v1 版本主要为了兼容历史用户调用逻辑，新用户强烈建议调用 v3 接口） | 由用户输入、业务筛选条件或上一轮接口结果确定。 |

### 地理坐标系转换

- 业务角色：坐标转换
- 调用阶段：位置基础
- 接口地址：`GET https://api.gugudata.com/location/coordinateconverter`
- 产出用途：用于统一坐标系。
- 参数来源：由用户输入、业务筛选条件或上一轮接口结果确定
- 接口资料：详情页 https://www.gugudata.com/api/details/coordinateconverter；接口 Markdown https://www.gugudata.com/api/details/coordinateconverter/llm.md

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `from` | 是 | `string` | YOUR_VALUE | 原数据的坐标系，可选值：WGS84, GCJ02, BD09 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `to` | 是 | `string` | YOUR_VALUE | 目标数据的坐标系，可选值：WGS84, GCJ02, BD09 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `value` | 是 | `string` | YOUR_VALUE | 需要转换的坐标值，格式为：[120.54,32.74] | 由用户输入、业务筛选条件或上一轮接口结果确定。 |

### 全国三甲医院主体信息

- 业务角色：三甲医院
- 调用阶段：机构参考
- 接口地址：`GET https://api.gugudata.com/location/hospital-3a`
- 产出用途：用于查询周边医疗机构参考。
- 参数来源：地区参数来自用户输入、行政区划查询结果或定位结果；关键词由用户输入或从上一轮内容抽取结果中生成；分页参数由调用方控制，用于分批读取结果
- 接口资料：详情页 https://www.gugudata.com/api/details/hospital-3a；接口 Markdown https://www.gugudata.com/api/details/hospital-3a/llm.md

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `province` | 否 | `string` | - | 省份名称，例如 北京、广东。 | 地区参数来自用户输入、行政区划查询结果或定位结果 |
| `city` | 否 | `string` | - | 城市名称，例如 北京市、广州市。 | 地区参数来自用户输入、行政区划查询结果或定位结果 |
| `district` | 否 | `string` | - | 区县名称，例如 海淀区、天河区。 | 地区参数来自用户输入、行政区划查询结果或定位结果 |
| `keyword` | 否 | `string` | - | 医院名称或别名关键词，支持模糊搜索。 | 关键词由用户输入或从上一轮内容抽取结果中生成 |
| `pageIndex` | 否 | `integer` | 1 | 分页页码，从 1 开始。 | 分页参数由调用方控制，用于分批读取结果 |
| `pageSize` | 否 | `integer` | 20 | 每页数量。 | 分页参数由调用方控制，用于分批读取结果 |

### 国内 IP 地址定位

- 业务角色：国内 IP 定位
- 调用阶段：定位参考
- 接口地址：`GET https://api.gugudata.com/websitetools/iplocation`
- 产出用途：用于粗粒度定位。
- 参数来源：由用户输入、业务筛选条件或上一轮接口结果确定
- 接口资料：详情页 https://www.gugudata.com/api/details/iplocation；接口 Markdown https://www.gugudata.com/api/details/iplocation/llm.md

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `ip` | 是 | `string` | YOUR_VALUE | IP 地址，可以传递 IPv4 或 IPv6 地址 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |

### 国际 IP 地址定位

- 业务角色：国际 IP 定位
- 调用阶段：定位参考
- 接口地址：`GET https://api.gugudata.com/v2/location/ip`
- 产出用途：用于国际 IP 地区参考。
- 参数来源：由用户输入、业务筛选条件或上一轮接口结果确定
- 接口资料：详情页 https://www.gugudata.com/api/details/internationaliplocation；接口 Markdown https://www.gugudata.com/api/details/internationaliplocation/llm.md

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `ip` | 是 | `string` | YOUR_VALUE | IP 地址，可以传递 IPv4 或 IPv6 地址 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |

### 全国天气预报信息

- 业务角色：天气预报
- 调用阶段：环境数据
- 接口地址：`GET https://api.gugudata.com/weather/weatherinfo`
- 产出用途：用于活动或门店天气提醒。
- 参数来源：时间参数来自用户指定日期、业务统计周期或接口支持的历史范围
- 接口资料：详情页 https://www.gugudata.com/api/details/weatherinfo；接口 Markdown https://www.gugudata.com/api/details/weatherinfo/llm.md

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `code` | 是 | `string` | YOUR_VALUE | 地区编码，可通过前置接口查询获得地区编码。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `days` | 否 | `integer` | 1 | 获取天气预报的天数，默认为1，即为当天数据。最大值为7。 | 时间参数来自用户指定日期、业务统计周期或接口支持的历史范围 |

### 全国城市实时空气质量指数

- 业务角色：空气质量
- 调用阶段：环境数据
- 接口地址：`GET https://api.gugudata.com/Weather/AirQuality`
- 产出用途：用于城市空气质量参考。
- 参数来源：地区参数来自用户输入、行政区划查询结果或定位结果
- 接口资料：详情页 https://www.gugudata.com/api/details/airquality；接口 Markdown https://www.gugudata.com/api/details/airquality/llm.md

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `city` | 是 | `string` | 北京 | 需要查询的中国城市名称，例如：北京、南京、上海、广州、深圳。接口会按城市名称实时匹配当前可用监测数据，不再限制为旧版固定城市列表。 | 地区参数来自用户输入、行政区划查询结果或定位结果 |

### 日出与日落时间

- 业务角色：日出日落
- 调用阶段：环境数据
- 接口地址：`GET https://api.gugudata.com/weather/sunriseandsunset`
- 产出用途：用于活动排期和生活服务展示。
- 参数来源：地区参数来自用户输入、行政区划查询结果或定位结果；时间参数来自用户指定日期、业务统计周期或接口支持的历史范围
- 接口资料：详情页 https://www.gugudata.com/api/details/sunrisesunset；接口 Markdown https://www.gugudata.com/api/details/sunrisesunset/llm.md

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `city` | 是 | `string` | YOUR_VALUE | 查询城市名，如北京、南京、保定等 | 地区参数来自用户输入、行政区划查询结果或定位结果 |
| `date` | 是 | `string` | YOUR_VALUE | 查询的日期，格式为 yyyymmdd，如 20220701 | 时间参数来自用户指定日期、业务统计周期或接口支持的历史范围 |

### 手机归属地查询

- 业务角色：手机归属地
- 调用阶段：号码参考
- 接口地址：`GET https://api.gugudata.com/sms/mobileattribution`
- 产出用途：用于门店线索归属地辅助判断。
- 参数来源：号码来自用户输入、表单线索或上一轮内容抽取结果
- 接口资料：详情页 https://www.gugudata.com/api/details/mobileattribution；接口 Markdown https://www.gugudata.com/api/details/mobileattribution/llm.md

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `mobile` | 是 | `string` | YOUR_VALUE | 查询的手机号码 | 号码来自用户输入、表单线索或上一轮内容抽取结果 |

### 网页性能与 SEO 评分

- 业务角色：页面性能评分
- 调用阶段：页面质量
- 接口地址：`GET https://api.gugudata.com/websitetools/pagespeed-score`
- 产出用途：用于检查门店页面质量。
- 参数来源：URL 或域名由用户提供，调用前需要确认协议、跳转和可访问性
- 接口资料：详情页 https://www.gugudata.com/api/details/pagespeed-score；接口 Markdown https://www.gugudata.com/api/details/pagespeed-score/llm.md

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `url` | 是 | `string` | - | 需要检测评分的网页 URL，必须是有效的 HTTP 或 HTTPS 链接，例如：https://www.baidu.com。 | URL 或域名由用户提供，调用前需要确认协议、跳转和可访问性 |
| `strategy` | 否 | `string` | mobile | 检测策略，可选 mobile 或 desktop，默认 mobile。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `locale` | 否 | `string` | zh-CN | 返回语言区域，默认 zh-CN。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `categories` | 否 | `string` | - | 评分类别，可选 performance、accessibility、best-practices、seo；多个值用英文逗号分隔，不传时返回全部类别。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `forceRefresh` | 否 | `boolean` | false | 是否重新检测并刷新结果，默认 false；false 时可优先返回近期已有检测结果。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |

### 搜索可见性 SERP 数据接口

- 业务角色：搜索可见性
- 调用阶段：页面质量
- 接口地址：`POST https://api.gugudata.com/v1/searchVisibilityReports`
- 产出用途：用于观察本地页面可见性。
- 参数来源：URL 或域名由用户提供，调用前需要确认协议、跳转和可访问性；地区参数来自用户输入、行政区划查询结果或定位结果
- 可参考的相关能力：获取搜索可见性报告、搜索可见性报告列表、创建搜索可见性观测任务、搜索可见性观测任务列表、获取搜索可见性观测任务
- 接口资料：详情页 https://www.gugudata.com/api/details/search-visibility；接口 Markdown https://www.gugudata.com/api/details/search-visibility/llm.md

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `domain` | 是 | `string` | - | 需要观测的主域名，长度 1-255。可传 gugudata.com 或 https://www.gugudata.com，系统会按主域名规范化。 | URL 或域名由用户提供，调用前需要确认协议、跳转和可访问性 |
| `brand` | 是 | `string` | - | 品牌或产品名称，长度 1-120。用于匹配标题、摘要和结果链接中的品牌信号。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `queries` | 是 | `array` | - | 需要观测的搜索关键词列表，1-50 个。创建报告会自动创建首个观测任务，按关键词数量计入 credits 计算。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `sources` | 是 | `array` | - | 搜索来源，1-3 个；支持 google_web、bing_web、baidu_web。Google/Bing 在 maxRank=10/20/50 时分别消耗 1/2/5 credits；Baidu 同等排名深度消耗 10/20/50 credits。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `displayName` | 否 | `string` | - | 报告显示名称，便于在列表中识别，不传时可由业务侧使用 brand/domain 展示。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `aliases` | 否 | `array` | - | 品牌别名列表，最多 20 个；用于补充匹配英文名、简称、产品名等品牌信号。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `competitors` | 否 | `array` | - | 竞品域名定义列表，最多 10 个；每项支持 domain、name、aliases，用于计算竞品排名和差距。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `locale` | 否 | `string` | - | 语言区域提示，如 zh-CN、en-US。不同搜索来源会尽量按该提示观测。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `region` | 否 | `string` | - | 地域提示，如 CN、US、HK。不同地域的排名可能不同。 | 地区参数来自用户输入、行政区划查询结果或定位结果 |
| `maxRank` | 否 | `integer` | 20 | 观测排名深度，仅支持 10、20、50，默认 20。Google/Bing 分别消耗 1/2/5 credits，Baidu 分别消耗 10/20/50 credits。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |

完整请求参数、响应字段和调用示例以接口 Markdown 为准：https://www.gugudata.com/api/details/search-visibility/llm.md

## 数据校验与使用边界

- 周边机构和天气只能作为运营参考，不能直接证明客流和收益。
- IP 定位只适合粗粒度判断，不适合个人精确位置。
- 选址决策需要结合线下调研、租金、人流和业务数据复核。

## 输出建议

- 输出区域结果时按行政区划、坐标、周边资源、天气和页面质量分段。
- 对候选地址给出数据缺口和人工复核建议。
- 本地页面建议附带 URL、检查时间和接口来源。

## 常见问题

- 问：什么情况下应该使用这个 Skill？ 答：当用户提出的目标需要多个咕咕数据公开 API 组合完成，而不是只查询一个接口时，优先阅读这个 Skill。
- 问：这个 Skill 是否需要单独购买？ 答：不需要。Skill 文档只负责业务流程和接口选型，具体接口购买、价格和账号权益仍以接口详情页为准。
- 问：Agent 应该怎样使用这个 Skill？ 答：Agent 应先阅读 SKILL.md，确认业务场景和推荐工作流，再进入接口详情页核对参数、响应字段、价格和调用示例。
- 问：调用接口前需要先核对什么？ 答：需要核对业务对象、地区、时间范围、输入格式、必填参数、返回字段、购买状态和接口详情页中的限制说明。
- 问：本地生活选址与区域运营 Skill 会替代接口文档吗？ 答：不会。Skill 负责说明业务组合和调用顺序，接口参数、响应结构、计费和购买入口仍以接口详情页为准。