What makes zoodata notable?

1.7K downloads. Trust evidence available

How should zoodata be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this agent.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

agentCLAWHUBUnverified

zoodata

API endpoint reference for the ZooData data platform: the 12 commerce endpoints plus 10 keyword-intelligence endpoints (categories, markets, products, competitors, realtime ASIN, AI review analysis, raw reviews, price band, brand, history, and the keyword detail/trend/extends/search/ market-profile/product-traffic/competitor-keywords/traffic-timeline family) — their inputs/outputs, parameter quirks, Quick Start (auth, base URL), how credits are tracked (meta.creditsConsumed), and the Local Review Toolkit (Map/Reduce for raw reviews). Use when the user asks about the API itself: which endpoints exist, how to call them (e.g. /products/search), field schemas returned by an endpoint, parameter quirks, how to authenticate, how credit consumption is reported, how to get started, or how the Local Review Toolkit works. Requires ZOODATA_API_KEY.

OpenClaw

View on ClawHub Homepage

Rank

Safety

Downloads

1.7k

Updated

Oct 10, 2026

Version

1.1.9

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 1.7K downloads reported by the source. Last updated 10/10/2026.

Avoid when

Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor: Clawhubvendor · observed Oct 10, 2026
Protocol compatibility: OpenClawcompatibility · observed Oct 10, 2026
Adoption signal: 1.7K downloadsadoption · observed Oct 10, 2026
Latest release: 1.1.9release · observed Aug 7, 2026
Handshake status: UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s17081rahwfg1emrhs1pmfhmq984gan3:zoodata

Install using `clawhub skill install s17081rahwfg1emrhs1pmfhmq984gan3:zoodata` in an isolated environment before connecting it to live workloads.
No published capability contract is available yet, so validate auth and request/response behavior manually.
Review the upstream CLAWHUB listing at https://clawhub.ai/apiclaw/zoodata before using production credentials.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-apiclaw-zoodata/snapshot"

Documentation

CLAWHUB

145,016 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: zoodata
description: >
  API endpoint reference for the ZooData data platform: the 12 commerce
  endpoints plus 10 keyword-intelligence endpoints (categories, markets,
  products, competitors, realtime ASIN, AI review analysis, raw reviews,
  price band, brand, history, and the keyword detail/trend/extends/search/
  market-profile/product-traffic/competitor-keywords/traffic-timeline
  family) — their inputs/outputs, parameter quirks, Quick Start (auth,
  base URL), how credits are tracked (meta.creditsConsumed), and the Local
  Review Toolkit (Map/Reduce for raw reviews).
  Use when the user asks about the API itself: which endpoints exist, how
  to call them (e.g. /products/search), field schemas returned by an
  endpoint, parameter quirks, how to authenticate, how credit consumption
  is reported, how to get started, or how the Local Review Toolkit works.
  Requires ZOODATA_API_KEY.
metadata:
  version: "1.1.9"
  author: SerendipityOneInc
  homepage: https://github.com/SerendipityOneInc/ZooData-Skills
  openclaw: {"requires": {"env": ["ZOODATA_API_KEY"]}, "primaryEnv": "ZOODATA_API_KEY"}
---

> **📋 Live API Reference**: Field names and parameters may change. If you encounter field errors,
> check the latest OpenAPI spec at https://zoodata.ai/api/v1/openapi-spec for current field definitions.
> Keyword exception: the observation endpoints currently support `granularity=week` only. Do not
> reintroduce `day`, `month`, `lately_day`, or `lookbackDays` from a stale generated schema.

# ZooData — Commerce Data Infrastructure for AI Agents

200M+ Amazon products. 22 endpoints. One API key.

## Quick Start
1. Get key: [zoodata.ai/api-keys](https://zoodata.ai/en/api-keys) (1,000 free credits)
2. `export ZOODATA_API_KEY='hms_live_xxx'`
3. Base URL: `https://api.zoodata.ai/openapi/v2` — all POST with JSON body
4. Auth: `Authorization: Bearer YOUR_API_KEY`
5. New keys need 3-5s to activate. If 403, wait and retry.

## Capabilities & Data Flow

- **Network**: only `https://api.zoodata.ai` (Bearer `ZOODATA_API_KEY`). Setting `ZOODATA_BASE_URL` to an untrusted host (anything other than `api.zoodata.ai` / `*.zoodata.ai` / localhost) makes the CLI **refuse the request and withhold the key** — the Bearer token is never sent to an untrusted host.
- **Execution**: bundled shared ZooData CLI `{skill_base_dir}/scripts/zoodata.py` (Python 3, stdlib-only). This data-layer reference skill allows the complete literal subcommand surface exposed by the bundled client's current top-level help.
- **Local files**: none by default; reads the optional credential store `~/.zoodata/config.json`; the Local Review Toolkit uses a private temporary working dir (created with `mktemp -d`, removed when the fallback completes) during the review fallback.
- **Sent to the API**: keywords, category paths, ASINs, marketplace/date and numeric filter values only. **Never sent**: budget, experience level, risk tolerance, or any other user-profile text — profile inputs map client-sid

README.md

# ZooData — Commerce Data Infrastructure for AI Agents

> 200M+ Amazon products. 22 endpoints. One API key.

## What This Skill Does

The foundational data layer for all ZooData agent skills. Provides direct access to 22 API endpoints covering category browsing, market metrics, product search (20+ filter fields), competitor lookup, real-time ASIN detail, AI review analysis, price band analysis, brand intelligence, product history, and keyword intelligence. Use this skill when you need raw API access or want to understand what data is available.

### What Makes This Different

- **22 endpoints in one skill**: Complete API reference with field mappings and known quirks
- **Critical pitfalls documented**: Category-first workflow, field naming differences across endpoints, aggregation gotchas
- **Cross-endpoint field guide**: Know exactly which field to use from which endpoint
- **Foundation for all skills**: Every ZooData skill builds on this data layer

## Install

```bash
npx skills add SerendipityOneInc/ZooData-Skills
```

Select **ZooData** when prompted.

## API Key Setup

1. Get a free key at [zoodata.ai/api-keys](https://zoodata.ai/en/api-keys) — 1,000 free credits, no credit card
2. Set the environment variable:
   ```bash
   export ZOODATA_API_KEY='hms_live_xxxxxx'
   ```

## Example Prompts

- *"What ZooData endpoints are available?"*
- *"What ZooData endpoints are available and how do I use them?"*
- *"Look up real-time data for ASIN B0XXXXXXXX"*
- *"Search for products in the 'yoga mat' category sorted by sales"*
- *"Pull the market data for this product category"*

## What You Get

| Section | Description |
|---------|-------------|
| 📚 22 Endpoint Reference | Purpose, key parameters, output fields |
| ⚠️ API Pitfalls | Critical rules all skills must follow |
| 📊 Field Difference Table | Which field comes from which endpoint |
| 🏷️ Confidence Labels | Data-backed / Inferred / Directional tagging system |
| 📝 Known Quirks | String types, array handling, rate limits |

## API Endpoints

| # | Endpoint | Purpose |
|---|----------|---------|
| 1 | `categories` | Browse/search category tree |
| 2 | `markets/search` | Market-level metrics (sales, price, concentration) |
| 3 | `products/search` | Product search with 20+ filter fields (13 CLI presets) |
| 4 | `products/competitors` | Competitor discovery |
| 5 | `realtime/product` | Live ASIN detail (rating, BSR, Buy Box, variants) |
| 6 | `reviews/analysis` | AI review insights (sentiment, pain points, keywords) |
| 7 | `realtime/reviews` | Live raw review text |
| 8 | `products/price-band-overview` | Price band summary (hottest, best opportunity) |
| 9 | `products/price-band-detail` | Full 5-band distribution |
| 10 | `products/brand-overview` | Brand concentration (CR10) |
| 11 | `products/brand-detail` | Per-brand breakdown |
| 12 | `products/history` | Daily price/BSR/sales snapshots |
| 13 | `keywords/detail` | Keyword weekly snapshot |
| 14 | `keywords/market-profile` | Multidimensio

_meta.json

{
  "ownerId": "kn78k155f6rbh2j8r8yjx8r2e18304q9",
  "slug": "zoodata",
  "version": "1.1.9",
  "publishedAt": 1786068900697
}

references/cli-contract.md

# ZooData CLI Contract

## Ownership and application

This file owns the project-wide caller contract before and after every bundled `{skill_base_dir}/scripts/zoodata.py` invocation. Read it before selecting the first command, then apply it after each granular or composite result and before any additional API/tool call, fallback, state write, interpretation, or user-facing report.

It owns the shared invocation form, command-identity validation, execution-environment permission handling, caller/CLI responsibilities, composite-result reuse, result acquisition, transport-status precedence, terminal-interface classification, retry ownership, and partial-result handling. It does not own skill-specific command allowlists, endpoint request/response fields, business interpretation, scenario selection, conclusion authority, or any user-facing failure/report rendering.

## Invocation interface

1. Invoke the bundled client as `python {skill_base_dir}/scripts/zoodata.py [global options] <subcommand> [subcommand options]` using the active skill's local copy.
2. Place global options before the subcommand. Treat top-level and subcommand `--help` as the live invocation contract; help inspection makes no API request and consumes no credits.
3. Use the active skill to select the allowed workflow and command scope. Use this contract to validate and execute that selection; do not let this shared file select a business workflow.
4. Distinguish API/evidence commands from local-only diagnostic, prompt-rendering, and aggregation commands according to the selected subcommand's help. Do not attribute an API call or credit use to a local-only command.
5. Credential resolution is owned by the bundled CLI. Invoke it directly; do not inspect local credential stores or pre-resolve, compare, export, or override credential values in the caller.

## Command identity and composite reuse

1. Inspect the bundled CLI's top-level `--help` and the selected subcommand's `--help` before invocation. Execute only an exact literal subcommand exposed by the current client and allowed by the active skill.
2. Treat API endpoint identifiers and composite result keys as data identities, not CLI command names. Never derive a subcommand from either identity or invent an alias.
3. Treat a successful composite command's structured output as the evidence bundle for that run. Perform selection, narrowing, transformation, extraction, and formatting locally.
4. Do not make an additional API call solely to reread, reshape, or narrow evidence already present in the composite bundle.
5. A granular call after a composite is allowed only for evidence absent from the bundle when the active skill's workflow or an explicit non-terminal fallback requires it.
6. A keyword-driven composite resolves the working category through a fallback chain and records the outcome in `meta`: `meta.category_source` states how it resolved

references/openapi-reference.md

# ZooData API Quick Reference

> Concise field reference for the currently documented Amazon commerce and keyword-intelligence endpoints. Load when you need exact parameter/field names.
>
> **OpenAPI Spec (live)**: https://zoodata.ai/api/v1/openapi-spec

Base URL: `https://api.zoodata.ai/openapi/v2`
Auth: `Bearer $ZOODATA_API_KEY`
Method: All POST with JSON body

---

## 1. categories

| Parameter | Type | Note |
|-----------|------|------|
| categoryKeyword | String | Search by keyword |
| categoryPath | List\<String\> | Exact path lookup, e.g. `["Electronics", "Computers"]` |
| parentCategoryPath | List\<String\> | Browse children |
| _(no params)_ | — | Returns root categories |

Response: `categoryId`, `categoryName`, `categoryPath`, `hasChildren`, `isRoot`, `level`, `productCount`, `link`

---

## 2. markets/search

| Parameter | Type | Note |
|-----------|------|------|
| categoryPath | List\<String\> | e.g. `["Pet Supplies", "Dogs"]` |
| categoryKeyword | String | Keyword match across levels |
| topN | **String** | `"3"` / `"5"` / `"10"` / `"20"` ⚠️ must be string |
| newProductPeriod | **String** | `"1"` / `"3"` / `"6"` / `"12"` ⚠️ must be string |
| sampleType | String | `bySale100` / `byBsr100` / `avg` |
| dateRange | String | default `30d` |
| pageSize | Integer | default 20 |
| sortBy | String | default `sampleAvgMonthlySales` |
| sortOrder | String | `asc` / `desc` |

Key response fields: `sampleAvgMonthlySales`, `sampleAvgPrice`, `sampleAvgMonthlyRevenue`, `sampleBrandCount`, `sampleSellerCount`, `sampleFbaRate`, `sampleNewSkuRate`, `topSalesRate`, `topBrandSalesRate`, `topSellerSalesRate`, `totalSkuCount`

---

## 3. products/competitors

| Parameter | Type | Note |
|-----------|------|------|
| keyword | String | Search keyword |
| brand | String | Brand filter |
| seller | String | Seller filter |
| asin | String | ASIN filter |
| categoryPath | List\<String\> | Category filter |
| sortBy | String | `monthlySalesFloor` / `monthlyRevenueFloor` / `bsr` / `price` / `rating` / `ratingCount` / `listingDate` |
| sortOrder | String | `asc` / `desc` |
| pageSize | Integer | default 20 |

---

## 4. products/search

Same as competitors, plus:

| Parameter | Type | Note |
|-----------|------|------|
| keywordMatchType | String | `fuzzy` / `phrase` / `exact` |
| listingAge | **Enum String** | One of `30d` / `90d` / `180d` / `1y` / `2y` (⚠️ bare numbers like `180` → 422) |

Filter pairs (all optional, Min/Max): `monthlySales`, `revenue`, `salesGrowthRate`, `bsr`, `subBsr`, `bsrGrowthRate`, `price`, `rating`, `ratingCount`, `fbaShipping`, `variantCount`, `grossMargin`, `sellerCount`

> `mode` is **NOT** an API parameter. The 13 CLI presets in `zoodata.py` expand client-side into the filter pairs above before the request is sent; passing `mode` in a raw request returns 422.

Additional: `includeBrands`, `excludeBrands`, `fulfillment` (`["FBA"]`/`["FBM"]`/`["AMZ"]`), `badges` — enum values `["bestSeller"]` / `["amazonChoice"]` / `["newRelease"]

Github ReposUpdated 10h agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW

Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW

Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.