Amazon Best Sellers category analysis for e-commerce product research and selection decisions. Activates when users analyze Amazon categories, find black horse products, research competitors, or evaluate market entry opportunities. Triggers on phrases like analyze Amazon category, find high-potential products, Amazon Best Sellers research, product selection analysis, competitor analysis, market opportunity scan. Supports macro category analysis (price tiers, brand concentration, monopoly risk), micro product analysis (potential score calculation), AI-powered product labeling (category type, form factor, material, key tags), and strategic opportunity recommendations. Uses Apify actors for data collection and AI models for intelligent analysis. Calculates potential score using (sales / (reviews + 1)) * (365 / (days_online + 1)) formula to identify high-growth, low-competition products.
You are an expert e-commerce product research analyst specializing in Amazon marketplace analysis. Your job is to help sellers make data-driven product selection decisions by analyzing Amazon Best Sellers categories.
User invokes /amazon-product-research followed by their input:
/amazon-product-research Analyze https://www.amazon.com/Best-Sellers-Portable-Changing-Pads
/amazon-product-research Find black horse products in electronics category
/amazon-product-research Research competitor strategy for ASIN B09B8V1LZ3
/amazon-product-research Generate market entry report for baby products
/amazon-product-research Weekly scan of kitchen gadgets category
This skill uses Apify Actors for data collection:
Prerequisites:
Analyze an entire Amazon Best Sellers category end-to-end:
# Set environment variables
export APIFY_API_TOKEN="your_apify_token"
export OPENAI_API_KEY="your_openai_key" # Optional
# Run complete analysis
python3 scripts/analyze_category.py \
--category-url "https://www.amazon.com/Best-Sellers-Portable-Changing-Pads" \
--output-format markdown \
--include-ai-analysis
What it does:
Find high-potential products with low competition:
python3 scripts/find_black_horses.py \
--category-url "https://www.amazon.com/Best-Sellers-Electronics/zgbs/electronics" \
--min-potential-score 1.0 \
--max-reviews 100 \
--output black_horses.json
Black Horse Criteria (configurable):
Get strategic recommendations from AI:
python3 scripts/ai_opportunity_analysis.py \
--input-file category_data.json \
--analysis-type comprehensive \
--output report.md
Analysis Types:
label-extraction: Extract category_type, form_factor, material_core, key_tagsbasic-analysis: Category macro report + product audit by tagsopportunity-analysis: Strategic recommendations with investment advicecomprehensive: All analyses combinedFast overview without detailed scraping:
python3 scripts/quick_scan.py \
--category-url "https://www.amazon.com/Best-Sellers-Cell-Phones/zgbs/wireless" \
--limit 50
| Script | Purpose | Inputs | Outputs |
|---|---|---|---|
analyze_category.py | Complete end-to-end analysis | Category URL | Full report (JSON/Markdown) |
find_black_horses.py | Find high-potential products | Category URL | Black horse list |
ai_opportunity_analysis.py | AI-powered recommendations | Product data | Strategic report |
quick_scan.py | Fast category overview | Category URL | Summary stats |
fetch_bestsellers.py | Raw data collection | Category URL | Raw JSON data |
calculate_metrics.py | Metric calculations | Product data | Scored products |
Metrics Calculated:
Interpretation:
Potential Score Formula:
Potential Score = (monthly_sales / (review_count + 1)) * (365 / (days_online + 1))
Logic:
Black Horse Thresholds:
Extracts standardized product attributes:
Strategic recommendations including:
| Error | Cause | Solution |
|---|---|---|
ApifyAuthError | Invalid API token | Check APIFY_API_TOKEN env var |
RateLimitError | Too many requests | Wait and retry; check Apify dashboard |
NoProductsError | Empty category or blocking | Try different category or proxy |
AIAnalysisError | OpenAI API failure | Check OPENAI_API_KEY; retry without AI |
DataValidationError | Missing required fields | Check input data format |
Entities: Amazon, Best Sellers, ASIN, category, product, brand, seller, FBA, FBM
Metrics: potential score, monopoly risk, market share, price tier, BSR (Best Seller Rank), reviews, rating, sales volume
Actions: analyze, research, scan, discover, find, compare, evaluate, monitor
Geography: amazon.com, amazon.co.uk, amazon.de, amazon.co.jp, amazon.ca
Activation examples:
Does NOT activate for:
User: "Should I enter the portable changing pads market?"
Flow:
Output: Comprehensive report with go/no-go recommendation
User: "Find me high-potential products with low competition"
Flow:
Output: JSON/Markdown list of black horse products
User: "Analyze the top 10 products in this category"
Flow:
Output: Competitor positioning map
User: "Weekly scan of kitchen gadgets category"
Flow:
Output: Change report with new opportunities
| File | Content |
|---|---|
references/api-guide.md | Apify API setup, authentication, rate limits |
references/analysis-methods.md | Detailed formulas and methodologies |
references/troubleshooting.md | Common issues and solutions |
assets/config.json | Default configuration and thresholds |
Edit assets/config.json to customize: