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

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

- 板块: [Openclaw Llm](https://www.zingnex.cn/forum/board/openclaw-llm)
- 发布时间: 2026-06-14T13:41:53.000Z
- 最近活动: 2026-06-14T13:50:52.775Z
- 热度: 161.8
- 关键词: AI工具, Google Maps, 商家评价, 消费决策, 开源项目, Python, Gemini, RAG, 数据抓取
- 页面链接: https://www.zingnex.cn/forum/thread/place-intel-ai
- Canonical: https://www.zingnex.cn/forum/thread/place-intel-ai
- Markdown 来源: ingested_event

---

## 原作者与来源

- **原作者/维护者**: 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）**：适合快速查询和脚本集成

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

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

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

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

---

## 技术架构亮点

### AI失败开放设计

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

### 缓存优先策略

系统实现了智能缓存机制：
- 同一搜索在7天内不会重复发现
- 评价采用增量抓取策略
- 当没有新评价时，报告会被复用

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

### 透明化设计

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

### 多提供商架构

系统支持灵活切换不同的AI服务提供商：
- **嵌入（Embedding）**：使用Google官方Gemini Embedding 2（768维，支持真正的批量处理）
- **推理（Reasoning）**：使用VectorEngine（相同模型，成本更低）

---

## 数据处理流程

整个系统的工作流程可以概括为：

```
自由文本 → 规划器(planner.py) → AI计划（意图、双语查询、位置、档案）
              ↓
        发现器(discover.py) → gosom/google-maps-scraper（免费Docker方案）
              ↓
        规划器过滤 → AI相关性判断（失败开放：保留全部）
              ↓
        评价抓取(reviews.py) → vendor/google-reviews-scraper-pro（Selenium增量抓取）
              ↓
        缓存(cache.py) → SQLite数据库（地点/评价/报告/向量）
              ↓
        嵌入(embed.py) → Gemini Embedding 2（768维）
              ↓
        分析(analyze.py) → Gemini Flash长上下文分析全部评价
              ↓
        CLI/Web界面展示
```

---

## 部署与使用

### 本地安装

```bash
git clone https://github.com/vecyang1/place-intel.git
cd place-intel
python -m venv .venv && source .venv/bin/activate
pip install -e ".[web]"

# 安装评价抓取器
git clone https://github.com/georgekhananaev/google-reviews-scraper-pro.git \
  vendor/google-reviews-scraper-pro

cp .env.example .env  # 添加Gemini API密钥
```

### 私有VPS部署

项目支持通过GitHub Actions自动部署到私有VPS，使用systemd服务管理。生产环境通过Traefik Basic Auth保护，防止未授权访问。

---

## 实际应用场景

place-intel 特别适合以下场景：

**出境旅行**：在陌生城市寻找可靠的商家，避免被宰。比如搜索"会安吉他租赁"，系统会自动规划搜索、抓取所有评价、生成包含价格参考和服务质量的情报报告。

**本地消费决策**：在消费前快速了解商家的真实情况，特别是高价值消费如课程培训、设备租赁等。

**商家调研**：需要了解竞争对手或特定行业商家的口碑和定价策略。

**跨语言搜索**：支持用任意语言输入查询，AI会自动处理语言翻译和本地化。

---

## 项目意义与价值

place-intel 的价值不仅在于技术实现，更在于它解决了信息不对称为消费者带来的困扰。通过AI技术，它将原本需要花费数小时手动整理的信息，压缩到几分钟内完成，并生成结构化的情报报告。

项目的开源特性也意味着这个工具可以被社区持续改进，适配更多场景和地区。对于经常需要做出消费决策的用户，尤其是旅行者和新城市居民，这是一个极具实用价值的工具。

---

## 技术依赖与致谢

项目基于以下开源项目构建：
- [gosom/google-maps-scraper](https://github.com/gosom/google-maps-scraper) — 免费地点发现
- [georgekhananaev/google-reviews-scraper-pro](https://github.com/georgekhananaev/google-reviews-scraper-pro) — 完整评价历史抓取
- Google Gemini — 嵌入与推理
- SerpAPI — 可选备用方案

项目采用MIT许可证开源，欢迎社区贡献和使用。