ecommerce-amazon-traffic-gap-analyst

Installation
SKILL.md

Amazon Traffic Gap Analyst

Compare one owned product with preferably 3–5 competitors in one Amazon marketplace and one time window. Use the bundled standard-library Python CLI; no browser extension, sibling Skill, cloud scheduler, report service or seller authorization is required. Calls to Nexscope consume credits. Do not invent unavailable data.

There is no separate expert workflow fee. Before execution, show the selected APIs, their per-call credit references from references/api.md, and the planned request counts, including pages and child ASINs. Local report rendering makes no API calls.

Setup and bounded collection

Python 3.9+ is required. Set NEXSCOPE_API_KEY and optionally NEXSCOPE_PROXY_BASE=https://api.nexscope.ai. Never put keys in prompts, JSON files or command arguments. The existing research compatibility routes start with /api/v1/tools/research/; this package uses the equivalent existing public Skill API routes documented in references/api.md.

  1. Establish own ASIN, competitor ASINs, marketplace and 7- or 30-day source window. When the user supplies no competitors, use the competitors or related API operation with a bounded request, then have the user/agent select relevant peers. Include direct peers, a leading benchmark and a growing challenger when evidence supports those labels. Suggest 3–5; warn when more than 10 are requested.

  2. Read current product details to identify variants. Confirm the child-ASIN grouping; collect all relevant children rather than analyzing a single child as the whole product. If grouping is unknown, explicitly label the result as child-only and obtain confirmation. Avoid an unbounded expansion of paid calls.

  3. Prepare a UTF-8 config as in references/report.md. Use an absolute writable output path that does not exist yet. Start with a plan:

    python scripts/traffic_gap.py collect --config request.json --out ./nexscope/traffic-gap-run
    
  4. Explain the planned maximum requests and credit consumption. After applicable user approval, execute with an explicit call budget:

Installs
3
GitHub Stars
114
First Seen
Oct 19, 2026