Skip to content
cccskills
FreePublished on GitHub

ecommerce.amazon-market-statistics

Use Nexscope market statistics capability to output a market statistics dashboard by category node, including top listing average rating, average price, BSR, sales, seller count, and new product related metrics, suitable for quickly assessing the market quality and competitive landscape of a category. Trigger when the user mentions category market statistics, market selection dashboard, market fundamentals assessment, node market quality, top product statistics, Nexscope market statistics, category statistics. Even if the user does not explicitly mention "Nexscope", if the need is to view aggregated statistical results by category node, this skill should also be triggered.

The English summary is being prepared. Showing the original description.

Run score Not tested

See how to install

Files included (4)

  • SKILL.md3.9 KB
  • manifest.json228 B
  • references/api.md6.9 KB
  • scripts/amazon_market_statistics.py6.6 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Nexscope Market Statistics

This skill helps fetch node-level market statistics for Amazon categories via Nexscope.

Core Concepts

  • Node statistics: Aggregated statistics for a specified category node, not returning complete product details.
  • TopN scope: topN determines the sample size of top products for statistics (default 10).
  • New product definition: newProduct specifies the number of recent months used to define "new product" (default 6).

How to Invoke

  • API Endpoint: POST /sellersprite/market/statistics (complete params/response/error codes in references/api.md)
  • Python Script: python scripts/amazon_market_statistics.py '<JSON params>' [--inline]
  • Cost constraint: This tool consumes credits; the same session and parameter combination is called only once by default, with a 24h local cache in the script. On failure or empty results, do not automatically retry with different keywords, pagination, or postal codes; inform the user about additional consumption before continuing to search.

Output strategy (script default behavior):

  • Always write the full response to <cwd>/nexscope/<YYYY-MM-DD>/<session>/data/nexscope-sellersprite-market-statistics-<timestamp>.json (<cwd> is the working directory at script execution time, i.e. the current project directory in Claude Code; <session> is taken from the SESSION_ID env var, auto-grouped by user task; do not write to /tmp, error if current directory is not writable)
  • Response body <= 8 KB: print full JSON to stdout after saving
  • Response body > 8 KB: print only summary to stdout after saving (top-level fields, common counts like total/costToken, length of largest list field + first 3 samples)
  • Add --inline to force full output to stdout (still saves to disk)

Data reading tip: Check the summary first to decide if it's enough; when specific fields are needed, prefer using jq or ConvertFrom-Json to extract from the saved json file on demand, avoiding loading the entire JSON into context.

Parameters

ParameterTypeRequiredDescription
marketplacestringYesMarketplace code, default US
nodeIdPathstringYesNode ID path, e.g. 1064954:1069242:...
monthstringNonearly or yyyyMM
topNintegerNoTop sample size, default 10
newProductintegerNoNew product definition (months), default 6

Usage Example

{
  "marketplace": "US",
  "nodeIdPath": "172282:281407",
  "month": "nearly",
  "topN": 10,
  "newProduct": 6
}

Display Rules

  1. Clearly display the statistical scope: topN, newProduct, time range.
  2. Output key overview metrics first, then extended fields.
  3. If the user does not provide nodeIdPath, guide them to provide a node path or do category location first.

Important Limitations

  • Required parameters: marketplace, nodeIdPath
  • nodeIdPath must be a valid node path
  • Month queries are limited by the third-party historical range

Authentication

Set the NEXSCOPE_API_KEY environment variable. If credentials are missing or expire, visit https://www.nexscope.ai/help/skills-external-access?co-from=skillNS to top up credits.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Analyze Amazon traffic gaps between an owned product and competitors using Nexscope keyword, traffic, listing and review evidence. Use for missing keyword coverage, organic-versus-paid traffic structure, variant-aware rank comparisons and evidence-based listing priorities. Produces a local HTML report; does not execute advertising changes.

The English summary is being prepared. Showing the original description.

nexscope-ai/nexscope-ecommerce-skills98Updated Oct 15, 2026

Find similar design-registration candidates from a product image using Nexscope. Use for image-based design patent candidate screening with region, jurisdiction, Locarno and legal-status filters. Returns evidence for review, never an infringement or freedom-to-operate verdict.

The English summary is being prepared. Showing the original description.

nexscope-ai/nexscope-ecommerce-skills98Updated Oct 15, 2026

Query 1688 product bestseller billboard data for sourcing discovery and wholesale product research. Trigger when the user mentions 1688 product rankings, 1688 bestseller lists, wholesale hot products, domestic sourcing rankings, dropshipping product selection, 1688 trending products, bulk purchase popular items, supplier product rankings, 1688 billboard, 1688 bestsellers, sourcing rankings, wholesale hot products, trending product rankings, supplier rankings, 1688 trends. Even if the user does not explicitly mention "1688 billboard", if their need involves discovering hot-selling wholesale products or sourcing opportunities on the 1688 platform, this skill should also be triggered.

The English summary is being prepared. Showing the original description.

nexscope-ai/nexscope-ecommerce-skills98Updated Oct 15, 2026

Query 1688 public product details through the Nexscope research proxy. Use when the user requests this public marketplace or patent data; do not use for seller-console or store-authorized operations.

The English summary is being prepared. Showing the original description.

nexscope-ai/nexscope-ecommerce-skills98Updated Oct 15, 2026

Search and analyze products on the Chinese 1688 wholesale platform (Alibaba domestic B2B market) for sourcing, supplier discovery, and product selection. Trigger when the user mentions 1688 product search, finding suppliers on 1688, wholesale product queries, factory sourcing, dropshipping supplier search, 1688 keyword product selection, wholesale price comparison, filtering by sales volume, any product research on the 1688 platform, 1688 search, 1688 product selection, find suppliers, factory lookup, wholesale pricing, supplier search, domestic sourcing, 1688 products. Even if the user does not explicitly say "1688", if their need involves searching for wholesale products, finding domestic suppliers, or sourcing from the domestic Chinese market, this skill should also be triggered.

The English summary is being prepared. Showing the original description.

nexscope-ai/nexscope-ecommerce-skills98Updated Oct 15, 2026

Perform image-based product search on the 1688 platform. Use an image URL to find visually similar supplier products, returning title, price, minimum order quantity, monthly sales, repurchase rate, trade score, and seller identity. Triggered when users mention 1688 image search, 1688 visual search, find supplier by image, reverse image search 1688, 1688 product sourcing by image, or Alibaba 1688 image search. Even if the user does not explicitly mention "image search," this skill should be triggered whenever a user provides an image URL and wants to find matching or similar products on the 1688 wholesale platform.

The English summary is being prepared. Showing the original description.

nexscope-ai/nexscope-ecommerce-skills98Updated Oct 15, 2026

See all skills by nexscope-ai

Report a problem with this skill