GEO - AI搜索引擎品牌曝光度优化平台
项目简介
GEO（Generative Engine Optimization）是一个SaaS平台，帮助品牌监测其在各大AI搜索引擎中的曝光度和引用情况。支持文心一言、Kimi、通义千问、豆包、讯飞星火、天工、清言等主流国内AI平台，以及通用搜索引擎。
核心功能
- 多平台品牌引用监测：同时覆盖8个主流AI搜索平台
- 定时自动查询与即时查询：支持按日/周频率自动执行，也可手动触发
- 品牌匹配分析：精确匹配、别名匹配、模糊匹配三级策略
- 竞品引用检测：监测竞争对手在同一查询中的引用情况
- 数据可视化：引用趋势图、平台对比图等多维度图表
- CSV/PDF报告导出：一键生成专业数据报告
- 用户管理与权限控制：JWT认证、邮箱验证、密码管理
- 订阅套餐管理：基于套餐的查询词数量限制
- 管理后台：系统级用户与数据管理
技术栈
| 组件 |
技术 |
| 前端 |
Next.js 14, React 18, TailwindCSS, shadcn/ui, Recharts |
| 后端 |
Python FastAPI, SQLAlchemy 2.0 (async), Pydantic v2 |
| 数据库 |
PostgreSQL 15, Redis 7 |
| 认证 |
JWT + NextAuth.js |
| 任务调度 |
APScheduler |
| 浏览器自动化 |
Playwright |
| 容器化 |
Docker Compose |
快速开始
Docker 方式（推荐）
# 1. 克隆仓库
git clone <repository-url>
cd GEO
# 2. 复制环境变量
cp .env.example .env
# 3. 启动所有服务
docker-compose up -d
# 4. 访问应用
# 前端: http://localhost:3000
# 后端 API: http://localhost:8000
# API 文档: http://localhost:8000/docs
本地开发
后端
cd backend
python3 -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate
pip install -r requirements.txt
alembic upgrade head
uvicorn app.main:app --reload --port 8000
前端
cd frontend
npm install
npm run dev
项目结构
GEO/
├── backend/ # FastAPI 后端服务
│ ├── alembic/ # 数据库迁移脚本
│ ├── app/
│ │ ├── api/ # API 路由层
│ │ │ ├── auth.py # 认证接口
│ │ │ ├── queries.py # 查询词管理接口
│ │ │ ├── citations.py # 引用数据接口
│ │ │ ├── reports.py # 报告导出接口
│ │ │ └── deps.py # 依赖注入
│ │ ├── middleware/ # 中间件
│ │ │ ├── rate_limit.py # 限流中间件
│ │ │ └── logging_middleware.py
│ │ ├── models/ # SQLAlchemy 数据模型
│ │ │ ├── user.py
│ │ │ ├── query.py
│ │ │ ├── citation_record.py
│ │ │ ├── query_task.py
│ │ │ └── subscription.py
│ │ ├── schemas/ # Pydantic 数据校验
│ │ ├── services/ # 业务逻辑层
│ │ ├── workers/ # 任务调度与引擎
│ │ │ ├── scheduler.py # APScheduler 定时任务
│ │ │ ├── citation_engine.py
│ │ │ └── platforms/ # 各平台适配器
│ │ ├── config.py # 应用配置
│ │ ├── database.py # 数据库连接
│ │ └── main.py # 应用入口
│ ├── requirements.txt
│ └── Dockerfile
├── frontend/ # Next.js 前端应用
│ ├── app/
│ │ ├── (auth)/ # 认证相关页面
│ │ │ ├── login/
│ │ │ ├── register/
│ │ │ ├── forgot-password/
│ │ │ └── reset-password/
│ │ ├── (dashboard)/ # 仪表盘页面
│ │ │ └── dashboard/
│ │ │ ├── queries/
│ │ │ ├── citations/
│ │ │ ├── reports/
│ │ │ └── settings/
│ │ ├── api/auth/[...nextauth]/
│ │ ├── layout.tsx
│ │ └── page.tsx
│ ├── components/
│ │ ├── ui/ # shadcn/ui 组件
│ │ ├── charts/ # Recharts 图表组件
│ │ └── layout/ # 布局组件
│ ├── lib/ # 工具函数与API客户端
│ └── package.json
├── tests/ # 后端测试
├── docker-compose.yml
├── .env.example
└── README.md
API 概览
| 模块 |
路径前缀 |
说明 |
| 认证 |
/api/v1/auth |
注册、登录、密码管理、邮箱验证、用户资料 |
| 查询管理 |
/api/v1/queries |
查询词CRUD、立即查询 |
| 引用数据 |
/api/v1/citations |
引用记录查询、统计分析 |
| 报告导出 |
/api/v1/reports |
CSV报告生成与下载 |
完整的 API 端点列表请参阅 backend/README.md。
环境变量
| 变量名 |
说明 |
示例 |
DATABASE_URL |
PostgreSQL 连接字符串 |
postgresql+asyncpg://postgres:postgres123@db:5432/geo_platform |
REDIS_URL |
Redis 连接地址 |
redis://redis:6379/0 |
JWT_SECRET |
JWT 签名密钥 |
your-secret-key-change-in-production |
JWT_EXPIRE_HOURS |
JWT 过期时间（小时） |
24 |
NEXT_PUBLIC_API_URL |
前端调用后端 API 地址 |
http://localhost:8000 |
PLAYWRIGHT_BROWSERS_PATH |
Playwright 浏览器路径 |
/ms-playwright |
ZHIPU_API_KEY |
智谱AI API 密钥（可选） |
- |
TONGYI_API_KEY |
通义千问 API 密钥（可选） |
- |
CORS_ORIGINS |
允许的跨域来源 |
http://localhost:3000 |
许可证
MIT
47879a11f7