Amazon Search Intelligence SF

Amazon Keyword Summary

Compare competitor traffic from search, ads, and recommendations. Call the Amazon Keyword Summary API via REST or MCP from 12 credits per call.

MCP tool name

nexscope_amazon_keyword_summary

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": "amazon-keyword-summary-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_amazon_keyword_summary",
    "arguments": {
      "country": "US",
      "last7d": true,
      "pageNum": 1,
      "pageSize": 10,
      "searchKeyword": "phone case"
    }
  }
}

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
`searchKeyword`	`string`	required	Search keyword, translate to the corresponding country's language whenever possible. Max length 1000 characters Example: phone case
`country`	`string`	optional	Country site, default US. Options (13 total): US, UK, DE, CA, JP, FR, ES, IT, MX, AU, AE, BR, SA Example: {}
`asins`	`string`	optional	ASIN filter list, comma-separated; if not provided, returns all ASINs for this keyword. Max length 1000 characters Example: B072MQ5BRX
`condition`	`string`	optional	Condition filter, only one at a time.<br>Flag type: nfPosition (natural traffic keyword), isSpAd (SP ad keyword), isVedioAd (video ad keyword), isBrandAd (brand ad keyword), isPPCAd (PPC ad keyword), isSearchRecommend (search recommendation keyword), acAd (SP recommendation)<br>Period count type: totalPeriod.in (new incoming traffic keywords), nfKeywordCnt.total / .in, adKeywordCnt.total / .in, allSpKeywordCnt.total / .in, spKeywordCnt.total / .in, recSpKeywordCnt.total / .in, allSbKeywordCnt.total / .in, sbKeywordCnt.total / .in, sbvKeywordCnt.total / .in Example: {}
`last7d`	`boolean`	optional	Whether to get last 7 days data, default true. When false, use startDate/endDate range Example: true
`startDate`	`string`	optional	Start date yyyy-MM-dd (effective when last7d=false; if omitted, the latest system full week is used) Example: 2026-01-01
`endDate`	`string`	optional	End date yyyy-MM-dd (paired with startDate) Example: 2026-01-01
`sortBy`	`string`	optional	Sort field. Options: totalKeywordNum (all traffic keywords), naturalKeywordNum (natural traffic keywords), brandKeywordNum (brand ad keywords), vedioKeywordNum (video ad keywords), acKeywordNum (AC recommended keywords), erKeywordNum (ER recommended keywords), trKeywordNum (TR recommended keywords), sumScore (total keyword exposure score), totalNfScore, totalSpSocre (note spelling), totalBrandScore, totalVedioScore, totalAcScore, totalTrScore, totalErScore Example: {}
`pageNum`	`integer`	optional	Page number, default 1 Example: 1
`pageSize`	`integer`	optional	Results per page, min 10, max 100, default 100 Example: 10
`desc`	`boolean`	optional	Whether to sort descending, default true Example: true

Response fields

Treat structuredContent as the programmatic API response payload.

Name	Type	Required	Description
`code`	`string`	optional	sf business return code, `"1"` indicates success Example: {}
`msg`	`string`	optional	news Example: {}
`total`	`integer`	optional	The actual amount of data returned this time Example: {}
`data`	`array`	optional	ASIN keyword traffic data array Example: {}
`columns`	`array`	optional	render column Example: {}
`type`	`string`	optional	rendering style Example: {}
`title`	`string`	optional	Title Example: {}
`costTime`	`integer`	optional	Time consuming (ms) Example: {}
`costToken`	`integer`	optional	Consume token Example: {}
`asin`	`string`	optional	ASIN code Example: {}
`productTitle`	`string`	optional	Product title Example: {}
`productImageUrl`	`string`	optional	Main image URL Example: {}
`productPrice`	`number`	optional	Product selling price Example: {}
`customerRatingCount`	`integer`	optional	Total customer ratings Example: {}
`productStarRating`	`number`	optional	Product star rating Example: {}
`productRatingScore`	`number`	optional	Product rating value Example: {}
`productUpdateTime`	`string`	optional	Product update time Example: {}
`dataPeriodStartDate`	`string`	optional	Data period start date Example: {}
`totalExposureScore`	`number`	optional	Total exposure score Example: {}
`totalExposureRatio`	`number`	optional	Total traffic share Example: {}
`naturalSearchExposureScore`	`number`	optional	Total organic search exposure score Example: {}
`naturalSearchExposureRatio`	`number`	optional	Natural search exposure ratio Example: {}
`sponsoredProductsExposureScore`	`number`	optional	SP ad impression total score Example: {}
`sponsoredProductsExposureRatio`	`number`	optional	SP advertising exposure ratio Example: {}
`brandAdExposureScore`	`number`	optional	Total brand advertising exposure score Example: {}
`brandAdExposureRatio`	`number`	optional	Brand advertising exposure proportion Example: {}
`videoAdExposureScore`	`number`	optional	Total video ad exposure score Example: {}
`videoAdExposureRatio`	`number`	optional	Video ad exposure ratio Example: {}
`amazonsChoiceExposureScore`	`number`	optional	AC exposure total score Example: {}
`amazonsChoiceExposureRatio`	`number`	optional	AC exposure ratio Example: {}
`editorialRecommendationsExposureScore`	`number`	optional	ER total exposure score Example: {}
`editorialRecommendationsExposureRatio`	`number`	optional	ER exposure ratio Example: {}
`topRatedExposureScore`	`number`	optional	TR exposure total score Example: {}
`topRatedExposureRatio`	`number`	optional	TR exposure ratio Example: {}
`recommendPositionExposureScore`	`number`	optional	Recommended position exposure total score Example: {}
`recommendAdExposureScore`	`number`	optional	Recommended advertising exposure score Example: {}
`recommendAdExposureRatio`	`number`	optional	Recommended advertising traffic share Example: {}
`recommendNonadExposureScore`	`number`	optional	Recommended position non-advertising exposure score Example: {}
`recommendNonadExposureRatio`	`number`	optional	Recommended non-advertising traffic share Example: {}
`comprehensiveNaturalExposureScore`	`number`	optional	Comprehensive organic traffic score Example: {}
`comprehensiveNaturalExposureRatio`	`number`	optional	Combined organic traffic share Example: {}
`keywordTotalExposureScore`	`number`	optional	The total score of this keyword Example: {}
`keywordNaturalExposureScore`	`number`	optional	Natural score for this keyword Example: {}
`keywordSponsoredProductsExposureScore`	`number`	optional	SP score of this keyword Example: {}
`keywordBrandAdExposureScore`	`number`	optional	Brand advertising score for this keyword Example: {}
`keywordVideoAdExposureScore`	`number`	optional	Video ad score for this keyword Example: {}
`keywordAmazonsChoiceExposureScore`	`number`	optional	AC score of this keyword Example: {}
`keywordRecommendExposureScore`	`number`	optional	Recommended position score for this keyword Example: {}
`keywordRecommendAdExposureScore`	`number`	optional	Advertising score for recommended positions for this keyword Example: {}
`keywordRecommendNonadExposureScore`	`number`	optional	This keyword recommendation position is not an advertising score Example: {}
`keywordComprehensiveNaturalExposureScore`	`number`	optional	Comprehensive natural score for this keyword Example: {}
`ppcTrafficSources`	`array`	optional	PPC Traffic Source Tags Example: {}
`naturalSearchTrafficSources`	`array`	optional	Organic search traffic source tag Example: {}
`amazonRecommendationSources`	`array`	optional	Amazon Recommended Source Mark Example: {}
`promotionalDealSources`	`array`	optional	Promotion source tag Example: {}

Examples

Example arguments

{
  "country": "US",
  "last7d": true,
  "pageNum": 1,
  "pageSize": 10,
  "searchKeyword": "phone case"
}

Example structuredContent

{}