AI导哈

商品搜索服务

一套用于在俄罗斯主要电商平台（Wildberries、Ozon和Яндекс Маркет）上搜索商品的MCP服务器，支持与AI代理（如Claude Desktop、Cursor、OpenClaw等）通过Apify平台集成。

  • by MilleniumGenAI
  • Python
  • 本地部署
  • 5 星标
  • 更新于
在 GitHub 查看 MilleniumGenAI/marketplaces-mcp-servers

使用说明

市场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.py Wildberries（两步搜索）
  • 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
许可证： 麻省理工学院

相关 MCP