mcpField
W
walmart-research

walmart-research

github.com/crawlora-org其他141 次安装今天更新
代码仓库

关于 walmart-research

通过 Crawlora API 查询 Walmart 商品，适合进行价格、库存、目录和评价研究；数据以标准化 JSON 返回，不抓取 HTML。

主要功能

  1. 01搜索 Walmart 商品列表
  2. 02获取商品详情和库存
  3. 03汇总评分与评价样本
  4. 04分页搜索以研究商品目录

适用场景

  1. 01比较 Walmart 商品价格
  2. 02查看商品当前库存
  3. 03推荐前检查评分与评价
  4. 04从搜索结果构建候选目录

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/crawlora-org/crawlora-skills --skill walmart-research

安装后在 Claude Code 中输入/walmart-research确认已加载。

附带文件reference/endpoints.mdscripts/crawlora.sh

详细介绍

Walmart 研究

查询并比较 Walmart 商品、价格和评价——所有数据均来自 Crawlora API 提供的规范化 JSON，无需抓取 HTML。

何时使用此技能

  • “X 在 Walmart 上卖多少钱？”或“比较 X 在 Walmart 上的价格。”
  • “查找 Walmart 上的 X 商品”／“在 Walmart 上搜索此商品。”
  • “获取这款 Walmart 商品的评价／评分。”
  • “跟踪这款 Walmart 商品的价格／库存情况。”
  • 在 Walmart 上进行竞品定价或商品目录研究。

设置（一次性）

  • 在 https://crawlora.net 获取免费的 Crawlora API 密钥（每月 2,000 个额度，无需银行卡）。
  • 运行辅助脚本前，在环境中设置 CRAWLORA_API_KEY。
  • 辅助脚本会从环境中读取 CRAWLORA_API_KEY，并向 https://api.crawlora.net/api/v1 发送请求。缺少或无效的密钥会返回 401。

工作原理

  1. 搜索／发现 — 使用 /walmart/search（必需参数为 q）按关键词查找候选商品。
  2. 详情 — 使用 /walmart/product/{item_id} 获取指定商品信息（item_id 是 Walmart /ip/{id} URL 中的数字 ID），包括价格、库存情况、品牌、图片、评分、卖家、描述、亮点、规格和变体。
  3. 评价 — 使用 /walmart/product/{item_id}/reviews 获取页面上的评价快照：平均评分、评价总数、各星级分布、推荐比例、正面／负面评价精选，以及近期评价样本。

完整的端点列表、方法和参数请参阅：reference/endpoints.md。

调用 API

# Search Walmart (GET, key=value params):
scripts/crawlora.sh /walmart/search q="standing desk" | jq '.'

# Product detail (item_id is a path segment, not a query param):
scripts/crawlora.sh /walmart/product/414781783 | jq '.data'

# Product reviews:
scripts/crawlora.sh /walmart/product/414781783/reviews | jq '.'

所有请求均使用 scripts/crawlora.sh；它可以避免 API 密钥出现在命令行参数中。

端点参考

请参阅 reference/endpoints.md，了解此技能使用的所有 Walmart 端点（方法、路径、参数、说明）。

示例

  • 查询价格： 使用 /walmart/search 搜索商品名称，获取最匹配商品的 item_id，然后使用 /walmart/product/{item_id} 查询当前价格和库存情况。
  • 评价摘要： 在推荐商品前，使用 /walmart/product/{item_id}/reviews 汇总商品的平均评分、评分分布，以及精选的正面／负面评价。
  • 扫描商品目录： 使用 page 对一组查询进行分页，遍历 /walmart/search 的结果以建立候选商品列表，然后为每件商品调用 /walmart/product/{item_id} 来比较价格。

注意事项与限制

  • 额度／成功后计费： 仅对 2xx 响应计费；免费套餐每月提供 2,000 个额度。密钥获取地址：https://crawlora.net。
  • 仅限公开数据 — Walmart 公开的商品／搜索页面；请遵守 Walmart 的条款。
  • 安全性： 密钥仅保存在 CRAWLORA_API_KEY 中——切勿硬编码、将其作为查询参数传递或提交到代码库。
  • 搜索结果采用分页方式——传入 page 以遍历商品列表。
  • 详情和评价需要 item_id — 它是 Walmart /ip/{id} 商品 URL 中的数字 ID，而不是商品 slug。
  • 评价是单页快照，不是完整的分页信息流 — 没有评价的商品会返回零计数和空评价列表。

评论

支持 Markdown