Walmart Intelligence ST
Walmart Product Analysis MCP
Analyze Walmart products, detail records, performance trends, and dated sales volume. Results come back as structured JSON. Call it via REST API or MCP.
Walmart Product Analysis AI Prompts & Use Cases
After connecting this MCP tool to your AI assistant, you can ask the questions below. Replace bracketed placeholders with your own inputs and use the supported values in Arguments.
New to Nexscope MCP? Follow the connection guide, then use the prompts below. The Integration and Parameters & Response tabs contain the connection steps, call example, and technical reference.
1. Find A Walmart Product
Prompt: Find Walmart products matching [product name]. Show page [page number] and stop before requesting another page.
2. Inspect Product Details
Prompt: Look up Walmart product [product ID] and summarize its returned product facts. Flag missing information.
3. Review Product Trends
Prompt: Show the available trend data for Walmart product [product ID]. Keep the reporting dates visible and do not infer values between missing observations.
4. Review Sales In A Date Range
Prompt: Show sales for Walmart product [product ID] from [start date] through [end date]. Read page [page number] only and retain the reported date range.
What You Need to Provide
Replace bracketed inputs with your own values. Use only the documented marketplace, period and input formats.
Returned estimates and rankings describe the selected data and period; missing values are not zero and a page of results is not the full market.
Step 1 · Connect
Connect Your AI Assistant
Connect a compatible MCP client to Nexscope, then select this tool from your assistant. Use the connection settings in your client to complete authentication.
POST https://api.nexscope.ai/mcp
MCP-Protocol-Version: 2025-11-25
Content-Type: application/jsonAuthentication
Use OAuth 2.1 Authorization Code with PKCE and the mcp:tools scope. API keys remain supported as a compatibility option.
Authorization: Bearer nk-xxxxxxxxxxxxxxxxxUsing an API key? Get your key from API Access and include it in the Authorization header shown above.
Call this MCP tool
nexscope_walmart_product_analysishttps://api.nexscope.ai/mcptools/callInitialize an MCP 2025-11-25 Streamable HTTP session at https://api.nexscope.ai/mcp, then use tools/call.
{
"jsonrpc": "2.0",
"id": "walmart-product-analysis-1",
"method": "tools/call",
"params": {
"name": "nexscope_walmart_product_analysis",
"arguments": {
"operation": "detail",
"productId": "5169493923"
}
}
}MCP 2025-11-25 · Streamable HTTPProgress is delivered on the original POST SSE response. GET SSE carries notifications; reconnecting must query existing asynchronous work rather than submit again.
Arguments
operation: searchByName
| Name | Type | Required | Description |
|---|---|---|---|
name | string | required | Product name required by searchByName Minimum length: 1 |
operation | string | required | Operation: searchByName, detail, trend, or salesVolume Constant: searchByName |
pageIndex | integer | optional | Page number, starting at 1 Default: 1 Minimum: 1 |
operation: detail
| Name | Type | Required | Description |
|---|---|---|---|
operation | string | required | Operation: searchByName, detail, trend, or salesVolume Constant: detail |
productId | string | required | Walmart product ID required by detail, trend, and salesVolume Minimum length: 1 |
operation: trend
| Name | Type | Required | Description |
|---|---|---|---|
operation | string | required | Operation: searchByName, detail, trend, or salesVolume Constant: trend |
productId | string | required | Walmart product ID required by detail, trend, and salesVolume Minimum length: 1 |
operation: salesVolume
| Name | Type | Required | Description |
|---|---|---|---|
operation | string | required | Operation: searchByName, detail, trend, or salesVolume Constant: salesVolume |
pageIndex | integer | optional | Page number, starting at 1 Default: 1 Minimum: 1 |
productId | string | required | Walmart product ID required by detail, trend, and salesVolume Minimum length: 1 |
queryDate | string | optional | Sales-volume start date in YYYY-MM-DD format Format: date |
queryEndDate | string | optional | Sales-volume end date in YYYY-MM-DD format Format: date |
Response fields
Treat structuredContent as the programmatic API response payload.
| Name | Type | Required | Description |
|---|---|---|---|
errcode | integer | optional | Gateway framework layer status code; `200` indicates that the request successfully entered the business response |
errmsg | string | optional | Gateway framework layer status message; typically `ok` on success |
code | integer | optional | `200` indicates success |
msg | string | optional | response message |
data | object | optional | Fixed response container; `data.value` retains each operation's ST primitive object, array, scalar, or `null` |
operation | string | optional | `searchByName`, `detail`, `trend` or `salesVolume` actually executed this time |
requestConsumed | integer | optional | This upstream consumption; when the upstream is missing or returns 0, it is completed according to the document consumption of the operation; when ST explicitly returns `Code=11` (no data), it remains 0 |
costTime | integer | optional | Time taken, unit is milliseconds |
costToken | integer / absent | optional | Production gateway response header `X-Cost-Token`; the entry script will be copied to this field, and this field is currently missing when parsing the JSON body directly. |
costCredit | integer / absent | optional | Production gateway response header `X-Cost-Credit`, which is the actual computing power deducted this time; the entry script will be copied to this field |
sourceType | string | optional | `st` |
searchByName | array<object> | optional | Related product summary array |
detail | object | optional | Single product details object |
trend | object | optional | Single product trend object |
salesVolume | array<array> | optional | Sales record row array; each row is `[date, sales, type]` |
Title | string | optional | Product title |
Photo | array<string> | optional | Product image URL array |
ListingSalesVolumeOfMonth | integer | optional | Estimated sales volume in the last 30 days in the Listing dimension, without distinguishing between variants |
ListingSalesOfMonth | integer | optional | Estimated sales in the past 30 days in the Listing dimension; the unit for the US site is cents |
ProductId | string | optional | Walmart ProductId |
ParentProductId | string | optional | Parent product ProductId |
Price | integer | optional | Selling price; the US site unit is cents, such as `1999` means `$19.99` |
Brand | string | optional | brand |
Seller | string | optional | Seller name at the time of collection |
Shipedby | string | optional | The delivery method at the time of collection; the field name is the original spelling of the upstream |
WFSFee | integer | optional | WFS fee; US site unit is cents |
Attribute | array<string> / null | optional | Product attributes, interleaved encoding according to `[attribute name, attribute value, ...]` |
FirstReviewsDate | string / null | optional | Date of first comment in the format `yyyy-MM-dd` |
ReviewsCount | integer | optional | Number of comments |
Ratings | number | optional | Rating, like `4.8` |
NodePath | array<string\|null> | optional | Category and ranking records are grouped and coded according to `[category name, NodeId, ranking date, ranking, ...]`; when the ranking on a certain day is missing, the corresponding position is `null` |
Label | array<string> | optional | Product tags, such as `pickup`, `savewith`, `bestsell` |
PopularPick | integer | optional | Popular Pick tag; `1` indicates existence |
Clearance | integer | optional | Clearance tag; `1` indicates existence |
ReducedPrice | integer | optional | Reduced Price tag; `1` indicates existence |
Rollback | integer | optional | Rollback token; `1` indicates existence |
FlashDeal | integer | optional | Flash Deal tag; `1` indicates existence |
Size | array<string> / null | optional | Outer packaging size `[longest side, second longest side, shortest side]`, unit is cm |
Weight | number | optional | Product weight in grams |
Variants | array / null | optional | Variant data; `searchByName` is encoded differently than `detail`, see below |
NumberOfStar | array<number\|string> / null | optional | The number of reviews for each star rating, according to `[star rating, number of reviews, ...]` staggered coding |
Pickup | integer | optional | Detail extension: Pickup tag mark; `1` indicates existence |
Savewith | integer | optional | Detail extension: Save with label mark; `1` indicates existence |
Bestseller | integer | optional | Detail extension: Best Seller tag; `1` indicates existence |
UpdateDate | string / null | optional | Detail extension: product data update time, usually `yyyy-MM-dd` |
VariantId | string | optional | Variant ProductId |
Url | string | optional | Variant product URL |
Property | array<string> | optional | Variant attributes, encoded by `[attribute name, attribute value, ...]` |
PriceUpdate | string / null | optional | Price update time, usually `yyyy-MM-dd` |
DetailUpdate | string / null | optional | Details update time, usually `yyyy-MM-dd`; when there is no valid date, upstream placeholders such as `--` may be used |
ProductId | string | optional | Walmart ProductId |
ListingSalesVolumeOfMonth | integer | optional | Estimated sales volume of the current Listing dimension in the past 30 days |
ListingSalesOfMonth | integer | optional | Estimated sales of the current Listing dimension in the past 30 days; the unit for the US site is cents |
ListingSalesVolumeOfMonthTrend | array<string> | optional | Monthly sales history, coded by `[yyyy-MM-dd, sales volume, ...]` |
ListingSalesOfMonthTrend | array<string> | optional | Monthly sales history, coded by `[yyyy-MM-dd, sales, ...]`; amount unit is cents |
PriceTrend | array<string> | optional | Price history, encoded by `[yyyy-MM-dd, price, ...]`; amounts are in cents |
ReviewsTrend | array<string> | optional | Comment count history, encoded by `[yyyy-MM-dd, comment count, ...]` |
StarTrend | array<string> | optional | Rating history, encoded as `[yyyy-MM-dd, rating, ...]`; current response example value is `5.00` |
RankTrend | array<array<string>> | optional | Ranking history of each category; each row is encoded by `[category name, NodeId, date, ranking, date, ranking, ...]` |
Example Q&A
Based on a published documentation sample, not a live tool call.
Your Question
Inspect Product Details for the inputs in this documentation sample.
Example Answer
In the published sample, its reported listing sales of month is 0. Its reported savewith is 0. Its reported popular pick is 0. These observations apply only to the shown record and reporting scope.
About this sample: Published documentation excerpt, not a live query. Arrays show at most two records and long text may be shortened. Missing units, dates or coverage remain unspecified; the excerpt does not represent the complete dataset.
View the Published Sample Data (JSON)
Published REST data example. Use Parameters & Response for MCP arguments when calling this tool.
Data Example
Sample request and response
Request parameters
{
"operation": "detail",
"productId": "546427139"
}Response
{
"code": 0,
"msg": null,
"data": {
"data": {
"value": {
"ListingSalesOfMonth": 0,
"Shipedby": "自发货",
"Savewith": 0,
"Attribute": [
"Hair type",
"All Hair Types",
"Brand",
"Aquage",
"Hair care key benefits",
"Strengthening & Split End Repair, Cleansing, Moisturizing",
"Primary ingredient",
"Glycerin",
"Scent",
"Aquage",
"Size",
"16 fl oz",
"Shampoo & conditioner type",
"Conditioners",
"Hair product form",
"Creams",
"Container type",
"Bottle",
"Active ingredients",
"Glycerin",
"Instructions",
"Cleanse with Aquage Strengthening Shampoo. Apply Strengthening Conditioner. Gently comb through and rinse.",
"Product net content uom",
"Fluid Ounces",
"Product net content parent",
"16 Fluid Ounces",
"Age group",
"Adult",
"Gender",
"Female",
"Count per pack",
"1",
"Inactive ingredients",
"Water/Aqua/Eau, Myristyl Alcohol, Propylene Glycol, Cetearyl Alcohol, Cetrimonium Chloride*, Hippophae Rhamnoides (Sea Buckthorn/Argousier) Fruit/Seed Oil, Borago Officinalis (Borage/Bourrache) Seed Oil, Mangifera Indica (Mango/Mangue) Seed Butter, Butyrospermum Parkii (Shea/Karite) Butter, Hydroxypropyl Guar Hydroxypropyltrimonium Chloride, Aloe Barbadensis Leaf Juice, Glycerin, Hydrolyzed Quinoa, Aminomethyl Propanol, Bis-PCA Dimethicone, Butylene Glycol, C11-15 Pareth-7, C12-16 Pareth-9, Caprylyl Glycol, Decyl Oleate, Disodium PEG-12 Dimethicone Sulfosuccinate, Trideceth-12, Trimethylsiloxyamodimethicone, Citric Acid, Etidronic Acid, Lauryl Alcohol, Hydrogenated Palm Glycerides Citrate, Phenoxyethanol, Potassium Sorbate, Sodium Benzoate, Cetyl Alcohol, Benzyl Alcohol, Tocopherol, Fragrance/Parfum, Hydroxycitronellal, Limonene, Ext. Violet 2 (CI 60730) *antistatic agent/agent antistatique"
],
"FirstReviewsDate": null,
"Size": null,
"PopularPick": 0,
"Label": [],
"ReducedPrice": 0,
"Photo": [
"https://i5.walmartimages.com/seo/Aquage-SeaExtend-Strengthening-Conditioner-16-oz_d3a31b9b-0bbe-49c1-af75-cd3ed55f8788.b8b5b0e6b92a8bb489db501d1d11c211.jpeg",
"https://i5.walmartimages.com/asr/14636eb9-1bab-42ec-8ccb-e45eb052ae22.ec31255e50e0ac212fd57603599c9bd3.jpeg",
"https://i5.walmartimages.com/asr/d00485b4-2b2d-43fd-9471-bef08f91ab8f.8d0711f32aebd85f69057f70f29cede7.jpeg",
"https://i5.walmartimages.com/asr/f50d7eba-663f-4139-a6e8-5ada6d3a085c.e352eef32b49c9944a3f740b206000be.jpeg",
"https://i5.walmartimages.com/asr/2f36fd73-0f22-4cc3-bb6c-01aef6d7facf.62f2c4aca822002f3e4def0a57f66dd7.jpeg",
"https://i5.walmartimages.com/asr/ee6ba57e-362b-4666-b496-ba34b777a0b9.0eb8ebd9753455b2d59bb641c1931728.jpeg",
"https://i5.walmartimages.com/asr/35533f6e-3f31-4d24-bc3d-5f6d7e5afcd3.2ee717878eb67eae9e553c639a19d1b0.jpeg",
"https://i5.walmartimages.com/asr/fb4b6934-ab8d-4138-ad7d-755439b1947c.f1d6a59197ee32356f54f7524ed00b10.jpeg"
],
"ProductId": "546427139",
"Clearance": 0,
"Ratings": 4.7,
"UpdateDate": null,
"FlashDeal": 0,
"ParentProductId": "546427139",
"Rollback": 0,
"NumberOfStar": [
1,
1,
2,
1,
3,
0,
4,
4,
5,
28
],
"ReviewsCount": 34,
"Pickup": 0,
"Title": "Aquage SeaExtend Strengthening Conditioner 16 oz",
"Bestseller": 0,
"NodePath": [
"Premium Conditioners in Beauty",
"1085666_3020074",
"2026-09-30",
"195",
"Premium Conditioners in Beauty",
"1085666_3020074",
"2026-10-01",
null,
"Premium Conditioners in Beauty",
"1085666_3020074",
"2026-10-02",
"119",
"Premium Conditioners in Beauty",
"1085666_3020074",
"2026-10-03",
null,
"Premium Conditioners in Beauty",
"1085666_3020074",
"2026-10-04",
"131",
"Premium Conditioners in Beauty",
"1085666_3020074",
"2026-10-05",
"112"
],
"Weight": 0,
"Brand": "Aquage",
"Variants": [
"546427139",
" https://www.walmart.com/ip/Aquage-SeaExtend-Strengthening-Conditioner-16-oz/546427139",
[
"Size",
"16 fl oz"
]
],
"WFSFee": 0,
"Price": 3030,
"ListingSalesVolumeOfMonth": 0,
"Seller": "Beautyvice"
}
},
"costTime": 962,
"sourceType": "sorftime",
"operation": "detail",
"requestConsumed": 1
}
}View the MCP Request & Response Format
Examples
Based on a published documentation sample, not a live tool call.
The JSON-RPC envelope below illustrates how the shown arguments and payload fit into MCP. It is not captured network traffic or proof of a successful call. Workflow-only examples do not include a result.
MCP Request
{
"jsonrpc": "2.0",
"id": "walmart-product-analysis-example",
"method": "tools/call",
"params": {
"name": "nexscope_walmart_product_analysis",
"arguments": {
"operation": "detail",
"productId": "546427139"
}
}
}MCP Response Format
{
"jsonrpc": "2.0",
"id": "walmart-product-analysis-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"msg\":null,\"data\":{\"data\":{\"value\":{\"ListingSalesOfMonth\":0,\"Shipedby\":\"自发货\",\"Savewith\":0,\"Attribute\":[\"Hair type\",\"All Hair Types\"],\"FirstReviewsDate\":null,\"Size\":null,\"PopularPick\":0,\"Label\":[],\"ReducedPrice\":0,\"Photo\":[\"https://i5.walmartimages.com/seo/Aquage-SeaExtend-Strengthening-Conditioner-16-oz_d3a31b9b-0bbe-49c1-af75-cd3ed55f8788.b8b5b0e6b92a8bb489db501d1d11c211.jpeg\",\"https://i5.walmartimages.com/asr/14636eb9-1bab-42ec-8ccb-e45eb052ae22.ec31255e50e0ac212fd57603599c9bd3.jpeg\"],\"ProductId\":\"546427139\",\"Clearance\":0}},\"operation\":\"detail\",\"requestConsumed\":1}}"
}
],
"structuredContent": {
"code": 0,
"msg": null,
"data": {
"data": {
"value": {
"ListingSalesOfMonth": 0,
"Shipedby": "自发货",
"Savewith": 0,
"Attribute": [
"Hair type",
"All Hair Types"
],
"FirstReviewsDate": null,
"Size": null,
"PopularPick": 0,
"Label": [],
"ReducedPrice": 0,
"Photo": [
"https://i5.walmartimages.com/seo/Aquage-SeaExtend-Strengthening-Conditioner-16-oz_d3a31b9b-0bbe-49c1-af75-cd3ed55f8788.b8b5b0e6b92a8bb489db501d1d11c211.jpeg",
"https://i5.walmartimages.com/asr/14636eb9-1bab-42ec-8ccb-e45eb052ae22.ec31255e50e0ac212fd57603599c9bd3.jpeg"
],
"ProductId": "546427139",
"Clearance": 0
}
},
"operation": "detail",
"requestConsumed": 1
}
},
"isError": false
}
}