Flipkart产品抓取服务器

Flipkart MCP服务器是一个用于从Flipkart.com抓取产品信息的工具,提供产品搜索和详细数据提取功能,无需身份验证即可使用。

  • by Gokul2678
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 Gokul2678/FlipkartMCP

使用说明

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(<h1> 对于标题)而不是基于类的选择器
  • 基于结构的搜索结果解析(URL模式、价格符号)
  • 能够适应Flipkart频繁的页面结构更新

3.产品页面选择器

  • 名字: <h1> 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的比较

功能 亚马逊MCP Flipkart MCP
产品详细信息 ✅ ✅
搜索 ✅ ✅
价格(当前) ✅ ✅
价格(原价) ❌ ✅
折扣% ❌ ✅
图片 ✅ ✅
评级 ✅ ✅
评论 ✅ ✅
规格 ❌ ✅
亮点 ❌ ✅
可用性 ✅ ✅
描述 ✅ ✅

在ShopOS中的使用

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

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

错误处理

服务器处理:

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

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

许可证

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

作者

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