# Brand Cited

**Repository Path**: auralink/brand-cited

## Basic Information

- **Project Name**: Brand Cited
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-25
- **Last Updated**: 2026-07-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# GEO Suite Desktop

品牌可见性优化平台 — 检测你的品牌内容是否被 AI 大模型引用。

## 核心功能

- **品牌管理** — 创建品牌，设置类别（软件/消费/企业/媒体/教育/生活/金融/医疗），自动匹配提问模板
- **GEO 检测** — 抓取文章 → 提取关键词 → 生成模拟用户提问 → 向多个 AI 平台提问 → 检测是否引用原文 → 计算 GEO 评分
- **GEO 指标** — 提及覆盖率(ER) + 精准引用占比(PR) + 跨平台一致性(CR) + 综合得分
- **多平台** — 支持 DeepSeek / 豆包 / Kimi，可配置 API 调用或浏览器操作模式
- **历史报告** — 查看历史检测记录和详细结果

## 快速开始

```powershell
cd backend
uv sync
uv run uvicorn app.main:app --reload --port 8000
```

访问 http://localhost:8000 即可打开前端界面。

### 桌面模式

```powershell
cd backend
uv run python desktop.py
```

## 配置 LLM 平台

在设置页面中配置各 AI 平台的 API Key：

| 平台 | 模式 | 说明 |
|------|------|------|
| **DeepSeek** | 🔌 API / 🌐 浏览器 | `api.deepseek.com` |
| **豆包** | 🔌 API / 🌐 浏览器 | `ark.cn-beijing.volces.com` |
| **Kimi** | 🔌 API / 🌐 浏览器 | `api.moonshot.cn` |

- **API 模式**：需要填写 API Key，直接调用接口
- **浏览器模式**：需要配置全局 CDP 地址，操作浏览器获取回答
- 未填写 API Key 时自动切换为浏览器模式

## 技术栈

- **后端**: Python FastAPI (异步)
- **数据库**: SQLite（零配置，自动创建）
- **缓存**: 内存缓存（Redis 可选，自动降级）
- **前端**: 原生 HTML/CSS/JS（pywebview 桌面端）
- **AI 调用**: 纯 httpx（OpenAI 兼容接口）+ 浏览器 CDP 操作

## 项目结构

```
backend/
├── app/
│   ├── main.py              # 应用入口
│   ├── core/                # 配置、数据库、缓存、安全、中间件
│   ├── models/              # SQLAlchemy 模型
│   ├── schemas/             # Pydantic 请求/响应模型
│   ├── api/v1/              # HTTP 路由层
│   │   ├── auth.py          # 认证
│   │   ├── brands.py        # 品牌 CRUD
│   │   ├── detection.py     # GEO 检测
│   │   └── settings.py      # LLM 平台设置
│   └── modules/             # 业务服务层
│       ├── auth/
│       ├── brands/
│       ├── detection/
│       └── settings/
├── geo_engine/              # GEO 检测核心引擎
│   ├── crawler.py           # 文章抓取
│   ├── keyword_extractor.py # 关键词提取 + 提问生成
│   ├── detector.py          # 双层引用检测
│   ├── scorer.py            # GEO 指标计算
│   └── llm_client.py        # 大模型调用客户端
├── static/                  # 前端界面
│   ├── index.html
│   ├── css/style.css
│   └── js/app.js
└── desktop.py               # pywebview 桌面启动器
```

## API 文档

访问 http://localhost:8000/docs 查看交互式 API 文档。

## 许可证

专有软件。