goplaces

核心用法

goplaces 是一款面向 Google Places API (New) 的现代化命令行工具，提供人类可读的默认输出与 --json 机器解析格式。核心功能包括：文本搜索（goplaces search）、地点解析（goplaces resolve）、详情查询（goplaces details）及评论获取。支持地理位置偏置（经纬度+半径）、实时营业状态过滤、评分阈值筛选、价格等级过滤等高级参数，并具备分页能力处理大量结果。

显著优点

1. 双模式输出设计：默认彩色人类友好格式，加 --json 即可切换为脚本自动化所需的结构化数据，兼顾交互与工程场景。
2. 参数丰富灵活：支持 --open-now、、--min-rating、、--type 等多维过滤，以及 --lat//--lng//--radius-m 地理围栏，满足精准定位需求。
3. 安装便捷：通过 Homebrew 一键安装，依赖管理标准化，降低环境配置成本。
4. 功能覆盖完整：涵盖搜索、解析、详情、评论四大核心场景，基本满足地点信息查询的全链路需求。

潜在缺点与局限性

1. 外部依赖单一：核心功能完全依赖 goplaces 二进制文件，若上游停更或出现兼容性问题，Skill 将失效。
2. 类型过滤限制：--type 参数仅发送首个值（API 本身限制），复杂多类型筛选需多次调用。
3. 网络与地域限制：需稳定访问 Google Places API，部分网络环境可能无法使用；查询数据出境至 Google，存在合规考量。
4. 成本门槛：Google Places API 为付费服务（虽有免费额度），高频使用需关注账单。

适合的目标群体

• 开发者：需要快速验证地点数据、集成地理信息到脚本或 CI/CD 流程的工程师。
• 数据分析师：获取结构化 POI 数据用于市场研究、竞品分析或数据清洗。
• 终端效率用户：习惯命令行操作、需要快速查询周边商户信息的个人用户。

使用风险

1. API Key 泄露风险：GOOGLE_PLACES_API_KEY 为敏感凭证，硬编码或误提交至版本控制可能导致滥用与费用损失。
2. 依赖项维护风险：个人开发者维护的 CLI 工具（T3 来源）更新频率与长期支持存在不确定性。
3. 数据隐私风险：所有查询内容明文发送至 Google，敏感地点搜索可能暴露用户意图或商业机密。
4. 性能瓶颈：大规模分页查询或高并发调用可能触发 API 速率限制，需自行实现退避重试逻辑。

goplaces 技能综合评估

goplaces 是一个将现代 Google Places API（新版）封装为简洁命令行工具的 Agent Skill，由知名 iOS/macOS 技术专家 Peter Steinberger（PSPDFKit 创始人）开发维护。该 Skill 本身为纯声明式 Markdown 封装（仅 41 行，2 个文件），不含可执行代码或脚本，通过直接调用已安装的 goplaces CLI 二进制实现地点搜索、详情查询、地址解析和评论获取等全部核心功能。

核心用法

支持通过结构化参数进行文本搜索（search）、坐标偏离搜索、分页查询、地址解析（resolve）和详情查询（details），并可随时切换人性化输出与 JSON 格式以适配不同场景。仅需配置一个 GOOGLE_PLACES_API_KEY 环境变量即可运行，与任何支持 CLI 工具调用的 Agent 或脚本环境无缝集成。

显著优点

1. 极简设计：Skill 文件极其精简，无额外依赖声明，安装即用，认知负担极低。
2. 安全可信：整份安全认证报告未检出任何后门、数据外泄、提示词投毒或权限升级等威胁，所有硬编码扫描均为零命中，行为与声明完全一致。
3. 来源可靠：开发者为技术社区公认的资深专家，维护者的 GitHub 信誉和技能代码透明度均为顶级，来源可信度评 T2。
4. 输出灵活：默认人性化输出适合快速探索，--json 参数可以无缝嵌入脚本、管道或 Agent 工作链路。

潜在缺点或局限性

1. API 费用依赖：所有操作均依赖 Google Places API（新版）的实时调用，会产生 Google Cloud 费用，未内置缓存或离线策略。
2. 单一供应商锁定：功能完全依赖于 Google 服务，无法切换至其他地图或地点数据源。
3. 二进制分发风险：goplaces CLI 通过维护者个人 Homebrew tap 分发，缺乏官方认证的签名校验机制，存在间接供应链风险。
4. 类型过滤限制：--type 参数仅支持传入单一值（受 API 限制），无法进行复合类型过滤。

适合的目标群体

• 需要构建地点、地图、本地搜索或物流相关 Agent 应用的开发者。
• 需要编写地点数据采集、分析或监控脚本的数据工程人员。
• 需要快速实验 Google Places API（新版）功能或用例的解决方案架构师。
• 任何倾向于在 CLI 环境中处理地理位置数据的效率工具用户。

使用该技能可能存在的常规风险

1. 性能与成本：频繁调用 Google Places API 可能导致较高的延迟（网络往返）和不可忽视的使用费用，尤其在批量查询时需审慎设计调用频率和缓存策略。
2. 依赖项风险：技能完全依赖外部二进制 goplaces 的正确安装和持续维护，若上游仓库停止更新或 Homebrew tap 失效，技能将即刻失效。
3. API Key 安全：需自行保障 GOOGLE_PLACES_API_KEY 的存储和传输安全，若 Key 泄露可能导致未经授权的费用消耗或配额耗尽。
4. 数据合规：搜索和查询行为中若涉及个人位置数据或受 GDPR 等法规约束的敏感信息，需由调用方自行处理合规性问题，Skill 本身未提供数据匿名化或审计能力。