spots

核心用法

spots 是一款命令行工具，采用网格化穷举扫描策略突破Google Places的推荐过滤机制。其核心流程为：将目标区域划分为密集网格单元 → 对每个单元独立发起API查询 → 聚合多语言关键词结果（如breakfast/brunch/ontbijt）→ 基于Haversine公式精确过滤距离 → 按地点ID去重输出。

显著优点

1. 发现盲区：可捕获Google算法因「不够热门」或「未付费推广」而压制的隐藏商户
2. 多语言覆盖：内置跨语言关键词扩展，提升非英语地区的召回率
3. 精确地理过滤：使用Haversine公式计算真实距离，替代Google模糊的「附近」判定
4. 灵活输出：支持JSON/CSV/交互式HTML地图三种格式，便于数据分析和可视化
5. 零依赖安装：提供预编译二进制文件，Go开发者亦可源码安装

潜在缺点与局限性

• API成本高昂：网格扫描策略导致请求量呈指数级增长，大规模区域搜索将快速消耗配额
• 覆盖盲区风险：过小的网格单元可能遗漏跨边界的地点，过大则增加冗余
• 无实时校验：依赖Google Places数据本身，不验证商户实际营业状态
• 功能单一：专注地点枚举，缺乏路线规划、导航等配套功能

适合人群

• 本地生活探索者（寻找小众餐厅、咖啡馆）
• 市场研究员（竞品网点普查、商圈饱和度分析）
• 旅行规划师（穷举目的地全部可选商户）
• 数据 journalists（调查性报道中的商户分布取证）

常规风险

• API密钥泄露：需配置GOOGLE_PLACES_API_KEY，硬编码或日志泄露可能导致密钥被盗刷
• 账单失控：网格密度与搜索半径组合不当会产生意外高额账单，建议配合预算告警使用
• 合规灰色地带：批量爬取行为可能触达Google Places服务条款边界，存在API限流或封禁风险
• 数据时效性：输出结果不含抓取时间戳，过期数据可能导致用户扑空

核心用法

spots 是一款基于网格扫描技术的 Google Places 搜索增强工具，通过将搜索区域划分为多个小单元格，对每个单元格独立发起查询，突破 Google 默认的"相关性优先"算法限制，实现区域商户的全量检索。

核心工作流程包括：区域网格化 → 多关键词并行检索 → 按 Place ID 去重 → 基于 haversine 公式的精确距离过滤。用户可通过坐标或地点名称定义搜索中心，支持半径、评分阈值、营业状态等多维筛选，输出格式涵盖 JSON、CSV 及交互式地图。

显著优点

1. 算法穿透能力：有效发现 Google 默认搜索中被降权的"长尾"商户，特别是新开业、低流量但高评分的小店
2. 多语言关键词策略：内置多语种同义词扩展（如 breakfast/brunch/ontbijt），提升非英语地区的召回率
3. 精确地理控制：基于 haversine 公式的距离计算优于 Google 的模糊"附近"语义
4. 开源透明：底层 CLI 工具源码公开，可审计无黑箱

潜在缺点与局限性

• 依赖外部 API：需自行申请 Google Places API 并承担调用费用，无内置配额管理
• 纯文档型 Skill：无可执行代码，仅提供安装指引，实际功能完全依赖外部二进制
• T3 来源可信度：个人开发者项目，无企业级维护承诺，长期更新存在不确定性
• 安装链风险：官方推荐通过 curl | tar 安装预编译二进制，存在供应链攻击暴露面

适合人群

城市探索者、本地生活博主、餐饮投资人、竞品调研分析师，以及任何对"Google 没告诉你的好地方"有强需求的用户。

常规风险

• API 密钥泄露风险：需通过环境变量配置 GOOGLE_PLACES_API_KEY
• 安装提权操作：文档示例包含 sudo mv，建议改用用户级目录安装
• 数据隐私：搜索数据发送至 Google Cloud，受 Google 隐私政策约束