（6517期）Map Search – 三网聚合·智能搜附近

三网聚合·智能搜附近 聚合高德、百度、腾讯三大国产地图API，支持关键词搜索与附近定位，灵活配置优先级与密钥来源 使用说明 核心用法 map-search 是一款面向中国用户的本地生活地图聚合搜索工具，通过统一接口调用高德、百度、腾讯三大地图服务。支持两种调用模式： 关键词搜索：按城市/区域检索 POI，如「咖啡馆 上海」 附近搜索：基于 IP 自动定位或指定经纬度，检索周边服务设施 配置层面提供双轨制密钥管理——优先读取 ~/.config/openclaw/mapconfig.json 中的 apikeys 与 priority 字段，若配置缺失则回退至环境变量。搜索顺序遵循 priority 数组，首个返回有效结果即停止，避免无效调用浪费配额。 CLI 封装后可直接作为系统命令使用，输出格式简洁，包含名称、地址、距离（附近模式）等核心字段。 显著优点 国产适配：深度对接三大本土地图服务商，POI 数据贴合中国场景，比 Google Maps 更适合国内使用 多源冗余：单平台 API 故障或限流时自动降级，提升可用性 灵活配置：JSON 配置 + 环境变量双通道，支持 CI/CD 无侵入部署 零依赖轻量：仅依赖标准库 os、json 与 requests，无复杂框架 扩展友好：代码结构清晰，新增地图源仅需实现统一接口即可接入 潜在局限 密钥门槛：三平台均需独立申请 API Key，个人开发者需完成企业认证或面临调用额度限制 数据异构：各平台返回字段存在差异（如百度 location 为字符串 "lat,lng"，高德为逗号分隔），聚合时需额外标准化 IP 定位依赖：附近搜索的自动定位依赖高德 IP 定位服务，精度约城市级，室内场景偏差较大 缺乏持久化：无本地缓存机制，重复搜索将消耗 API 配额 CLI 体验有限：相比交互式地图应用，纯文本输出对路径规划、导航场景支持不足 适合人群 需要批量查询 POI 信息的自动化脚本开发者 构建本地生活类 Bot/Agent 的 AI 应用开发者 对数据新鲜度要求高、愿承担 API 成本的商业分析人员 已持有三平台 API Key 的企业级用户 常规风险 | 风险类型 | 说明 | 缓解建议 ||---------|------|---------|| 密钥泄露 | API Key 以明文存储于配置文件或环境变量 | 使用密钥管理服务（如 AWS Secrets Manager），配置目录设 600 权限 || 过度调用 | 无速率限制逻辑，高频调用易触发平台限流 | 增加指数退避重试，监控 HTTP 429/403 状态码 || 数据合规 | 地理位置属敏感个人信息，需符合《个人信息保护法》| 匿名化处理用户坐标，明确告知数据使用范围 || 服务依赖 | 任一平台 API 变更或下线将影响功能 | 定期回归测试，订阅平台变更公告 || 超时阻塞 | requests.get 默认无超时重传，网络抖动易挂死 | 已设 5 秒超时，建议增加异常捕获与降级逻辑 | 综合评估 该 Skill 定位精准，填补了国产地图聚合工具的生态空白，适合作为后端服务或自动化工作流的组件。若用于生产环境，建议补充缓存层、熔断机制及字段标准化中间件。 原始说明 更适合中国体质宝宝的地图搜索工具，支持高德、百度、腾讯地图聚合搜索。