Amazon

Amazon Opportunity Search By Metrics

Amazon reverse product selection: filter Amazon niches and keywords by 30+ business dimensions (market size & growth, price tiers & share, competition density & top concentration, demographics such as age/gender/income, review highlights & pain points) from a metrics pool aggregated from historical business insight reports.

MCP tool name

nexscope_amazon_opportunity_search_by_metrics

MCP endpoint

https://api.nexscope.ai/api/skill-api/v2/mcp

JSON-RPC method

tools/call

Authentication

Use OAuth 2.1 Authorization Code with PKCE and the mcp:tools scope for standard remote clients. API keys remain supported as a compatibility option while v1 integrations migrate.

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

Initialize an MCP 2025-11-25 Streamable HTTP session at https://api.nexscope.ai/api/skill-api/v2/mcp, then use tools/call with the MCP tool name below. The arguments object should match the table on this page.

{
  "jsonrpc": "2.0",
  "id": "amazon-opportunity-search-by-metrics-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_amazon_opportunity_search_by_metrics",
    "arguments": {
      "amazonDomain": "US",
      "limit": 10,
      "keyword": "phone case"
    }
  }
}

Protocol

MCP 2025-11-25 · Streamable HTTP

Canonical detail URL

https://www.nexscope.ai/mcp-map/amazon-opportunity-search-by-metrics

Progress is delivered on the original POST SSE response when the client supplies a progress token and the tool has real execution stages. GET SSE carries server notifications such as tool-list changes. Creating an asynchronous task or calling an external provider may consume credits; reconnecting must query the existing task instead of submitting it again.

Arguments

Name	Type	Required	Description
`amazonDomain`	`string`	optional	Amazon site code (closed enum), currently only supports US. Defaults to US only if not specified Example: US
`limit`	`integer`	optional	Maximum number of results to return (1-200), default 25. No page parameter; returns the most recent N records sorted by collection time descending Example: 25
`keyword`	`string`	optional	Search keyword text fragment (LIKE fuzzy match) Example: phone case
`nicheName`	`string`	optional	Normalized niche name fragment (LIKE, snake_case lowercase), suitable for niche time-series comparison Example: {}
`nicheRevenue360dMinUsdAtLeastGte`	`number`	optional	Minimum 360-day market revenue lower bound (USD) Example: 1
`nicheRevenue360dMinUsdAtLeastLte`	`number`	optional	Maximum 360-day market revenue lower bound (USD) Example: 1
`nicheRevenue360dMaxUsdAtLeastGte`	`number`	optional	Minimum 360-day market revenue upper bound (USD) Example: 1
`nicheRevenue360dMaxUsdAtLeastLte`	`number`	optional	Maximum 360-day market revenue upper bound (USD) Example: 1
`nichePeakSearchVolumeAtLeastGte`	`integer`	optional	Peak monthly search volume minimum (non-negative integer) Example: 1
`nichePeakSearchVolumeAtLeastLte`	`integer`	optional	Peak monthly search volume maximum (non-negative integer) Example: 1
`nicheSearchVolumeYoyChangePctAtLeastGte`	`number`	optional	Search volume YoY change rate minimum (%, signed) Example: 1
`nicheSearchVolumeYoyChangePctAtLeastLte`	`number`	optional	Search volume YoY change rate maximum (%, signed) Example: 1
`nichePeakMonthGte`	`integer`	optional	Search peak month minimum (1-12) Example: 1
`nichePeakMonthLte`	`integer`	optional	Search peak month maximum (1-12) Example: 1
`nicheBrandCountGte`	`integer`	optional	Active brand count minimum Example: 1
`nicheBrandCountLte`	`integer`	optional	Active brand count maximum Example: 1
`nicheBrandCountYoyChangePctAtLeastGte`	`number`	optional	Brand count YoY change rate minimum (%, signed) Example: 1
`nicheBrandCountYoyChangePctAtLeastLte`	`number`	optional	Brand count YoY change rate maximum (%, signed) Example: 1
`nicheTop5ProductClickSharePctAtLeastGte`	`number`	optional	Top 5 product click share minimum (0-100) Example: 1
`nicheTop5ProductClickSharePctAtLeastLte`	`number`	optional	Top 5 product click share maximum (0-100) Example: 1
`featureTop5BrandSharePctAtLeastGte`	`number`	optional	Top 5 brand combined share minimum (0-100) Example: 1
`featureTop5BrandSharePctAtLeastLte`	`number`	optional	Top 5 brand combined share maximum (0-100) Example: 1
`featureTopBrandsContains`	`string`	optional	Top 3 brand name fragment (original text LIKE, case-sensitive) Example: {}
`priceMinUsdGte`	`number`	optional	Niche minimum product price lower bound (USD) Example: 1
`priceMinUsdLte`	`number`	optional	Niche minimum product price upper bound (USD) Example: 1
`priceMaxUsdGte`	`number`	optional	Niche maximum product price lower bound (USD) Example: 1
`priceMaxUsdLte`	`number`	optional	Niche maximum product price upper bound (USD) Example: 1
`priceSweetSpotMinUsdGte`	`number`	optional	Sweet spot lower bound minimum (USD) Example: 1
`priceSweetSpotMinUsdLte`	`number`	optional	Sweet spot lower bound maximum (USD) Example: 1
`priceSweetSpotMaxUsdGte`	`number`	optional	Sweet spot upper bound minimum (USD) Example: 1
`priceSweetSpotMaxUsdLte`	`number`	optional	Sweet spot upper bound maximum (USD) Example: 1
`priceEntryClickSharePctAtLeastGte`	`number`	optional	Entry tier click share minimum (0-100) Example: 1
`priceEntryClickSharePctAtLeastLte`	`number`	optional	Entry tier click share maximum (0-100) Example: 1
`priceMidClickSharePctAtLeastGte`	`number`	optional	Mid tier click share minimum (0-100) Example: 1
`priceMidClickSharePctAtLeastLte`	`number`	optional	Mid tier click share maximum (0-100) Example: 1
`priceHighClickSharePctAtLeastGte`	`number`	optional	High tier click share minimum (0-100) Example: 1
`priceHighClickSharePctAtLeastLte`	`number`	optional	High tier click share maximum (0-100) Example: 1
`demoPrimaryAgeMinGte`	`integer`	optional	Primary audience age lower bound minimum (0-120 years) Example: 1
`demoPrimaryAgeMinLte`	`integer`	optional	Primary audience age lower bound maximum (0-120 years) Example: 1
`demoPrimaryAgeMaxGte`	`integer`	optional	Primary audience age upper bound minimum (0-120 years) Example: 1
`demoPrimaryAgeMaxLte`	`integer`	optional	Primary audience age upper bound maximum (0-120 years) Example: 1
`demoGenderDominant`	`string`	optional	Dominant gender (closed enum): female / male / mixed / unspecified Example: {}
`demoPrimaryIncomeTier`	`string`	optional	Income tier (closed enum): low / middle_low / middle / middle_upper / upper_middle / high Example: {}
`demoLifeStageTagsContains`	`string`	optional	Life stage tag fragment (snake_case, LIKE): parent, student, retiree, athlete, etc. Example: {}
`featureNewAvgReviewCountAtLeastGte`	`integer`	optional	New product average review count minimum (non-negative integer) Example: 1
`featureNewAvgReviewCountAtLeastLte`	`integer`	optional	New product average review count maximum (non-negative integer) Example: 1
`featureEstablishedAvgReviewCountAtLeastGte`	`integer`	optional	Established product average review count minimum (non-negative integer) Example: 1
`featureEstablishedAvgReviewCountAtLeastLte`	`integer`	optional	Established product average review count maximum (non-negative integer) Example: 1
`featureEmergingTrendTagsContains`	`string`	optional	Emerging trend feature tag fragment (snake_case, LIKE): cordless, portable, smart, etc. Example: {}
`featureUncommonFeatureTagsContains`	`string`	optional	Rare differentiation feature tag fragment (snake_case, LIKE): hema_free, medical_grade_silicone, etc. Example: {}
`searchTopCategory1Label`	`string`	optional	Search traffic top category 1 label fragment (snake_case, LIKE): core_product_terms, set_kit_configurations, etc. Example: {}
`reviewPositiveTop1Topic`	`string`	optional	Positive review #1 topic fragment (snake_case, LIKE): comfort, quality_overall_generic, etc. Example: {}
`reviewPositiveTop1PctAtLeastGte`	`number`	optional	Positive review #1 topic share minimum (0-100, share among positive reviews) Example: 1
`reviewPositiveTop1PctAtLeastLte`	`number`	optional	Positive review #1 topic share maximum (0-100) Example: 1
`reviewNegativeTop1Topic`	`string`	optional	Negative review #1 topic fragment (snake_case, LIKE): size, quality, durability, etc. Example: {}
`reviewNegativeTop1PctAtLeastGte`	`number`	optional	Negative review #1 topic share minimum (0-100, share among negative reviews) Example: 1
`reviewNegativeTop1PctAtLeastLte`	`number`	optional	Negative review #1 topic share maximum (0-100) Example: 1
`reviewNegativeTop2Topic`	`string`	optional	Negative review #2 topic fragment (snake_case, LIKE) Example: {}
`reviewStrategicInsightTagsContains`	`string`	optional	Review strategic insight tag fragment (snake_case, LIKE): sizing_clarity, material_transparency, etc. Example: {}

Response fields

Treat structuredContent as the programmatic API response payload.

Name	Type	Required	Description
`data`	`any`	required	Data value used by this API operation.
`code`	`integer`	required	0 means accepted or successful; nonzero is a platform error.
`msg`	`string \| null`	required	Msg value used by this API operation.
`ts`	`string`	required	Epoch milliseconds.
`time`	`string`	required	Server local time: yyyy-MM-dd HH:mm:ss.
`cost`	`string`	required	Elapsed milliseconds, never credits; -1 outside web requests.
`traceId`	`string \| null`	required	Trace id value used by this API operation.

Any of option 1

Name	Type	Required	Description
`data`	`object`	required	Data value used by this API operation.
`data.data`	`array`	optional	Array of keyword metric records, each corresponding to a (site, keyword) combination, approximately 37 fields, sorted by collection time descending Example: []
`data.data[]`	`object`	required	Item in data data.
`data.data[].amazonDomain`	`string`	optional	Site code (currently fixed US) Example: null
`data.data[].keyword`	`string`

Examples

Example arguments

{
  "amazonDomain": "US",
  "limit": 10,
  "keyword": "phone case"
}

Example structuredContent

{
  "data": {
    "data": [
      {
        "keyword": "phone case",
        "nicheRevenue360dMinUsdAtLeast": 1,
        "nicheRevenue360dMaxUsdAtLeast": 1,
        "nichePeakSearchVolumeAtLeast": 1,
        "nichePeakMonth": 1,
        "nicheSearchVolumeYoyChangePctAtLeast": 1,
        "nicheBrandCount": 1,
        "nicheBrandCountYoyChangePctAtLeast": 1,
        "nicheTop5ProductClickSharePctAtLeast": 1,
        "featureTop5BrandSharePctAtLeast": 1,
        "featureTopBrands": [],
        "priceMinUsd": 1,
        "priceMaxUsd": 1,
        "priceSweetSpotMinUsd": 1,
        "priceSweetSpotMaxUsd": 1,
        "priceEntryClickSharePctAtLeast": 1,
        "priceMidClickSharePctAtLeast": 1,
        "priceHighClickSharePctAtLeast": 1,
        "demoPrimaryAgeMin": 1,
        "demoPrimaryAgeMax": 1,
        "demoLifeStageTags": [],
        "featureNewAvgReviewCountAtLeast": 1,
        "featureEstablishedAvgReviewCountAtLeast": 1,
        "featureEmergingTrendTags": [],
        "featureUncommonFeatureTags": [],
        "reviewPositiveTop1PctAtLeast": 1,
        "reviewNegativeTop1PctAtLeast": 1,
        "reviewStrategicInsightTags": []
      }
    ]
  },
  "code": 0,
  "msg": null,
  "ts": "0",
  "time": "2026-01-01 00:00:00",
  "cost": "-1",
  "traceId": null
}

Amazon Opportunity Search By Metrics

Amazon Opportunity Search By Metrics

Authentication

Call this MCP tool

Arguments

Response fields

Any of option 1

Examples

Example arguments

Example structuredContent

Related MCP tools

Any of option 2