Amazon Marketplace Intelligence

Amazon Product Research Directory MCP Tool

Use this directory to find the concrete API for a research goal. It returns links and typical inputs; invoke the linked API for the actual research data.

MCP tool name
nexscope_amazon_product_research
Equivalent REST API path
https://claw-callback.nexscope.ai/api/skill-api/v1/skills/amazon-product-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": "amazon-product-research-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_amazon_product_research",
    "arguments": {
      "goal": "all"
    }
  }
}
REST API equivalent
POST https://claw-callback.nexscope.ai/api/skill-api/v1/skills/amazon-product-research/run
Canonical detail URL
https://www.nexscope.ai/mcp-map/amazon-product-research

Arguments

NameTypeRequiredMeaning
goalstringoptional
Optional filter: all, search, detail, reviews, image-search, opportunity, keyword, price-history, or sales-estimates.
Example: all

Response fields

Treat structuredContent as the programmatic API response payload.

NameTypeRequiredMeaning
directoryTypestringrequired
Identifies this response as an API directory, not a research result.
Example: amazon-product-research-directory
goalstringrequired
Applied directory filter.
Example: all
countintegerrequired
Number of concrete API entries returned.
Example: 33
recommendedApisarrayrequired
Concrete APIs that execute the selected research operation.
Example: []
recommendedApis[].operationstringrequired
Original API operation name.
Example: amazon_search
recommendedApis[].slugstringrequired
Concrete API API slug to invoke.
Example: amazon-search
recommendedApis[].endpointstringrequired
Concrete API API run endpoint.
Example: /api/skill-api/v1/skills/amazon-search/run
recommendedApis[].reasonstringrequired
What the concrete API executes.
Example: Search Amazon storefront results by keyword.
recommendedApis[].typicalFieldsarrayrequired
Typical inputs for navigation; the linked API schema is authoritative.
Example: [ "keyword", "marketplace" ]
recommendedApis[].requestExampleobjectrequired
Example request for the concrete API.
Example: { "marketplace": "US", "keyword": "wireless speaker" }
usagestringrequired
Next step for callers.
Example: Invoke one recommended API directly for the actual research result.
errcodeintegeroptional
Upstream status code returned by the provider.
Example: {}
errmsgstringoptional
Upstream status message returned by the provider.
Example: {}
codestringoptional
Provider-specific status code.
Example: {}
msgstringoptional
Provider-specific status message.
Example: {}
messagestringoptional
Provider-specific message.
Example: {}
typestringoptional
Provider-specific render or payload type.
Example: {}
titlestringoptional
Provider-specific response title.
Example: {}
sourceTypestringoptional
Provider-specific source platform type.
Example: {}
sourceToolstringoptional
Provider-specific source tool name.
Example: {}
costTokenintegeroptional
Token cost reported by the upstream provider.
Example: {}
costTimeintegeroptional
Execution time reported by the upstream provider.
Example: {}
pageintegeroptional
Current page returned by the upstream provider.
Example: {}
pageSizeintegeroptional
Page size returned by the upstream provider.
Example: {}
pageItemCountintegeroptional
Item count on the current page returned by the upstream provider.
Example: {}
totalPageintegeroptional
Total page count returned by the upstream provider.
Example: {}
dataSnapshotMonthstringoptional
Data snapshot month returned by the upstream provider.
Example: {}

Examples

Example arguments

{
  "goal": "all"
}

Example structuredContent

{
  "directoryType": "amazon-product-research-directory",
  "goal": "all",
  "count": 33,
  "recommendedApis": [
    {
      "reason": "Search Amazon storefront results by keyword.",
      "endpoint": "/api/skill-api/v1/skills/amazon-search/run",
      "slug": "amazon-search",
      "operation": "amazon_search",
      "typicalFields": [
        "keyword",
        "marketplace"
      ],
      "requestExample": {
        "marketplace": "US",
        "keyword": "wireless speaker"
      }
    },
    {
      "reason": "Search Amazon Alexa ranking and product results.",
      "endpoint": "/api/skill-api/v1/skills/amazon-alexa-search/run",
      "slug": "amazon-alexa-search",
      "operation": "amazon_alexa_search",
      "typicalFields": [
        "keyword",
        "marketplace"
      ],
      "requestExample": {
        "marketplace": "US",
        "keyword": "wireless speaker"
      }
    }
  ],
  "usage": "Invoke one recommended API directly for the actual research result."
}