Amazon Intelligence SS

Amazon Intelligence SS: market/research API

Amazon Intelligence SS: market/research API.

MCP tool name

nexscope_data_ss_market_research

MCP endpoint

https://api.nexscope.ai/mcp

JSON-RPC method

tools/call

Authentication

Use OAuth 2.1 Authorization Code with PKCE and the mcp:tools scope. API keys remain supported as a compatibility option.

Authorization: Bearer nk-xxxxxxxxxxxxxxxxx

If authentication fails, ask the user to open API Access and copy a valid key.

Call this MCP tool

Initialize an MCP 2025-11-25 Streamable HTTP session at https://api.nexscope.ai/mcp, then use tools/call.

{
  "jsonrpc": "2.0",
  "id": "data-ss-market-research-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_data_ss_market_research",
    "arguments": {
      "marketplace": "US",
      "maxGoodsCrn": 0.4,
      "minAvgRevenue": 10000,
      "month": "nearly",
      "orderDesc": true,
      "orderField": "total_amount",
      "page": 1,
      "size": 50
    }
  }
}

MCP 2025-11-25 · Streamable HTTP

Progress is delivered on the original POST SSE response. GET SSE carries notifications; reconnecting must query existing asynchronous work rather than submit again.

Arguments

Name	Type	Required	Description
`marketplace`	`string`	required	Site encoding, see marketplace optional values Example: {}
`nodeIdPath`	`string`	optional	Category node ID path, for example `172282:281407` Example: {}
`departmentKeyword`	`string`	optional	Category keyword path, such as `Electronics:Accessories & Supplies` Example: {}
`sellerLocation`	`string`	optional	Seller's location, multiple values separated by commas Example: {}
`newProduct`	`integer`	optional	New product definition (month) Example: {}
`topNum`	`integer`	optional	Header Listing quantity Example: {}
`month`	`string`	optional	Filter date Example: {}
`page`	`integer`	optional	Page number, starting from 1 Example: {}
`size`	`integer`	optional	Number of items per page Example: {}
`orderField`	`string`	optional	Ordering field, see orderField optional value Example: {}
`orderDesc`	`boolean`	optional	`true` descending order, `false` ascending order Example: {}

Response fields

Treat structuredContent as the programmatic API response payload.

Name	Type	Required	Description
`total`	`integer`	optional	Total number of items Example: {}
`marketplace`	`string`	optional	Site encoding Example: {}
`data`	`array`	optional	Category market list (corresponding to third-party `data.items`) Example: {}
`columns`	`array`	optional	Rendered columns Example: {}
`costToken`	`integer`	optional	Consume token Example: {}
`type`	`string`	optional	rendering style Example: {}
`nodeId`	`string`	optional	Node ID Example: {}
`nodeIdPath`	`string`	optional	Node ID path Example: {}
`nodeLabelName`	`string`	optional	Node name Example: {}
`nodeLabelPath`	`string`	optional	Node name path Example: {}
`nodeLabelLocale`	`string`	optional	Node name translation Example: {}
`nodeLabelPathLocale`	`string`	optional	Node name path translation Example: {}
`marketplace`	`string`	optional	market sign Example: {}
`currency`	`string`	optional	The currency type of this market Example: {}
`ranking`	`integer`	optional	Ranking Example: {}
`totalProducts`	`integer`	optional	Total number of items Example: {}
`topProducts`	`integer`	optional	sample size Example: {}
`sellers`	`integer`	optional	Number of sellers Example: {}
`brands`	`integer`	optional	Number of brands Example: {}
`avgSellers`	`number`	optional	Average number of sellers Example: {}
`avgUnits`	`integer`	optional	average monthly sales Example: {}
`totalUnits`	`integer`	optional	Total monthly sales Example: {}
`avgRevenue`	`number`	optional	average monthly sales Example: {}
`totalRevenue`	`number`	optional	total monthly sales Example: {}
`avgPrice`	`number`	optional	average price Example: {}
`avgRating`	`number`	optional	average rating Example: {}
`avgRatings`	`integer`	optional	average rating Example: {}
`avgBsr`	`integer`	optional	Average BSR Example: {}
`avgProfit`	`number`	optional	Average profit margin (%) Example: {}
`fbaProportion`	`number`	optional	FBA proportion (%) Example: {}
`fbmProportion`	`number`	optional	FBM proportion (%) Example: {}
`amazonSelfProportion`	`number`	optional	Amazon’s self-operated share (%) Example: {}
`ebcProportion`	`number`	optional	A+ product proportion (%) Example: {}
`returnRatio`	`number`	optional	Return rate (%) Example: {}
`avgReturnRatio`	`number`	optional	Return rate category average (%) Example: {}
`searchToPurchaseRatio`	`number`	optional	Search to purchase ratio (per thousand) Example: {}
`sellerNation`	`string`	optional	Most sellers’ code Example: {}
`sellerNationLabel`	`string`	optional	Label with the most sellers’ locations Example: {}
`sellerProportion`	`number`	optional	Proportion of where the most sellers belong (%) Example: {}
`avgWeight`	`number`	optional	Average weight (pound) Example: {}
`baseAvgWeight`	`number`	optional	Average weight (g) Example: {}
`avgVolume`	`number`	optional	Average volume (in³) Example: {}
`baseAvgVolume`	`number`	optional	Average volume (cm³) Example: {}
`top10Images`	`array`	optional	The top 10 product pictures, the elements are shown in the table below Example: {}
`image`	`string`	optional	Image link Example: {}
`asin`	`string`	optional	ASIN Example: {}

Examples

Example arguments

{
  "marketplace": "US",
  "maxGoodsCrn": 0.4,
  "minAvgRevenue": 10000,
  "month": "nearly",
  "orderDesc": true,
  "orderField": "total_amount",
  "page": 1,
  "size": 50
}

Example structuredContent

{
  "code": 0,
  "cost": "-1",
  "data": {},
  "msg": null,
  "time": "2026-01-01 00:00:00",
  "traceId": null,
  "ts": "0"
}