# geolab

**Repository Path**: geo-lab/geolab

## Basic Information

- **Project Name**: geolab
- **Description**: GEO Lab 是一个 AI 搜索 / GEO 可见性优化平台 
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-29
- **Last Updated**: 2026-06-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# GEO Lab

GEO Lab 是一个 AI 搜索 / GEO 可见性优化平台 MVP，采用三个可独立成仓库的项目拆分：

- `geolab-api`：GoFrame API 服务，负责后台管理接口、数据库读写和任务投递。
- `geolab-worker`：GoFrame Worker 服务，负责 AI 采集、引用解析、品牌分析和 GEO 评分。
- `geolab-admin`：Vue3 管理后台，负责项目、品牌、Query、Run 和 Answer 可视化。

## 架构

```text
geolab-admin -> geolab-api -> PostgreSQL
                    |
                    v
                 Redis Queue -> geolab-worker -> AI Platforms
```

## 本地依赖

```bash
cp .env.example .env
docker compose up -d
```

## 启动 API

```bash
cd geolab-api
go mod tidy
go run .
```

API 默认监听 `http://localhost:8000`。

## 启动 Worker

```bash
cd geolab-worker
go mod tidy
go run . worker
```

手动执行调度：

```bash
go run . scheduler
```

## 启动 Admin

```bash
cd geolab-admin
npm install
npm run dev
```

Admin 默认代理到 `http://localhost:8000`。

## MVP 闭环

1. 在后台创建 Project。
2. 添加自有品牌和竞品。
3. 添加 Query，并选择平台：`mock`、`openai_chatgpt`、`perplexity`。
4. 点击“立即采集”。
5. API 创建 `geo_runs` 并投递 Redis 队列。
6. Worker 消费任务，保存回答和 citations。
7. Worker 执行规则分析并计算 GEO score。
8. 后台查看 Dashboard、Runs、Answer Detail。

## 生产化扩展方向

- 用 Asynq / Temporal 替换简单 Redis list 队列。
- 增加 Gemini、Claude、Google AI Overviews 浏览器采集器。
- 增加 LLM 内容优化建议生成。
- 增加多租户、权限和计费。
- 增加报告导出、告警和周报。