This skill guides you on how to generate comprehensive AI-powered market insight reports for Amazon keywords, helping sellers make data-driven product selection and market entry decisions.
Core Concepts
This tool generates a comprehensive business insight report by analyzing six core dimensions of an Amazon keyword:
- Market Potential - Search volume, demand trends, and growth opportunity
- Product Characteristics - Common product attributes, materials, features
- User Reviews - Customer sentiment, pain points, and satisfaction drivers
- Customer Profile - Buyer demographics, preferences, and behavior patterns
- Search Trends - Keyword popularity trajectory and seasonality
- Pricing Analysis - Price distribution, competitive pricing landscape
The report is generated by AI from real-time Amazon data and delivered as a structured Markdown document. It is a snapshot analysis for decision support, not a real-time monitoring tool.
Parameters
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
| site | string | Yes | Amazon marketplace code (currently US only) | US |
| keyword | string | Yes | The search keyword to analyze | - |
Supported Marketplaces
Currently only US (United States) is supported. Always set site to US. If a user requests other marketplaces, inform them this tool currently only covers the US market.
API Invocation
- API Endpoint:
POST /amazon/opportunity/reportByKeyword(full parameters/responses/error codes seereferences/api.md) - Python Script:
python scripts/amazon_opportunity_report.py '<JSON params>' [--inline] - Cost Constraint: This tool consumes credits; the same parameter combination is called only once per session by default, with a 24h local cache in the script. Do not automatically retry with different keywords, pagination, or zip codes after failures/empty results; inform the user about additional cost before continuing.
Output Strategy (default script behavior):
- Always write the full response to
<cwd>/nexscope/<YYYY-MM-DD>/<session>/data/nexscope-amazon-opportunity-report-by-keyword-<timestamp>.json(<cwd>is the working directory at script execution time, which in Claude Code is the current project directory;<session>is taken from theSESSION_IDenvironment variable, auto-grouped by user task; do NOT write to /tmp — error out if the current directory is not writable) - Response body <= 8 KB: after writing to disk, print the full JSON to stdout
- Response body > 8 KB: after writing to disk, stdout outputs only a summary (top-level fields, common counts like
total/costToken, length of the largest list field + first 3 samples) - Add
--inlineto force full output to stdout (while still writing to disk)
Data Reading Tips: First check the summary to see if it is sufficient; when specific fields are needed, prefer using jq or ConvertFrom-Json to extract from the saved JSON file on demand, avoiding loading the entire JSON into context.
Authentication
Set the NEXSCOPE_API_KEY environment variable. If authentication fails (401/402) or you see insufficient balance errors, visit https://www.nexscope.ai/help/skills-external-access?co-from=skillNS to get an API Key or top up credits.
Usage Examples
1. Basic Market Opportunity Report
Help me search for a business insight report on the US marketplace for the keyword "hair mousse travel size"
2. Niche Product Research
Generate a business insight report for the US marketplace keyword "magnetic shelves for whiteboard"
3. Trend-Based Product Selection
I want to understand the business insights for the US keyword "solar power ac unit" — generate a report
Display Rules
- Present the report directly: The API returns a Markdown-formatted report in the
stdoutfield - display it as-is to the user - No subjective advice: Present the AI-generated analysis without adding your own business recommendations
- Clarify scope: Remind users the report is based on a point-in-time snapshot and serves as a reference for decision-making
- Error handling: When a query fails, explain the reason based on the
msgfield and suggest checking the keyword or trying again - No secondary analysis: This tool's output cannot be fed into data query tools for further processing - inform users if they attempt this
Important Limitations
- US only: Currently only supports the United States marketplace (site = US)
- Non-structured output: Returns a Markdown report, not structured JSON data. Cannot be used with data query tools for secondary aggregation or analysis
- Processing time: Report generation involves AI analysis and may take longer than simple data lookups
- Snapshot data: Reports reflect data at the time of generation and are not continuously updated
User Expression & Scenario Quick Reference
Applicable - Comprehensive keyword-level market analysis:
| User Says | Scenario |
|---|---|
| "Help me analyze this keyword's market opportunity" | Market opportunity assessment |
| "Generate a market insight report for XX" | Full insight report |
| "What's the competitive landscape for XX" | Competition & pricing analysis |
| "Consumer profile for XX product" | Customer behavior insights |
| "Is XX keyword worth entering" | Market entry evaluation |
| "Product selection report", "Business insights" | Chinese market research requests |
Not applicable - Needs beyond comprehensive report generation:
- Real-time keyword ranking tracking (use ABA or SIF tools)
- Individual product detail lookup (use product detail tools)
- Historical price tracking (use Keepa)
- Review-level analysis for specific ASINs (use review tools)
- Advertising / PPC strategy
Boundary judgment: When users say "market analysis" or "product research", if they want a holistic, multi-dimensional overview of a keyword's market opportunity, this skill applies. If they need specific data points (exact sales numbers, individual product details, keyword rankings over time), direct them to the appropriate specialized tool.