Walmart Marketplace Intelligence

Walmart Keyword Research MCP Tool

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

MCP tool name

nexscope_walmart_keyword_research

Equivalent REST API path

https://api.nexscope.ai/api/skill-api/v1/skills/walmart-keyword-research/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-keyword-research-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_walmart_keyword_research",
    "arguments": {
      "operation": "searchByName",
      "name": "wireless earbuds",
      "pageIndex": 1
    }
  }
}

REST API equivalent

POST https://api.nexscope.ai/api/skill-api/v1/skills/walmart-keyword-research/run

Canonical detail URL

https://www.nexscope.ai/mcp-map/walmart-keyword-research

Arguments

operation: marketQuery

Name	Type	Required	Description
`operation`	`string`	required	Walmart keyword research operation Constant: marketQuery
`pattern`	`object`	optional	Optional marketQuery filter object
`pattern.keyword`	`string`	optional	Keyword filter inside pattern Minimum length: 1
`pattern.rankCondition`	`array`	optional	One- or two-value rank range Minimum items: 1 Maximum items: 2
`pattern.rankCondition[]`	`integer`	required	One- or two-value rank range Minimum: 0
`pattern.searchVolumeCondition`	`array`	optional	One- or two-value search-volume range Minimum items: 1 Maximum items: 2
`pattern.searchVolumeCondition[]`	`integer`	required	One- or two-value search-volume range Minimum: 0
`pageIndex`	`integer`	optional	Page number, starting at 1 Default: 1 Minimum: 1
`pageSize`	`integer`	optional	Page size from 20 to 200 Default: 20 Minimum: 20 Maximum: 200

operation: searchByName

Name	Type	Required	Description
`operation`	`string`	required	Walmart keyword research operation Constant: searchByName
`name`	`string`	required	Keyword name required by searchByName Minimum length: 1
`pageIndex`	`integer`	optional	Page number, starting at 1 Default: 1 Minimum: 1

operation: searchProducts

Name	Type	Required	Description
`operation`	`string`	required	Walmart keyword research operation Constant: searchProducts
`keyword`	`string`	required	Keyword required by searchProducts, detail, or relatedKeywords Minimum length: 1
`pageIndex`	`integer`	optional	Page number, starting at 1 Default: 1 Minimum: 1
`pageSize`	`integer`	optional	Page size from 20 to 200 Default: 20 Minimum: 20 Maximum: 200

operation: detail

Name	Type	Required	Description
`operation`	`string`	required	Walmart keyword research operation Constant: detail
`keyword`	`string`	required	Keyword required by searchProducts, detail, or relatedKeywords Minimum length: 1

operation: productKeywords

Name	Type	Required	Description
`operation`	`string`	required	Walmart keyword research operation Constant: productKeywords
`productId`	`string`	required	Product ID required by productKeywords Minimum length: 1
`pageIndex`	`integer`	optional	Page number, starting at 1 Default: 1 Minimum: 1
`pageSize`	`integer`	optional	Page size from 20 to 200 Default: 20 Minimum: 20 Maximum: 200

operation: relatedKeywords

Name	Type	Required	Description
`operation`	`string`	required	Walmart keyword research operation Constant: relatedKeywords
`keyword`	`string`	required	Keyword required by searchProducts, detail, or relatedKeywords Minimum length: 1
`pageIndex`	`integer`	optional	Page number, starting at 1 Default: 1 Minimum: 1
`pageSize`	`integer`	optional	Page size from 20 to 200 Default: 20 Minimum: 20 Maximum: 200

operation: favoriteList

Name	Type	Required	Description
`operation`	`string`	required	Walmart keyword research operation Constant: favoriteList
`command`	`any`	required	Read-only favoriteList command: all, dict, or dict=<value>
`pageIndex`	`integer`	optional	Page number, starting at 1 Default: 1 Minimum: 1

One of option 1

Name	Type	Required	Description
`command`	`any`	required	Read-only favoriteList command: all, dict, or dict=<value> Allowed: all, dict

One of option 2

Name	Type	Required	Description
`command`	`string`	required	Read-only favoriteList command: all, dict, or dict=<value> Pattern: ^dict=.+$

Response fields

Treat structuredContent as the programmatic API response payload.

Name	Type	Required	Description
`operation`	`any`	required	Operation value used by this API operation.
`value`	`any`	required	Value value used by this API operation.
`requestConsumed`	`integer`	required	Request consumed value used by this API operation. Minimum: 0

One of option 1

Name	Type	Required	Description
`operation`	`any`	optional	Operation value used by this API operation. Allowed: marketQuery, searchByName, searchProducts, productKeywords, relatedKeywords, favoriteList
`value`	`array`	optional	Value value used by this API operation.

operation: detail

Name	Type	Required	Description
`operation`	`string`	optional	Operation value used by this API operation. Constant: detail
`value`	`object`	optional	Value value used by this API operation.

Examples

Example arguments

{
  "operation": "searchByName",
  "name": "wireless earbuds",
  "pageIndex": 1
}

Example structuredContent

{
  "operation": "searchByName",
  "requestConsumed": 1,
  "value": [
    {
      "Keyword": "wireless earbuds",
      "Rank": 1,
      "SearchVolume": 1
    }
  ]
}

Walmart Keyword Research MCP Tool

Authentication

Call this MCP tool

Arguments

operation: marketQuery

operation: searchByName

operation: searchProducts

operation: detail

operation: productKeywords

operation: relatedKeywords

operation: favoriteList

One of option 1

One of option 2

Response fields

One of option 1

operation: detail

Examples

Example arguments

Example structuredContent

Related MCP tools