# 1688 神级采购助理 MCP (1688 Scraper MCP)

> 这个 MCP 工具将你的 AI 变成一个精通内行的“1688 批发采购专家”。无论是 B 端批发、跨境电商找货，还是 C 端个人买家找平替，它都能帮你绕过贸易倒爷，直达源头工厂。

## 🌟 核心能力 (Core Features)

*(本 MCP 专为节省 Token 与防止大模型上下文溢出设计。所有的过滤、清洗、去重工作均在 Python 端完成。)*

### 1. 智能搜货与本地过滤 (`search_1688_products`)
- **超低 Token 消耗**：大模型无需读取几十条垃圾数据。工具原生支持传入 `location_filter="义乌"` 和 `only_factory=True`，Python 会在抓取时本地丢弃“贸易倒爷”和无关地域商品。
- **动态截断**：默认只返回给 AI 最精准的前 5 条数据，而不是整页的 20 条，彻底告别超长 JSON。

### 2. 精准极简算价 (`get_product_detail_and_price`)
- 精准解析阶梯价格表（如：2-99件 10元，≥100件 8元）。
- **去噪属性树**：砍掉了 1688 商品参数中几十个无用的冗余字段（如内部编码、主图来源等），只保留“材质、风格、尺寸”等核心特征。

### 3. 高质量精华评价提取 (`get_product_reviews`)
- **硬核防水军 (NLP Pre-processing)**：工具会在 Python 内存中自动剔除“默认好评”、“此用户没有填写评价”以及小于 5 个字的灌水评价。
- **长文本截断防溢出**：超过 150 字的长篇大论评价会自动截断，并将最有价值的反馈聚合成短 JSON 返回，支持自动翻 10 页寻找精华评论。大模型只需要读 20 条精华评价，就能给出完美的商品缺点总结！

### 4. 供应商深度防坑背调 (`analyze_supplier_reliability`)
提取 1688 右侧边栏的店铺核心履约指标 (BSR)：
- **工厂资质**：牛头标超级工厂、实力商家。
- **履约数据**：发货速度、响应速度、货描相符评分。
- **复购率/回头率**：判断商品质量的最核心指标。

### 4. 智能过风控 (`update_auth_cookie`)
1688 拥有变态级的反爬虫机制。本工具基于 `DrissionPage` 驱动真实的 Chromium 浏览器，采用本地 `user_data` 持久化方案。
- 当触发滑块或登录拦截时，工具会自动唤起一个真实浏览器窗口，给你 60 秒时间手动滑动验证码或扫码登录，登录状态将永久保存在本地供后续静默抓取使用。

## 🚀 安装与运行

### 环境准备
1. 确保安装了 Python 3.10+。
2. 安装依赖：
   ```bash
   pip install -r requirements.txt
   ```

### 运行 MCP 服务器
你可以通过 `FastMCP` CLI 或者直接运行 `server.py`：
```bash
python server.py
```
*(或者配置到你的 AI IDE (如 Cursor / Windsurf / Antigravity) 的 `mcp.json` 中，命令设置为 `python`, 参数为 `server.py` 的绝对路径。)*

## 💬 交互示例 (Prompts to try)

配置好本 MCP 后，你可以直接在 AI 对话框中发送以下指令：

- **B端拿货**：“帮我搜索‘无缝内衣’，只要义乌的源头工厂（带牛头标），列出排名前 5 的厂家名称、成立年限和主推价格。”
- **深度背调**：“分析一下这个链接 `[1688商品URL]` 的供应商。他是真的工厂吗？成立几年了？回头率在同行里算高吗？”
- **算清底价**：“这个商品 `[1688商品URL]` 的阶梯价格是怎么样的？如果我买 50 件，包含运费的落地单件成本是多少？”
- **过风控指令**：“1688又弹验证码了，帮我调起浏览器，我手动滑一下。”