1688 Scraper

这个 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. 安装依赖：

   pip install -r requirements.txt
   

运行 MCP 服务器

你可以通过 FastMCP CLI 或者直接运行 server.py：

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又弹验证码了，帮我调起浏览器，我手动滑一下。”