# 1688-analyzer

**Repository Path**: alenzhai/1688-analyzer

## Basic Information

- **Project Name**: 1688-analyzer
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-07
- **Last Updated**: 2026-03-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 1688 商品猎手 💪

为 Alen 定制的 1688 自动搜索 + 智能分析 + 后端推送浏览器插件。

## 功能特点

- 🔍 **手动输入关键词** - 批量搜索商品
- 🎯 **智能筛选** - 价格、起订量、供应商年限、响应率、48h 揽收率
- 📊 **质量评分** - 基于 48h 揽收率、响应率、供应商年限
- 💰 **性价比评分** - 基于价格和起订量
- 📤 **推送后端** - 自动发送分析结果到本地服务器
- 🌐 **多浏览器支持** - Chrome / Firefox / Edge

## 项目结构

```
1688-analyzer/
├── plugin/           # 浏览器插件
│   ├── src/
│   │   ├── popup.tsx      # 设置界面
│   │   ├── popup.css      # 样式
│   │   ├── content.ts     # 搜索结果抓取 + 分析
│   │   └── background.ts  # 后台服务
│   └── package.json
├── server/           # 后端服务
│   ├── index.js         # Express 服务器
│   ├── package.json
│   └── data/            # 保存的商品数据
└── README.md
```

## 快速开始

### 1. 安装插件依赖

```bash
cd plugin
pnpm install
```

### 2. 启动后端服务

```bash
cd server
pnpm install
pnpm start
```

后端运行在 `http://localhost:3000`

### 3. 开发/构建插件

```bash
cd plugin
pnpm dev      # 开发模式
pnpm build    # 构建生产版本
```

### 4. 安装到浏览器

**Chrome/Edge:**
1. 打开 `chrome://extensions/`
2. 开启"开发者模式"
3. 点击"加载已解压的扩展程序"
4. 选择 `plugin/build/chrome-mv3-dev` 目录

## 使用方法

1. **启动后端服务**（必须先运行）
   ```bash
   cd server
   pnpm start
   ```

2. **点击插件图标** 打开设置界面

3. **输入搜索关键词**（每行一个）
   ```
   手机壳
   数据线
   充电器
   ```

4. **设置筛选条件**（可选）
   - 价格范围
   - 最小起订量
   - 供应商年限
   - 响应率 ≥
   - 48h 揽收率 ≥

5. **点击"开始搜索"**
   - 自动打开 1688 搜索页面
   - 抓取搜索结果
   - 分析评分
   - 发送到后端

6. **查看结果**
   - 数据保存在 `server/data/` 目录
   - 或访问 `http://localhost:3000/api/products` 查看历史数据

## API 接口

### POST /api/products
接收商品数据

**请求体:**
```json
{
  "timestamp": "2026-03-07T15:00:00.000Z",
  "keywords": "手机壳",
  "criteria": { ... },
  "products": [ ... ]
}
```

### GET /api/products
获取历史数据列表

### GET /api/products/:filename
获取单个文件详情

### DELETE /api/products/:filename
删除文件

### GET /health
健康检查

## 筛选条件说明

| 条件 | 说明 |
|------|------|
| 价格范围 | 只分析指定价格区间的商品 |
| 最小起订 | 过滤起订量过高的商品 |
| 供应商年限 | 只选择经营年限达标的供应商 |
| 响应率 | 只选择响应及时的供应商 |
| 48h 揽收率 | **核心指标**，只选择发货快的供应商 |

## 评分逻辑

### 质量评分 (0-100)
- 48h 揽收率 ≥90%: +30 分
- 响应率 ≥95%: +20 分
- 供应商年限 ≥5 年：+15 分

### 性价比评分 (0-100)
- 价格 <50 元：+30 分
- 起订量 ≤10 件：+25 分

## 注意事项

⚠️ **必须先启动后端服务** 再使用插件
⚠️ 1688 页面结构可能变化，需要定期更新选择器
⚠️ 搜索后需要等待页面加载完成（约 3 秒）

## 技术栈

**插件:**
- Plasmo (跨浏览器扩展框架)
- TypeScript + React
- Manifest V3

**后端:**
- Node.js + Express
- 本地 JSON 文件存储

---

**版本**: 0.2.0  
**作者**: Alen  
**助手**: 阿力 🤖