市场MCP服务器
一组MCP(模型上下文协议)服务器,用于在最大的RUS市场上搜索产品: 野莓, 奥松 和 Yandex市场通过APIFY平台直接与人工智能代理(Claude Desktop、Cursor、OpenClaw等)集成。
建筑特点
- 核心结构: 通用逻辑(缓存、查询跟踪、API工作)被引入内核以保持稳定性。
- LRU缓存: 内存泄漏保护-缓存对记录数量和寿命(TTL)有限制。
- 重试机制: 自动重复查询,在网络或限制错误时出现指数延迟(429)。
- 紧凑模式: 针对AI代理进行了优化-只返回前3种产品,在上下文窗口中省钱。
______________________________________________________________________
环境配置
创建文件 .env 在根文件夹中,并添加以下变量:
≫变量≫描述≫默认值≫ | :--- | :--- | :--- | | APIFY_TOKEN | 我会的。 您的API是API平台的关键。 | - | | MAX_CONCURRENT_SEARCHES 限制对apify的并行请求。建议从 1 只有当您的apify资费允许更多的并行运行时,才会增加。 | 1 | | SEARCH_CACHE_TTL_SEC √搜索结果的生命周期(以秒为单位)(之后将重复对apify的查询)。 | 900 (15分钟) | WB_APIFY_TIMEOUT_SEC –从参与者处等待响应的最大时间(以秒为单位)。 | 120 | | WB_APIFY_RETRIES ►网络失败时尝试重复请求的次数。 | 3 |
______________________________________________________________________
启动服务器
每个市场都有一个单独的启动文件:
python wb_mcp_server.pyWildberries(两步搜索)python ozon_mcp_server.py-Ozon(通过Scraper快速搜索)python ym_mcp_server.py-Yandex市场(通过Actor搜索)
______________________________________________________________________
可用工具(Tools)
search_wb / search_ozon / search_ym
主要产品搜索工具。AI代理会自动调用它。
- 参数:
- query (string,required):请求文本(如iPhone 17 Pro Max 1TB)或订单号。 - limit (Number):最多10件商品。 - compact (Boolean):推荐 true返回最优惠价格的摘要。 - fresh_only (boolean):如果 true,忽略缓存并总是提出新的请求。
get_[name]_runtime_config
允许您查看服务器当前正在使用哪些角色ID和代理设置。
get_[name]_provider_status
允许您检查服务器的“健康状况”:错误统计数据、成功呼叫的次数和上次活动的时间。
______________________________________________________________________
AI代理(系统PROMPT)
“使用这些工具搜索最新的商品价格。如果用户没有指定特定的商店,请从臭氧或野生浆果开始。 compact: true 首先了解市场。"
______________________________________________________________________
作者 千禧一代AI\ 许可证: 麻省理工学院
