place-intel：AI驱动的本地商家情报工具，进店前掌握全部评价

一个开源的AI原生工具，能够自动抓取Google Maps商家的完整评价历史，生成包含价格情报、关键事实和红旗预警的详细报告，帮助用户在消费前做出明智决策。

• 原作者/维护者: vecyang1
• 来源平台: GitHub
• 原始标题: place-intel
• 原始链接: https://github.com/vecyang1/place-intel
• 发布时间: 2026年6月14日

---

在日常消费决策中，我们经常会遇到信息不对称的问题：去一家新店之前，很难快速了解真实的价格水平、服务质量以及潜在的风险点。Google Maps虽然提供了商家信息和评价，但官方API限制每次只能获取5条评价，而且需要手动翻阅大量评论才能形成完整的认知。

更麻烦的是，当我们去国外旅行或在陌生城市消费时，语言障碍让这个过程变得更加困难。如何能够快速、全面地掌握一家商家的真实情况，成为了许多消费者的痛点。

---

place-intel 是一个AI原生的本地商家情报工具，它的核心理念是："进店之前，先读完它的几百条评价"（Walk in Armed）。用户只需要用任意语言输入搜索需求，比如"会安吉他租赁"，AI会自动完成以下全流程：

1. 智能搜索规划：将自由文本翻译为双语Google Maps查询
2. 精准地点发现：提取地理位置，发现相关商家
3. 智能过滤：用AI判断每个候选商家的相关性，并说明过滤原因
4. 完整评价抓取：突破API限制，抓取数百条完整评价历史
5. 本地缓存与嵌入：将评价存储在本地SQLite数据库，并生成语义向量
6. AI情报报告：使用Gemini模型生成包含价格情报、硬信息核实、红旗预警的详细报告

---

place-intel 提供了三种主要的使用方式，满足不同场景需求：

命令行工具（CLI）：适合快速查询和脚本集成

placeintel scout "会安 吉他租赁"      # AI自动规划搜索
placeintel shop "D'Class Guitar" --near "Hoi An"  # 单店深度分析
placeintel ask "哪家有耐心的老师?"     # 基于缓存的RAG问答

Web应用：提供可视化界面和实时进度展示

Web应用包含四个核心视图：

• 侦察（Scout）：自由文本搜索，展示AI规划过程和每个阶段的实时时间线
• 单店（Shop）：针对特定商家的深度档案
• 资料库（Library）：已缓存的商家和过往搜索，支持跨店检索
• 提问（Ask）：基于RAG技术的跨店问答

程序化API：可以集成到其他应用和工作流中

---

整个系统采用"失败开放"（fail-open）设计理念：当LLM服务不可用时，系统会降级为原始查询直通模式，绝不会阻塞抓取流程。这种设计确保了工具的核心功能在任何情况下都能正常工作。

系统实现了智能缓存机制：

• 同一搜索在7天内不会重复发现
• 评价采用增量抓取策略
• 当没有新评价时，报告会被复用

这种设计大幅降低了对API的调用频率，既节省了成本，又提升了响应速度。

每个处理阶段都会生成事件 {t, stage, msg}，在CLI和Web界面中实时展示为时间线，包括每个商家被排除的具体原因。这种透明化让用户完全了解AI的决策过程。