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

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

业务场景

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

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

何时使用

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

不适用场景

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

用户需要提供的信息

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

推荐工作流

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

参数传递关系

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

典型任务模板

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

接口与关键参数

统一鉴权：调用接口前需要准备咕咕数据 AppKey。AppKey 应从环境变量或凭据管理系统注入，不要写入 SKILL.md、代码仓库、URL、日志或对话正文。推荐在服务端通过 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

关键请求参数：

地理坐标系转换

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

关键请求参数：

全国三甲医院主体信息

• 业务角色：三甲医院
• 调用阶段：机构参考
• 接口地址：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

关键请求参数：

国内 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 地址定位

• 业务角色：国际 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

关键请求参数：

全球天气预报信息

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

关键请求参数：

多地区实时空气质量

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

关键请求参数：

日出与日落时间

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

关键请求参数：

手机归属地查询

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

关键请求参数：

网页性能与 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

关键请求参数：

搜索可见性 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

关键请求参数：

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

失败处理与恢复

• 缺少必填输入或数据口径不明确时，停止调用并先向用户补齐信息。
• 收到 401 或 403 时，检查 AppKey、安全配置和服务权限；不要在输出中回显凭据。
• 收到 429 时，遵守接口返回的限流提示，降低频率后再试，不要并发放大请求。
• 遇到网络或 5xx 异常时，只对幂等请求进行有限次数重试，并记录失败接口与时间。
• 数据为空或多接口结果冲突时，返回已确认事实、证据缺口和复核建议，不要臆造结论。

数据校验与使用边界

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

输出建议

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

常见问题

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