菜单
Produce a broad market snapshot across demand, competition, price, and platforms. Triggers: market overview, what is this market like, full market picture. Use for broad context, not go/no-go scoring, share concentration, or recent alerts.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Compare Amazon competitor business metrics: price, reviews, BSR, sales, seller count, traffic. Triggers: competitor metrics, who performs best, price/BSR/review comparison. Use for business performance, not listing copy; use competitor-listing-analyzer for content structure.
Analyze Amazon listing content and structure: title, bullets, images, A+ content, and listing quality. Triggers: listing breakdown, reverse-engineer listings, title/bullet/image analysis. Use for content audits, not business metrics; use competitor-analyzer for price/BSR/sales.
Validate whether demand is real by comparing search volume with sales and buying intent. Triggers: is demand real, fake demand, inflated volume, are people buying, conversion gap. Use for demand proof, not broad market overview or niche go/no-go scoring.
Check visual/design patent similarity from product images. Triggers: design infringement, look-alike patent, visual similarity, design clearance. Use for appearance/design risk, not utility claims or legal-status checks.
Suggest product differentiation and USP using competitor/review evidence. Triggers: how to stand out, USP, competitive advantage, product improvement. Use for positioning and feature strategy, not raw competitor metrics or review monitoring.
Find visually similar Amazon products from an image. Triggers: reverse image search, find lookalikes, who else sells this, source by image. Use for marketplace lookalikes, not patent similarity or design infringement checks.
| name | ecommerce.market-overview |
| version | 2.3.0 |
| description | Produce a broad market snapshot across demand, competition, price, and platforms. Triggers: market overview, what is this market like, full market picture. Use for broad context, not go/no-go scoring, share concentration, or recent alerts. |
| allowed-tools | ["Bash","Read","Write"] |
IMPORTANT — Working Directory: All scripts in this skill MUST be executed with the working directory set to the absolute path of the directory containing this SKILL.md file (the skill root directory). Always
cdinto this directory before running any command. Do NOT use relative paths or shell shortcuts like~in paths, as they may not be resolved by the execution environment.
Before running this skill, if the user provides a broad product category, niche, keyword, market idea, or trend topic, first identify:
Use this market understanding to choose keywords, filters, regions, comparison scope, and analysis dimensions before executing the script.
What's the market like? Complete market intelligence.
Comprehensive market analysis covering industry overview, competitive landscape, consumer demand, and multi-platform comparison.
— What's this market like? — Give me the market overview.
| Source | Endpoint | Data |
|---|---|---|
| Amazon Search | /api/v1/tools/research/amazon/search | Products, prices, reviews, BSR |
| eBay Search | /api/v1/tools/research/ebay/search | Cross-platform pricing |
| Walmart Search | /api/v1/tools/research/walmart/search | Multi-channel comparison |
| Jungle Scout | /api/v1/tools/jungle-scout/keywords/share-of-voice | Search volume, brand SOV |
| ABA (Amazon Brand Analytics) | /api/v1/tools/research/aba/intelligentQuery | Search Frequency Rank |
| TikTok Echotik | /api/v1/tools/research/echotik/listProduct | Social commerce signals |
| Keepa | /api/v1/tools/research/keepa/productSeries | Historical BSR, price trends |
| Dimension | Description |
|---|---|
| Industry Overview | Market size, growth trends |
| Competitive Landscape | Brand concentration, top players |
| Consumer Demand | Search patterns, buying behavior |
| Price Analysis | Distribution, sweet spots |
| Multi-Platform | Amazon vs eBay vs Walmart |
| Compliance | Category restrictions, requirements |
--chart with an output directory unless the user asks for a quick text-only result or chart data is unavailable.ecommerce_chart_helpers.py which reads from chart_style.json (derived from references/display-rules.md). Do NOT hardcode colors in scripts.# Full market overview
python3 scripts/market_overview.py '{"keyword": "yoga mat"}'
# Specific platform focus
python3 scripts/market_overview.py '{"keyword": "face wash", "platforms": ["amazon"]}'
# Different market
python3 scripts/market_overview.py '{"keyword": "kombucha", "market": "UK"}'
# With chart output
python3 scripts/market_overview.py '{"keyword": "yoga mat"}' --chart /tmp/output
# With market sizing
python3 scripts/market_overview.py '{"keyword": "yoga mat"}' --market-size
# Export to CSV
python3 scripts/market_overview.py '{"keyword": "yoga mat"}' --csv /tmp/market.csv
| Parameter | Type | Default | Description |
|---|---|---|---|
keyword | string | required | Market keyword |
market | string | Target marketplace | |
platforms | array | ["amazon"] | Platforms to analyze |
limit | int | 50 | Products per platform |
The output will be a structured markdown report, following this format:
Market Overview Analysis Report: [Keyword]
1. Executive Summary
2. Platform Data Comparison
| Platform | Product Count | Average Price | Average Reviews | Average Rating | Monthly Revenue (Est.) |
|---|---|---|---|---|---|
| Amazon | [platforms.amazon.total_products] | [platforms.amazon.avg_price] | [platforms.amazon.avg_reviews] | [platforms.amazon.avg_rating] | [platforms.amazon.total_monthly_revenue] |
| eBay | [platforms.ebay.total_products] | [platforms.ebay.avg_price] | - | - | - |
| Walmart | [platforms.walmart.total_products] | [platforms.walmart.avg_price] | - | - | - |
3. Brand & Competitive Landscape
| Rank | Brand | Product Count |
|---|---|---|
| 1 | [platforms.amazon.top_brands[0][0]] | [platforms.amazon.top_brands[0][1]] |
| 2 | [platforms.amazon.top_brands[1][0]] | [platforms.amazon.top_brands[1][1]] |
| 3 | [platforms.amazon.top_brands[2][0]] | [platforms.amazon.top_brands[2][1]] |
4. Consumer Demand Analysis
| Metric | Value |
|---|---|
| Search Frequency Rank (SFR) | [enhanced_data.aba.search_frequency_rank] |
| Volume Tier | [enhanced_data.aba.volume_tier] |
| Platform | Units Sold / Product Count | Demand Level | Price Comparison (vs Amazon) | Opportunity Assessment |
|---|---|---|---|---|
| eBay | [enhanced_data.ebay_sold.sold_count] | [enhanced_data.ebay_sold.demand_level] | eBay Avg: [enhanced_data.ebay_sold.price_comparison.ebay_avg] | - |
| TikTok | [enhanced_data.tiktok.product_count] | - | - | [enhanced_data.tiktok.opportunity] (GMV: [enhanced_data.tiktok.estimated_gmv]) |
5. Market Sizing Estimation (If available)
(Displayed only if market_sizing data is present)
| Type | Total Amount | E-commerce Portion (if applicable) |
|---|---|---|
| TAM (Total Addressable Market) | [market_sizing.tam.total_retail] | [market_sizing.tam.ecommerce] |
| SAM (Serviceable Addressable Market) | [market_sizing.sam.amazon] (Amazon) | - |
| SOM (Serviceable Obtainable Market - Estimate) | [market_sizing.som.conservative_1pct] (Conservative 1% Share) | [market_sizing.som.aggressive_3pct] (Aggressive 3% Share) |
6. Overall Insights & Recommendations
| Metric | Value |
|---|---|
| Average Reviews | [insights.key_metrics.avg_reviews] |
| Average Rating | [insights.key_metrics.avg_rating] |
| Average Price | [insights.key_metrics.avg_price] |
| Monthly Revenue | [insights.key_metrics.monthly_revenue] |
insights.recommendations]insights.recommendations]7. Attached Visualizations
| Chart | Description | File |
|---|---|---|
| Cross-Platform Comparison | Price/volume by platform | cross_platform.png |
| Price Distribution | Price segment bar | price_distribution.png |
| Market Share | Top brands pie | market_share.png |
| Demand Trend | Search volume over time | demand_trend.png |
| Indicator | Healthy | Warning |
|---|---|---|
| Growth Trend | Rising/Stable | Declining |
| Concentration | <60% CR4 | >80% CR4 |
| Price Stability | <10% variance | >25% variance |
| New Entrant Success | >20% new in top 50 | <5% new |
📈 Discovery Phase
├── trend-discovery → Find trending categories
├── market-overview → Understand the market ← YOU ARE HERE
└── niche-evaluator → Evaluate niche potential
| Variable | Required | Description |
|---|---|---|
NEXSCOPE_API_KEY | Yes | NexScope proxy API key |
NEXSCOPE_PROXY_BASE | Yes | NexScope proxy base URL |
references/display-rules.md — Chart styling guidelines