| name | ecommerce.competitor-listing-analyzer |
| version | 1.0.0 |
| description | 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.
|
| allowed-tools | ["Bash","Read","Write","WebFetch"] |
| metadata | {"requires":null,"apis":["nexscope"],"auth":null,"scopes":["products:read"],"identity":"seller"} |
📖 Analysis Philosophy:
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 cd into 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.
Competitor Listing Analyzer
Product Understanding Step
Before running this skill, if the user provides a product, image, ASIN, listing, product ID, or product idea, first identify:
- product type/category
- main use case
- key physical, design, or functional features
- target marketplace, country, or platform
- user's analysis goal
Use this product understanding to choose parameters, filters, competitors, regions, keywords, or analysis dimensions before executing the script.
Core Question
**** — How do competitors write their listings?
When to Use
- User asks "how does competitor write their listing"
- User wants to analyze a specific ASIN's listing
- User asks for "listing structure breakdown"
- User wants to reverse-engineer successful listings
- User asks "what can I learn from this listing"
Differs From / Not Applicable
- Use competitor-analyzer for price, reviews, BSR, traffic, sales, and business-performance comparisons.
- Use this skill for listing structure and creative/content audits.
- Do not use for market-level analysis, product validation, or review sentiment monitoring.
Data Sources
| Source | Endpoint | Purpose |
|---|
| Amazon | /api/v1/tools/research/amazon/product/detail | Full listing content extraction |
| Amazon | /api/v1/tools/research/amazon/search | Find top competitors by keyword |
Parameters
| Parameter | Type | Required | Default | Description |
|---|
asin | string | Yes* | - | Target ASIN to analyze |
asins | list | Yes* | - | Multiple ASINs to compare |
keyword | string | Yes* | - | Find top competitors for keyword |
marketplace | string | No | | Target marketplace |
depth | string | No | "standard" | Analysis depth: quick/standard/deep |
*One of asin, asins, or keyword required
Output Structure
The output will be a structured markdown report, following this format:
[Product/Keyword] Competitor Listing Analysis Report
1. Executive Summary
- Analysis Object: [Display asin, asins, or keyword based on input parameters]
- Analysis Depth: [depth]
- Core Insight: [Summary extracted from
overall_score, strengths, weaknesses, and recommendations fields]
2. Overall Analysis & Comparison
- Listing Score Comparison (for each analyzed ASIN):
| ASIN | Overall Score | Title Score | Bullet Score | Strengths | Weaknesses |
|---|
| [analyzed_listings[i].asin] | [analyzed_listings[i].overall_score] | [analyzed_listings[i].title_analysis.title_score] | [analyzed_listings[i].bullet_analysis.bullet_score] | [analyzed_listings[i].strengths] | [analyzed_listings[i].weaknesses] |
| ... | ... | ... | ... | ... | ... |
| (If multiple ASINs are analyzed, comparison data for all ASINs will be listed here.) | | | | | |
- General Recommendations:
- [First recommendation from
recommendations]
- [Second recommendation from
recommendations]
- ...
3. Detailed Listing Structure Analysis
(Detailed analysis for each analyzed ASIN)
Target ASIN: [analyzed_listings[i].asin]
4. Attached Visualizations
- Listing Score Comparison
- Title Structure Breakdown
- Bullet Pattern Analysis
- Image Strategy Matrix
Analysis Dimensions
Title Analysis
- Character count & mobile truncation check
- Structure pattern detection
- Keyword extraction
- Brand positioning
Bullet Points Analysis
- Count and length
- Feature-Benefit pattern detection
- Keyword density
- Emoji/formatting usage
- Unique selling points
Description Analysis
- Plain text vs A+ Content
- Structure breakdown
- Keyword usage
- Call-to-action presence
Image Analysis
- Image count
- Video presence
- Infographic detection
- Lifestyle vs product shots
⚠️ MANDATORY: Charts & Display Rules
- Generate charts by default for full analytical reports — use
--chart with an output directory unless the user asks for a quick text-only result or chart data is unavailable.
- Send generated charts to the user — when charts are created, share all chart PNGs immediately.
- All chart styling is driven by
ecommerce_chart_helpers.py which reads from chart_style.json (derived from references/display-rules.md). Do NOT hardcode colors in scripts.
Usage
python3 scripts/competitor_listing_analyzer.py '{"asin": "B07RL88DD2"}'
python3 scripts/competitor_listing_analyzer.py '{"asins": ["B07RL88DD2", "B08EXAMPLE"]}'
python3 scripts/competitor_listing_analyzer.py '{"keyword": "yoga mat", "depth": "deep"}'
python3 scripts/competitor_listing_analyzer.py '{"keyword": "yoga mat"}' --chart /tmp/charts
Charts Generated
- Listing Score Comparison — Overall scores across competitors
- Title Structure Breakdown — How competitors structure titles
- Bullet Pattern Analysis — Feature types and patterns
- Image Strategy Matrix — Image types used
Workflow
┌─────────────────────────────────────────────────────────────┐
│ 1. INPUT: ASIN(s) or keyword │
│ 2. EXTRACT: Fetch full listing content from Amazon │
│ 3. PARSE: Break down title, bullets, description │
│ 4. ANALYZE: Score each component, detect patterns │
│ 5. COMPARE: Cross-competitor analysis │
│ 6. RECOMMEND: Actionable improvements │
└─────────────────────────────────────────────────────────────┘
Insights Generated
- 🎯 Title structure patterns
- 📝 Bullet writing formulas
- 🖼️ Image strategy insights
- ⭐ What top sellers do differently
- 🚫 Common mistakes to avoid
Limitations
- A+ Content extraction may be limited
- Some enhanced content may be unavailable through API data
- Brand Registry features not always visible
- Video content analysis is basic
- Non-US marketplaces may have different patterns
Environment Variables
| Variable | Required | Description |
|---|
NEXSCOPE_PROXY_BASE | Yes | NexScope proxy base URL |
NEXSCOPE_API_KEY | Yes | NexScope proxy API key |
References
references/listing-best-practices.md — Amazon listing guidelinesreferences/display-rules.md — Output formatting rules
