Flipkart MCP

Flipkart MCP服务器

用于从Flipkart.com抓取产品信息的模型上下文协议（MCP）服务器。

特性

• 产品报废：从Flipkart产品URL中提取详细的产品信息
• 产品搜索：搜索Flipkart目录并获取产品列表
• 不要求进行验证：删除公开可用的产品页面

提供的工具

1. scrape_product(product_url: str)

从Flipkart产品URL中抓取详细的产品信息。

参数：

• product_url （string）：Flipkart产品页面的完整URL

退货：

• 产品名称
• 当前价格
• 原价（如有）
• 折扣百分比
• 产品图片
• 评分和评论计数
• 可用性状态
• 产品亮点
• 规格
• 描述

例子：

scrape_product("https://www.flipkart.com/product-name/p/itm...")

2. search_products(query: str, max_results: int = 5)

在Flipkart上搜索产品并返回结果。

参数：

• query （string）：搜索词（例如，“笔记本电脑”、“智能手机”）
• max_results （整数，可选）：返回的最大结果数（默认值：5，最大值：20）

退货： 产品列表：

• 产品名称
• 价格
• 图片链接
• 评分
• 产品URL

例子：

search_products("smartphone", max_results=10)

安装

FlipkartMCP服务器通过以下方式自动安装 setup-mcp.ts 脚本。

手动安装

1. 创建目录：

mkdir -p /tmp/FlipkartMCP

1. 创建Python虚拟环境：

cd /tmp/FlipkartMCP
python3 -m venv .venv

1. 安装依赖项：

.venv/bin/pip install -r requirements.txt

1. 运行服务器：

.venv/bin/python server.py

配置

服务器已在中配置 .opencode/opencode.jsonc:

"flipkart-mcp": {
  "type": "local",
  "command": [
    "/tmp/FlipkartMCP/.venv/bin/python",
    "/tmp/FlipkartMCP/server.py"
  ],
  "enabled": true,
  "timeout": 15000
}

依赖项

• mcp -模型上下文协议框架
• httpx -异步HTTP客户端
• beautifulsoup4 -HTML解析
• python3.14+ -Python运行时

技术细节

• 框架：FastMCP
• HTTP客户端：httpx（异步）
• HTML解析器：美丽的Soup4
• 用户代理：模仿Chrome浏览器以避免屏蔽

实施说明

稳健的报废策略

实施遵循以下最佳实践 ScrapingDog的Flipkart抓取指南:

1.防机器人保护

• 类似浏览器的标题 Sec-Fetch-* 信号
• 适当的 Accept-Language 和 Accept-Encoding （包括Brotli）
• Chrome用户代理模拟
• 15秒超时以避免触发速率限制

2.CSS选择器策略

• 每个数据字段有多个回退选择器（每个字段5-7个）
• 优先考虑语义HTML(`

` 对于标题）而不是基于类的选择器

• 基于结构的搜索结果解析（URL模式、价格符号）
• 能够适应Flipkart频繁的页面结构更新

3.产品页面选择器

• 名字: `

` tag → 基于类的回退

• 价格: ._30jeq3._16Jk6d → 多种选择
• 亮点: ul li._21Ahn- → 通用列表选择器
• 描述: ._1mXcCf.RmoJUa → 单类回退
• 图像：画廊(li._20Gt85, li._1Y_A6W) → 单图像回退

4.搜索结果优化

• 使用URL模式匹配(/p/itm, /p/products)产品链接
• 通过价格符号查找产品容器(₹)邻近性
• 从中提取名称 RG5Slk 类（2025结构），有后撤
• 过滤掉规格文本（RAM、处理器等）
• 按URL删除重复结果

5.错误处理

• 良好的降级（如果缺少某些字段，则返回部分数据）
• 描述性JSON错误响应
• 使用上下文捕获HTTP错误
• 超时保护

与亚马逊MCP的比较

在ShopOS中的使用

ShopOS代理可以使用Flipkart MCP工具：

• 比较不同市场的价格（Flipkart与亚马逊）
• 分析产品可用性
• 研究竞争对手产品
• 生成产品推荐
• 制定市场扩张战略

错误处理

服务器处理：

• URL无效
• HTTP错误（404、500等）
• 解析失败
• 缺少数据字段
• 网络超时

所有错误都会返回描述性JSON错误消息。

许可证

与Amazon MCP实现类似，这是一个供内部使用的自定义scraper。

作者

专为ShopOS集成而构建的电子商务运营代理平台。