Nexscope

Walmart Marketplace Intelligence

Walmart Product Analysis MCP Tool

Returns normalized public ecommerce research data with a fixed read-only provider path.

MCP tool name
nexscope_walmart_product_analysis
Legacy MCP endpoint
/api/skill-api/v1/mcp
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-product-analysis-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_walmart_product_analysis",
    "arguments": {
      "productId": "5169493923",
      "operation": "detail"
    }
  }
}
Legacy endpoint
POST /api/skill-api/v1/mcp
Canonical detail URL
https://www.nexscope.ai/mcp-map/walmart-product-analysis

Arguments

operation: searchByName

NameTypeRequiredDescription
operationstringrequired
Operation: searchByName, detail, trend, or salesVolume
Constant: searchByName
namestringrequired
Product name required by searchByName
Minimum length: 1
pageIndexintegeroptional
Page number, starting at 1
Default: 1
Minimum: 1

operation: detail

NameTypeRequiredDescription
operationstringrequired
Operation: searchByName, detail, trend, or salesVolume
Constant: detail
productIdstringrequired
Walmart product ID required by detail, trend, and salesVolume
Minimum length: 1

operation: trend

NameTypeRequiredDescription
operationstringrequired
Operation: searchByName, detail, trend, or salesVolume
Constant: trend
productIdstringrequired
Walmart product ID required by detail, trend, and salesVolume
Minimum length: 1

operation: salesVolume

NameTypeRequiredDescription
operationstringrequired
Operation: searchByName, detail, trend, or salesVolume
Constant: salesVolume
productIdstringrequired
Walmart product ID required by detail, trend, and salesVolume
Minimum length: 1
queryDatestringoptional
Sales-volume start date in YYYY-MM-DD format
Format: date
queryEndDatestringoptional
Sales-volume end date in YYYY-MM-DD format
Format: date
pageIndexintegeroptional
Page number, starting at 1
Default: 1
Minimum: 1

Response fields

Treat structuredContent as the programmatic API response payload.

NameTypeRequiredDescription
dataanyrequired
Data value used by this API operation.
codeintegerrequired
0 means accepted or successful; nonzero is a platform error.
msgstring | nullrequired
Msg value used by this API operation.
tsstringrequired
Epoch milliseconds.
timestringrequired
Server local time: yyyy-MM-dd HH:mm:ss.
coststringrequired
Elapsed milliseconds, never credits; -1 outside web requests.
traceIdstring | nullrequired
Trace id value used by this API operation.

Any of option 1 — requires operation, value, requestConsumed

NameTypeRequiredDescription
dataobjectrequired
Data value used by this API operation.
data.operationanyrequired
Operation value used by this API operation.
data.valueanyrequired
Value value used by this API operation.
data.requestConsumedintegerrequired
Request consumed value used by this API operation.
Minimum: 0

operation: searchByName

NameTypeRequiredDescription
dataobjectrequired
Data value used by this API operation.
data.operationstringoptional
Operation value used by this API operation.
Constant: searchByName
data.valuearrayoptional
Value value used by this API operation.

operation: salesVolume

NameTypeRequiredDescription
dataobjectrequired
Data value used by this API operation.
data.operationstringoptional
Operation value used by this API operation.
Constant: salesVolume
data.valuearrayoptional
Value value used by this API operation.
data.value[]arrayrequired
Item in data value.
Minimum items: 3
Maximum items: 3
data.value[][0]stringrequired
Item in data value[].
Format: date
data.value[][1]numberrequired
Item in data value[].
data.value[][2]integerrequired
Item in data value[].

One of option 3

NameTypeRequiredDescription
dataobjectrequired
Data value used by this API operation.
data.operationanyoptional
Operation value used by this API operation.
Allowed: detail, trend
data.valueobjectoptional
Value value used by this API operation.

Any of option 2

NameTypeRequiredDescription
datanullrequired
Data value used by this API operation.

Examples

Example arguments

{
  "productId": "5169493923",
  "operation": "detail"
}

Example structuredContent

{
  "data": {
    "operation": "detail",
    "requestConsumed": 1,
    "value": {
      "ProductId": "5169493923",
      "Title": "Example Walmart product",
      "Price": 1
    }
  },
  "code": 0,
  "msg": null,
  "ts": "0",
  "time": "2026-01-01 00:00:00",
  "cost": "-1",
  "traceId": null
}