Amazon Competitor Analyzer

This skill collects Amazon product data from user-provided ASINs through the project-local BrowserWorker plugin browser and performs deep competitive analysis.

When to Use This Skill

• Competitive research: Input multiple ASINs to understand market landscape
• Pricing strategy analysis: Compare price bands across similar products
• Specification benchmarking: Deep dive into technical specs and feature differences
• Review insights: Analyze review quality, quantity, and sentiment patterns
• Market opportunity discovery: Identify gaps and potential threats

What This Skill Does

1. ASIN Data Collection: Extract product title, price, rating, review count, images
2. Specification Extraction: Deep extraction of technical specs, features, and materials
3. Review Quality Analysis: Analyze review patterns, keywords, and sentiment
4. Multi-Dimensional Comparison: Side-by-side comparison of key metrics
5. Moat Identification: Identify core competitive advantages and barriers
6. Vulnerability Discovery: Find competitor weaknesses and market opportunities

Features

1. Stable browser extraction: Use BrowserWorker page_semantics / semantic_key first, then snapshot/evaluate loops to verify and read the rendered Amazon page.
2. No external browser service: Do not require BrowserAct, Playwright, Selenium, ChromeDriver, or a site-specific remote browser API.
3. Cross-platform install behavior: Browser control goes through the bundled daemon and Chrome extension transport on macOS and Windows.
4. Bounded execution: Keep ASIN count and detail visits limited; stop on login, captcha, region prompts, or blocks.
5. Cost efficient: Reduces manual research time without adding paid automation-service credentials.

Prerequisites

BrowserWorker Runtime

• ManAI 主程序或项目内 BrowserWorker daemon 可用。
• 端口发现顺序：BrowserWorker_PORT -> BrowserWorker_LOCK_FILE -> MANAI_WORKSPACE_ROOT / MANAI_HOME 下的 storage/browser_daemon.lock -> 默认 12321。
• 不要求用户注册 BrowserAct、配置 BROWSERACT_API_KEY，也不要求用户安装 Python 第三方包。
• 浏览器交互必须先读取 page_semantics 并按 semantic_key 或结构化 target 理解关键区域；缺少语义记录时再用 snapshot / detect_page_state 验证当前页面，随后通过 browser.evaluate(...) 从真实渲染 DOM 中提取标题、价格、评分、评论数、图片、规格和 bullet points。不要在可复用脚本中保存 snapshot ref / handle。
• 遇到 Amazon 登录、验证码、地区确认、风控或空白页时，必须调用 browser.request_help(...) 或停止，严禁绕过验证或高频重试。

Usage

Basic Analysis

python amazon-competitor-analyzer/amazon_competitor_analyzer.py B09G9GB4MG

Multiple Products

python amazon-competitor-analyzer/amazon_competitor_analyzer.py B09G9GB4MG B07ABC11111 B08N5WRWNW

With Output Directory

python amazon-competitor-analyzer/amazon_competitor_analyzer.py B09G9GB4MG --max-detail-visits 1

Output Formats

• Markdown: Comprehensive report
• JSON: Raw data with analysis

Parameters

Parameter	Type	Default	Description
asins	string	-	One or more Amazon ASINs to analyze
--amazon-url	string	https://www.amazon.com/	Amazon marketplace base URL
--max-detail-visits	integer	10	Maximum product detail pages to open in one run
--wait-ms	integer	2200	Base wait after page navigation

Dependencies

Browser automation must use the bundled BrowserWorker daemon and Python standard library HTTP client. Do not add requests, python-dotenv, BrowserAct SDKs, Playwright, Selenium, ChromeDriver, pandas, or BeautifulSoup as runtime requirements for this skill.

Environment Variables

Variable	Required	Description
BrowserWorker_PORT	No	Optional BrowserWorker daemon HTTP port override
BrowserWorker_LOCK_FILE	No	Optional BrowserWorker lock file path

Error Handling

• BrowserWorker down: Resolve port from lock file; if daemon is not responding, start the project-local BrowserWorker daemon.
• Login/Captcha/Region Prompt: Request user help in the plugin browser and continue only after page state is valid.
• Network Error: Verify internet connection and retry with a smaller ASIN set.
• Rate Limit/Block: Stop the run, reduce scope, and avoid repeated navigation.
• Invalid ASIN: Verify ASIN format (10 alphanumeric characters)

---

Version: 1.0.0
Updated: 2026-02-09
Template ID: 77814333389670716