mcpField
W
walmart-research

walmart-research

github.com/crawlora-orgOther141 installsUpdated today
Repository

About walmart-research

A skill for researching Walmart products through Crawlora's API. It helps with price, availability, catalog, and review comparisons using normalized JSON rather than HTML scraping.

Key features

  1. 01Search Walmart product listings
  2. 02Retrieve product details and availability
  3. 03Summarize ratings and review samples
  4. 04Paginate search results for catalog research

Use cases

  1. 01Compare prices across Walmart listings
  2. 02Check a product's current availability
  3. 03Review ratings before recommending a product
  4. 04Build candidate catalogs from searches

Install

Copy the command and run it in a terminal.

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

After installing, type/walmart-researchin Claude Code to confirm it loaded.

Bundled filesreference/endpoints.mdscripts/crawlora.sh

Details

From the project README

Walmart research

Look up and compare Walmart products, prices, and reviews — all as normalized JSON from the Crawlora API, with no HTML scraping.

When to use this skill

  • "What does X cost on Walmart?" or "compare prices for X on Walmart."
  • "Find listings for X on Walmart" / "search Walmart for this product."
  • "Pull reviews / ratings for this Walmart product."
  • "Track this Walmart product's price / availability."
  • Competitive pricing or catalog research on Walmart.

Setup (one-time)

  • Get a free Crawlora API key (2,000 credits/mo, no card) at https://crawlora.net.
  • Set CRAWLORA_API_KEY in the environment before running the helper.
  • The helper reads CRAWLORA_API_KEY from the environment and sends requests to https://api.crawlora.net/api/v1. Missing/invalid key → 401.

How it works

  1. Search / discover — /walmart/search (q required) to find candidate products by keyword.
  2. Detail — fetch a specific product with /walmart/product/{item_id} (the numeric id from a Walmart /ip/{id} URL) for price, availability, brand, images, rating, seller, description, highlights, specifications, and variants.
  3. Reviews — pull the on-page reviews snapshot with /walmart/product/{item_id}/reviews: average rating, total review count, per-star breakdown, recommended percentage, top positive/negative review, and a sample of recent reviews.

Full endpoint list, methods, and params: reference/endpoints.md.

Calling the 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 '.'

Use scripts/crawlora.sh for all requests; it keeps the API key out of command-line arguments.

Endpoint reference

See reference/endpoints.md for every Walmart endpoint this skill uses (method, path, params, description).

Examples

  • Price check: /walmart/search for a product name, grab the item_id of the best match, then /walmart/product/{item_id} for the current price and availability.
  • Review summary: /walmart/product/{item_id}/reviews to summarize a product's average rating, rating breakdown, and top positive/negative reviews before recommending it.
  • Catalog sweep: paginate /walmart/search with page across a set of queries to build a candidate list, then fetch /walmart/product/{item_id} for each to compare prices.

Notes & limits

  • Credits / pay-on-success: billed only on 2xx; free tier 2,000 credits/mo. Key at https://crawlora.net.
  • Public data only — public Walmart product/search pages; respect Walmart's terms.
  • Security: key lives in CRAWLORA_API_KEY only — never hardcode, query-param, or commit it.
  • Search results are paginated — pass page to walk listings.
  • item_id is required for detail and reviews — it's the numeric id in a Walmart /ip/{id} product URL, not the product slug.
  • Reviews are a single on-page snapshot, not a full paginated feed — a product with no reviews returns zero counts and an empty reviews list.

Comments

Markdown supported