Yandex购物搜索工具

一个本地MCP服务器,用于在Yandex Shopping上搜索土耳其市场的商品,并返回类似Google Shopping的卡片展示。

  • by rvdubinskiy
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 rvdubinskiy/mcp-shopping

使用说明

MCP购物

CHATGPT的本地MCP服务器,在网上搜索产品 Yandex购物 面向土耳其市场,并返回Google Shopping风格的报价卡。

机会

  • MCP 工具 search_yandex_shopping 执行Yandex Shopping搜索结果的HTTP请求。
  • 服务器为土耳其地区(默认情况下为伊斯坦布尔)选择结果,并聚合关键字段:价格、卖家、评级、交付和图像链接。
  • 返回结构化JSON数据和Google Shopping风格的ASCII卡,方便在ChatGPT中显示。
  • 该套件包括TypeScript上的CLI,它演示了如何使用该工具,并能够通过MCP和直接通过搜索库工作。

安装

npm install

⚠️ 包装 @modelcontextprotocol/sdk, undici, cheerio 和 zod 在NPM上发布。确保您可以访问注册表。

装配

npm run build

安装后,服务器将可用(dist/server.js客户(dist/client.js).

启动MCP服务器

npm run start

服务器导出工具 search_yandex_shopping您可以通过Model Context Protocol连接到CHATGPT,也可以直接使用它。

CLI演示

# В режиме разработки (использует tsx)
npm run dev:client -- "iPhone 15" 6

# После сборки
npm run build
npm run client -- "iPhone 15" 6

CLI将询问查询和限制,如果它们不是由参数传递的。首先,它试图通过stdio调用MCP服务器。如果服务器不可用,将直接搜索库 searchYandexShopping 他仍然会画卡片。

项目结构

  • src/lib/yandex.ts -Yandex Shopping的搜索和解析逻辑。
  • src/lib/cardRenderer.ts -生成带有结果的ASCII卡。
  • src/server.ts -MCP服务器和工具注册 search_yandex_shopping.
  • src/client.ts CLI显示如何连接到服务器。
  • src/types/mcp-sdk.d.ts -MCP SDK的最低类型声明(无需正式类型即可轻松构建)。

环境变量

  • MCP_YANDEX_REGION (可选):您可以重新定义Yandex区域 lr 搜索。实现自定义逻辑,如果需要,将值传递给 search_yandex_shopping.

许可证

麻省理工学院