MCP server for scraping and analyzing products from 1688.com (Alibaba's B2B platform), including search, product details, reviews, and supplier reliability analysis
Server has 5 tools with visible schemas and descriptions, but quality is significantly below production baseline. Tool descriptions are present but lack LLM-optimization guidance (e.g., 'search_1688_products' description is 200+ chars of implementation detail rather than user intent). Parameters have types but many lack descriptions or constraints. Output schemas are not documented, tools return JSON strings without declared structure. Error handling is minimal (mostly 'ERROR_AUTH_REQUIRED' or generic exceptions). No tool annotations (readOnlyHint, destructiveHint). Naming is reasonable (verb_noun pattern) but descriptions fail to answer WHEN to use each tool or what downstream tools expect.
供应商深度背调:回头率、牛头标、经营年限。
获取商品真实阶梯价格与物流,自动剔除冗余属性。
深度评价扫描。自动进入"全部评价"界面,针对粉尘、结团、粘底等核心负面词进行嗅探。
智能搜货工具。在 Python 端完成产地和厂家过滤,只返回高质量结果,节省 80% Token。参数: keyword: 搜索词, location_filter: 发货地过滤(如 "山东", "广东"), only_factory: 是否仅保留源头工厂/实力商家, max_results: 返回给大模型的最大结果数(默认 5)
已预留60秒窗口期用于手动过风控。当前状态已保存在本地,请重试工具。
Output schemas not documented. Tools return JSON strings (e.g., search_1688_products returns {count, items} but structure of items is not declared). LLMs cannot plan downstream calls or extract fields reliably.
Descriptions lack LLM-optimization. 'search_1688_products' description is 200+ chars of implementation detail ('在 Python 端完成产地和厂家过滤...') rather than user intent. Should be: 'Search 1688 products by keyword with optional location and factory filters. Returns top results with title, price, company.'
Parameter descriptions missing or incomplete. 'location_filter' has description but no enum/constraint. 'only_factory' lacks explanation of what 'factory keywords' are. 'max_results' lacks guidance on token cost tradeoff.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 44 | 2026-07-28+ | v2 |
Error handling is minimal and non-actionable. 'ERROR_AUTH_REQUIRED' tells LLM nothing about recovery. Should be: 'Authentication required. Call update_auth_cookie() with login URL, then retry this tool.'
No tool annotations. Tools lack readOnlyHint (all are read-only except update_auth_cookie which is destructive/stateful). LLMs cannot reason about side effects or retry safety.