ZooData — Amazon Seller Data Analysis
Respond in the user's language. Use this skill for broad or composite Amazon research without a single specialized deliverable. Route a focused market-entry, market-discovery, or category-trend request to amazon-market-analysis; route a focused keyword, listing, pricing, review, or competitor request to its dedicated skill.
Start here
- Classify the user's question. For a single data point, use the quick path in
references/execution-guide.md; for multi-endpoint research, load its full workflow. - Read
references/cli-contract.mdbefore selecting or invoking a command. Inspect the bundled CLI's top-level and selected subcommand help. - Read
references/reference.mdfor endpoint fields and local CLI options. Load the applicable scenario module:scenarios-composite.mdfor broad cross-validation,scenarios-eval.mdfor product evaluation,scenarios-expand.mdfor expansion,scenarios-listing.mdfor listing context,scenarios-ops.mdfor operations, orscenarios-pricing.mdfor pricing context. - Apply the shared interpretation and reporting rules in
references/execution-guide.md; use the selected scenario for its specific evidence and conclusion scope.
Source-of-truth boundaries
- This
SKILL.mdowns trigger routing, module loading, the responsibility map, and non-negotiable runtime boundaries. It does not define product presets, thresholds, endpoint fields, procedures, or report templates. references/cli-contract.mdowns shared CLI invocation, command identity, result classification, retries, and terminal or partial-result handling.references/reference.mdowns endpoint availability, request and response fields, CLI parameter mapping, data shapes, and field identity. It does not set analytical thresholds.references/execution-guide.mdowns shared workflow steps, product-preset selection, market-health interpretation, cross-endpoint analysis, and user-facing output rules. It does not redefine endpoint fields.- Scenario modules own the evidence selection, conclusions, and scenario-specific report sections for their named task. They may narrow shared workflow rules but cannot redefine endpoint contracts or shared output rules.
{skill_base_dir}/scripts/zoodata.pyowns local preset expansion, request construction, transport metadata, and credential handling; it does not issue business conclusions.
Shared CLI Contract
Before selecting or invoking the first command, read and apply the local references/cli-contract.md. Reapply it after every granular or composite result and before any fallback, additional call, state write, interpretation, or report. The local references/execution-guide.md owns user-facing failure rendering.
Local Interface Failure Output
Use the failure rendering in references/execution-guide.md; direct a user with exhausted credits to https://zoodata.ai/en/pricing.
Non-negotiable boundaries
- Require
ZOODATA_API_KEY; use the bundled CLI and the local command manifest. The credential-onlycheckpath precedes evidence calls. Stop and follow the shared CLI contract on credential, credit, validation, or terminal interface failures; do not invent missing evidence. - Resolve and preserve a category path or ID before category-scoped comparisons. Distinguish inferred category paths from direct matches. Preserve marketplace, date, category scope, sample type, and the difference between full-category and selected Top 100 SPU metrics.
- Treat seller budget, experience, risk tolerance, and other profile text as local interpretation inputs. Send only the documented category/product identifiers and numeric filters to the API.
- State estimated credit cost before a broad multi-call scan. Require the user's explicit monitoring request before creating recurring work or saved baselines.
Capabilities and data flow
- Network: the bundled CLI sends authenticated requests to
https://api.zoodata.aiand refuses an untrustedZOODATA_BASE_URL. - Execution: Python 3 standard-library shared CLI at
{skill_base_dir}/scripts/zoodata.py. - Local files: reads optional
~/.zoodata/config.json; review fallback may use a private temporary directory. - Sent to the API: keywords, category paths/IDs, ASINs, marketplace, dates, and numeric filters. Seller profile text remains local.
- Credits: evidence calls consume account credits; the credential-only
checkpath does not.
Execution entry
bashpython {skill_base_dir}/scripts/zoodata.py <documented-subcommand> ...
This skill allows categories, market, market-profile, market-price-distributions, market-rating-distributions, market-rating-count-distributions, market-listing-age-distributions, market-fulfillment-distributions, market-seller-country-distributions, market-content-distributions, market-top-product-concentrations, market-brand-concentrations, market-seller-concentrations, market-listing-launch-trend, market-history, products, competitors, product, analyze, report, opportunity, history, brand-overview, brand-detail, price-band-overview, price-band-detail, check, reviews-raw, review-tag-prompt, review-reduce-prompt, and review-aggregate.


