spots

核心用法

spots 是一个基于 Google Places API 的命令行地点搜索工具，采用网格化扫描策略突破 Google 默认搜索的展示限制。用户可通过地名或精确坐标定位搜索区域，自定义半径范围、商户类型、最低评分等筛选条件，支持将结果导出为 JSON、CSV 或交互式 HTML 地图。核心功能包括：地点搜索（spots "位置" -r 半径 -q 关键词）、评论获取（spots reviews "商户名"）、地图导出（-o map --out 文件.html）。

显著优点

1. 全面性突破：网格扫描机制可发现 Google 常规搜索未优先展示的商户，适合深度探索本地商业生态
2. 灵活筛选：支持评分阈值、评论数量、营业状态等多维度过滤，精准匹配需求
3. 多格式输出：JSON/CSV 便于数据分析，HTML 地图可直接分享或嵌入网页
4. 坐标直输：支持从 Telegram 等应用直接粘贴坐标，提升移动端使用体验
5. 轻量无依赖：纯 Go 编写，单二进制文件部署，跨平台兼容

潜在缺点与局限性

• API 成本：Google Places API 按调用量计费，大规模网格扫描可能产生较高费用
• 覆盖盲区：依赖 Google 地图数据，部分新兴商户或偏远地区可能存在数据滞后
• 无实时同步：结果基于 API 快照，非实时更新，营业状态等信息可能存在延迟
• 功能单一：专注搜索与导出，无路线规划、导航等延伸功能
• 个人项目维护：作者为独立开发者，长期更新与社区支持存在不确定性

适合的目标群体

• 本地生活探索者：寻找小众咖啡馆、独立餐厅等非连锁商户
• 商业分析师：需要批量获取特定区域商户数据进行竞品分析或市场调研
• 内容创作者：旅游博主、本地生活博主需要生成可视化地图素材
• 开发者/数据工程师：需要将地点数据集成到自有系统的技术人员
• 房地产/零售选址：评估目标区域商业配套密度的专业人士

使用风险

• 外部工具依赖：Skill 本身仅为文档说明，实际执行依赖用户自行安装的第三方 CLI，该工具未经广泛安全审计
• API 密钥泄露风险：需配置 Google Places API Key，不当存储可能导致密钥滥用与意外计费
• 数据隐私：搜索行为与位置数据将传输至 Google，受 Google 隐私政策约束
• 网络稳定性：API 调用受网络环境与 Google 服务可用性影响，大规模扫描可能触发速率限制