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 服务可用性影响，大规模扫描可能触发速率限制

核心用法

spots 是一个封装了同名 Go 二进制工具的 Claude Skill，专注于穷尽式地点搜索——通过网格化扫描策略突破 Google Places 常规搜索的结果数量限制，挖掘那些被算法隐藏的店铺。

基础调用支持两种定位模式：地名搜索（"Arnhem Centrum"）或坐标直接输入（-c 51.9817,5.9093）。核心参数包括搜索半径（-r，默认 500 米）、关键词过滤（-q）、最低评分（--min-rating）与营业状态（--open-now）。结果可导出为 JSON（默认）、CSV 或交互式 HTML 地图（-o map），后者适合实地探店前的路线规划。

进阶功能包含评论抓取（spots reviews）与多关键词组合搜索，满足餐饮探索、商业地产调研、旅行攻略制作等场景。

显著优点

1. 突破搜索天花板：传统 Google Places 搜索存在隐性结果上限，网格扫描技术理论上可覆盖半径内全部 POI
2. 精准过滤体系：评分门槛、评论数量、实时营业状态三维筛选，减少无效信息
3. 可视化输出：HTML 地图导出功能直观呈现空间分布，优于纯文本列表
4. 隐私可控：坐标可由用户通过 Telegram 等渠道自主分享，不强制请求定位权限

潜在局限

• 外部依赖门槛：需自行申请 Google Places API + Geocoding API，免费额度存在月度限制（约 5000 次请求）
• 二进制信任链：实际执行依赖用户本地安装的 spots 二进制，版本一致性需自行维护
• 地理覆盖盲区：Google Places 本身对部分地区（尤其是非欧美区域）的 POI 收录不完整
• API 成本风险：大半径、细粒度网格扫描可能快速消耗免费配额

适合人群

• 餐饮/咖啡爱好者寻找隐藏店铺
• 商业地产从业者进行竞品调研
• 旅行规划者构建深度城市指南
• 需要超越常规地图应用结果限制的数据采集者

常规风险

1. API 密钥泄露：GOOGLE_PLACES_API_KEY 需通过环境变量配置，存在意外提交至版本控制的历史教训
2. 位置数据外泄：坐标与搜索关键词上传至 Google 服务器，敏感区域（如私人场所附近）的查询需谨慎
3. 结果完整性幻觉："穷尽"是相对于常规搜索的概念，仍受 Google 数据层本身覆盖率的硬约束