Amazon Marketplace Intelligence

Walmart Search MCP Tool

Search and browse Walmart product listings by keyword, category, price range, and other conditions.

MCP tool name
nexscope_walmart_search
Equivalent REST API path
https://claw-callback.nexscope.ai/api/skill-api/v1/skills/walmart-search/run
JSON-RPC method
tools/call

Authentication

Send the user API key as a bearer token on every MCP JSON-RPC request.

Authorization: Bearer nk_xxxxxxxxxxxxxxxxx

If authentication is missing or invalid, ask the user to open API Access and copy a valid key before calling this tool.

Call this MCP tool

Use tools/call with the MCP tool name below. The arguments object should match the table on this page.

{
  "jsonrpc": "2.0",
  "id": "walmart-search-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_walmart_search",
    "arguments": {
      "keyword": "phone case",
      "spelling": true,
      "page": 1
    }
  }
}
REST API equivalent
POST /api/skill-api/v1/runhttps://claw-callback.nexscope.ai/api/skill-api/v1/skills/walmart-search/run
Canonical detail URL
https://www.nexscope.ai/mcp-map/walmart-search

Arguments

NameTypeRequiredMeaning
keywordstringoptional
Search keyword, max length 1024 characters. *At least one of keyword and categoryId must be provided
Example: phone case
categoryIdstringoptional
Category ID. *At least one of keyword and categoryId must be provided. 0 means all departments. For example: 976759_976787 means "Cookies"
Example: 976759_976787
sortstringoptional
Sort method. Options: price_low (price low to high), price_high (price high to low), best_seller (best seller), best_match (best match)
Example: {}
pageintegeroptional
Page number for pagination, default 1, max 100
Example: 1
minPricenumberoptional
Minimum price
Example: 1
maxPricenumberoptional
Maximum price
Example: 1
spellingbooleanoptional
Enable spelling correction, default true. true includes spelling correction, false excludes it
Example: false
softSortbooleanoptional
Sort by relevance, default true. Set to false to disable relevance sorting
Example: false
storeIdstringoptional
Store ID, used to filter products by a specific store
Example: example-id
devicestringoptional
Device type, default desktop. Options: desktop, tablet, mobile
Example: {}
facetstringoptional
Filter conditions, format as key:value pairs separated by \
Example: {}
nextDayEnabledbooleanoptional
Only show NextDay delivery results, default false. true to enable, false to disable
Example: false
jsonRestrictorstringoptional
JSON field restrictor
Example: {}

Response fields

Treat structuredContent as the programmatic API response payload.

NameTypeRequiredMeaning
totalintegeroptional
Record count
Example: 1
productsarrayoptional
Product list (see product object below)
Example: []
columnsarrayoptional
Rendered columns
Example: []
typestringoptional
Render style
Example: {}
costTokenintegeroptional
Token cost
Example: 1
products[].productIdstringoptional
Product ID
Example: example-id
products[].usItemIdstringoptional
US item ID
Example: example-id
products[].titlestringoptional
Title
Example: {}
products[].descriptionstringoptional
Description
Example: {}
products[].pricenumberoptional
Price
Example: 1
products[].wasPricenumberoptional
Original price (was_price)
Example: 1
products[].currencystringoptional
Currency unit
Example: {}
products[].minPricenumberoptional
Minimum price
Example: 1
products[].pricePerUnitAmountstringoptional
Price per unit amount
Example: {}
products[].pricePerUnitstringoptional
Price per unit
Example: {}
products[].ratingnumberoptional
Rating
Example: 1
products[].reviewsintegeroptional
Review count
Example: 1
products[].sellerNamestringoptional
Seller name
Example: {}
products[].sellerIdstringoptional
Seller ID
Example: example-id
products[].imageUrlstringoptional
Thumbnail
Example: https://example.com/image.jpg
products[].productPageUrlstringoptional
Product page URL
Example: https://example.com/image.jpg
products[].sponsoredbooleanoptional
Whether a sponsored product
Example: false
products[].outOfStockbooleanoptional
Whether out of stock
Example: false
products[].freeShippingbooleanoptional
Whether free shipping
Example: false
products[].twoDayShippingbooleanoptional
Whether two-day shipping supported
Example: false
products[].freeShippingWithWalmartPlusbooleanoptional
Free shipping for Walmart Plus members
Example: false
products[].shippingPricenumberoptional
Shipping cost
Example: 1
products[].multipleOptionsAvailablebooleanoptional
Whether multiple options available
Example: false
products[].variantSwatchesarrayoptional
Variant swatch list (each item contains name variant name, imageUrl variant image URL, productPageUrl variant product page URL, variantFieldId variant field ID)
Example: []
products[].sourceToolstringoptional
Source tool
Example: {}
products[].sourceTypestringoptional
Source type: walmart
Example: {}
errcodeintegeroptional
Upstream status code returned by the provider.
Example: {}
errmsgstringoptional
Upstream status message returned by the provider.
Example: {}
codestringoptional
Provider-specific status code.
Example: {}
msgstringoptional
Provider-specific status message.
Example: {}
messagestringoptional
Provider-specific message.
Example: {}
titlestringoptional
Provider-specific response title.
Example: {}
sourceTypestringoptional
Provider-specific source platform type.
Example: {}
sourceToolstringoptional
Provider-specific source tool name.
Example: {}
costTimeintegeroptional
Execution time reported by the upstream provider.
Example: {}
pageintegeroptional
Current page returned by the upstream provider.
Example: {}
pageSizeintegeroptional
Page size returned by the upstream provider.
Example: {}
pageItemCountintegeroptional
Item count on the current page returned by the upstream provider.
Example: {}
totalPageintegeroptional
Total page count returned by the upstream provider.
Example: {}
dataSnapshotMonthstringoptional
Data snapshot month returned by the upstream provider.
Example: {}

Examples

Example arguments

{
  "keyword": "phone case",
  "spelling": true,
  "page": 1
}

Example structuredContent

{
  "total": 1,
  "products": [
    {
      "productId": "example-id",
      "usItemId": "example-id",
      "price": 1,
      "wasPrice": 1,
      "minPrice": 1,
      "rating": 1,
      "reviews": 1,
      "sellerId": "example-id",
      "imageUrl": "https://example.com/image.jpg",
      "productPageUrl": "https://example.com/image.jpg",
      "sponsored": false,
      "outOfStock": false,
      "freeShipping": false,
      "twoDayShipping": false,
      "freeShippingWithWalmartPlus": false,
      "shippingPrice": 1,
      "multipleOptionsAvailable": false,
      "variantSwatches": []
    }
  ],
  "columns": [],
  "costToken": 1
}