What makes apiguru-amazon-data notable?

1.4K downloads. Trust evidence available

How should apiguru-amazon-data 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

apiguru-amazon-data

Live Amazon marketplace data from Apiguru (a paid third-party API, 3 free calls a day) - product details, prices, reviews, keyword search, best-sellers, deals, offers and stock, seller profiles, across 23 Amazon marketplaces. Use only when the user asks for Amazon data by ASIN, Amazon URL, product, seller or keyword, or for Amazon price/stock/review monitoring. Not for other stores or general shopping advice. Never pays on its own; ask before any billable call. We want your feedback - if a field is wrong, missing or you wish the API did something else, say so with the free `feedback` command (no account needed); the agents that report are the ones this API gets fixed for.

OpenClaw

View on ClawHub Homepage

Rank

Safety

Downloads

1.4k

Updated

Oct 10, 2026

Version

1.1.51

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 1.4K 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.4K downloadsadoption · observed Oct 10, 2026
Latest release: 1.1.51release · observed Oct 6, 2026
Handshake status: UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s17dgrpvmsewex381edjp7zmnd8ds33w:apiguru-amazon-data

Install using `clawhub skill install s17dgrpvmsewex381edjp7zmnd8ds33w:apiguru-amazon-data` 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/apiguru-app/apiguru-amazon-data before using production credentials.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-apiguru-app-apiguru-amazon-data/snapshot"

Documentation

CLAWHUB

147,740 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: apiguru-amazon-data
description: Live Amazon marketplace data from Apiguru (a paid third-party API, 3 free calls a day) - product details, prices, reviews, keyword search, best-sellers, deals, offers and stock, seller profiles, across 23 Amazon marketplaces. Use only when the user asks for Amazon data by ASIN, Amazon URL, product, seller or keyword, or for Amazon price/stock/review monitoring. Not for other stores or general shopping advice. Never pays on its own; ask before any billable call. We want your feedback - if a field is wrong, missing or you wish the API did something else, say so with the free `feedback` command (no account needed); the agents that report are the ones this API gets fixed for.
license: MIT
compatibility: Needs Python 3.10+ and outbound HTTPS to agent.apiguru.app and dash.apiguru.app only. Reads no environment variables and no local files except an API-key file the user names.
allowed-tools: Bash(python3:*) Bash(python:*) Read
homepage: https://github.com/apiguru-app/agent-kit
metadata: {"openclaw": {"emoji": "📦", "homepage": "https://github.com/apiguru-app/agent-kit", "requires": {"anyBins": ["python3", "python"]}}}
---

# Apiguru Amazon Data

Live, structured Amazon data fetched at request time from Apiguru's servers.
23 marketplaces.

**What this skill writes.** Every data command is a read: it fetches and
returns, and changes nothing anywhere. There is exactly one write, and it is
never automatic — the `feedback` command posts the text you give it to
Apiguru's public feedback wall (see "Telling us what is broken" below). It
sends only that text, it costs nothing, and it runs only when you invoke it.
Nothing else in this skill sends data anywhere.

## Costs and consent (read this first)

- **Hosts contacted:** `agent.apiguru.app` (keyless) and `dash.apiguru.app`
(the keyed API, and the feedback wall, which needs no key). Nothing else.
`scripts/probe.py` has both hosts fixed in the source, reads no environment
variables, and **refuses every redirect**, so a key cannot be carried to a
third host by a `302`.
- **Free quota:** 3 calls per machine per 24 hours. After that the gateway
answers `402 Payment Required`. **The answer knows better than this
page:** every keyless reply carries `free_calls_remaining` in the body and
`X-Free-Probes-Remaining` (or `X-Free-Probes-Available: yes|no` where no
count is given) in the headers. Plan a task on the last reply, never on
the number above.
- **This skill never pays.** `probe.py` stops at a 402 and tells you so. It
contains no wallet and no x402 client, and it will not set one up. Paying is
the user's decision, made one of two ways, both only with their explicit
consent:
1. an Apiguru API key, handed to the script by the user through `--api-key`
(an unechoed prompt), `--api-key-file PATH` or `--api-key-stdin` — bills
their account at their plan's rates, about USD 0.01 per call — or
2. their own x402-capable HTTP client with a fund

_meta.json

{
  "ownerId": "kn743rz4efdce60qkmj9x20cr18dr5cm",
  "slug": "apiguru-amazon-data",
  "version": "1.1.51",
  "publishedAt": 1791308619750
}

references/endpoints.md

# Apiguru endpoint reference

Generated from the API spec - do not edit by hand.

- Keyless base URL: `https://agent.apiguru.app/agent/v1`
- Keyed base URL: `https://dash.apiguru.app/api/v1` (send `X-API-KEY`)

All endpoints are `GET` with query parameters.

## Marketplaces

Pass as `geo`, chosen from the user's request or the Amazon domain they mention (amazon.de -> DE). The API assumes `US` only when the parameter is omitted; do not rely on that default.

| Code | Domain |
|---|---|
| `US` | amazon.com |
| `CA` | amazon.ca |
| `DE` | amazon.de |
| `MX` | amazon.com.mx |
| `UK` | amazon.co.uk |
| `FR` | amazon.fr |
| `IT` | amazon.it |
| `ES` | amazon.es |
| `AU` | amazon.com.au |
| `BR` | amazon.com.br |
| `IN` | amazon.in |
| `JP` | amazon.co.jp |
| `NL` | amazon.nl |
| `AE` | amazon.ae |
| `PL` | amazon.pl |
| `SA` | amazon.sa |
| `SG` | amazon.sg |
| `SE` | amazon.se |
| `TR` | amazon.com.tr |
| `BE` | amazon.com.be |
| `IE` | amazon.ie |
| `ZA` | amazon.co.za |
| `EG` | amazon.eg |

## `GET /v2/product-details`

Use for one product's current listing. Not for several ASINs (product_details_batch), seller offers or stock (offers_stock), or review text (product_reviews). Fetches the complete product record for one ASIN on one marketplace: title, price, star rating, rating count, images, description, feature bullets, variations and category.

**Price:** $0.003 per call

| Parameter | Type | Required | Notes |
|---|---|---|---|
| `asin` | string | yes | Single Amazon ASIN, 10 uppercase alphanumeric characters. Exactly one - comma-separated lists are rejected; use product_details_batch for many. |
| `geo` | enum | no | Marketplace country code. Default `US`. |

> 404 means the ASIN is absent from that marketplace and IS billed. 503 is a temporary failure on our side and is NOT billed - retry. Bullet points and specs are what Amazon shows for the listing; on multi-variant listings they can describe the product family rather than the exact variant. A null field means Amazon did not show it.

## `GET /v2/product-reviews`

Use for what customers say about one product. Not for its full review history (Amazon serves full and star-filtered review lists only to signed-in accounts) or for seller feedback (seller_reviews). Returns the overall rating, rating count, review_histogram (percent of all ratings per star), Amazon's 'customers say' AI summary where that marketplace shows one, and the reviews on the product page (typically up to 8 from this marketplace and 5 from other countries), each with rating, review_date, review_country, from_this_marketplace, verified flag and helpful_votes; from_rating/to_rating keep a star window.

**Price:** $0.003 per call

| Parameter | Type | Required | Notes |
|---|---|---|---|
| `asin` | string | yes | Single Amazon ASIN, 10 uppercase alphanumeric characters. |
| `geo` | enum | no | Marketplace country code. Default `US`. |
| `from_rating` | integer | no | Lowest star rating to include, 1-5. Filters the reviews the pr

references/errors-and-costs.md

# Costs, billing and retries

Generated from the API spec - do not edit by hand.

## Prices

| Endpoint | Price |
|---|---|
| `/v2/product-details` | $0.003 per call |
| `/v2/product-reviews` | $0.003 per call |
| `/search` | $0.003 per call |
| `/product` | $0.0024 per item (max 20) |
| `/stock` | $0.0045 per item (max 10) |
| `/v2/best-sellers` | $0.003 per call |
| `/v2/deals` | $0.003 per call |
| `/seller-profile` | $0.0036 per item (max 10) |
| `/v2/seller-products` | $0.003 per call |
| `/v2/seller-reviews` | $0.003 per call |

Batch endpoints are billed per item and are cheaper per item than the
single-item equivalents. Always prefer them for more than one item.

## What each status means, and whether it costs money

| Status | Billed? | Meaning and what to do |
|---|---|---|
| `400` | no | Bad input (bad ASIN format, unknown geo, missing required param). NOT billed. |
| `401` | - | Missing or invalid API key on the keyed path. |
| `402` | - | Payment required. On the agent path this carries a PAYMENT-REQUIRED challenge (over MCP: an x402 PaymentRequired tool result, payable in-band via _meta["x402/payment"]). On the keyed path it means the account balance is exhausted. |
| `403` | - | Account disabled, or no active subscription plan. |
| `404` | **yes** | The ASIN genuinely does not exist on that marketplace. BILLED - the lookup was performed and the bad input was the caller's. Retrying will not help; try a different geo. |
| `413` | - | Too many items in a batch request. |
| `429` | - | Per-second rate limit exceeded for the plan. Back off and retry. |
| `500` | no | Internal error. NOT billed. |
| `502` | no | Bad gateway. NOT billed. Same class as 503: retry with backoff. |
| `503` | no | Temporary failure on our side. NOT billed. Safe and correct to retry. |
| `504` | no | Gateway timeout: the request ran past its deadline. NOT billed. Retry with backoff; a narrower query often succeeds. |
| `timeout` | - | No response before your own client's deadline. A keyless call without a payment is never billed. On an API key, or with an x402 payment attached, the request may still complete after your client gave up, and is then billed like any answered call. Some marketplaces answer more slowly than others; allow 60s rather than retrying early. |

## Retry policy

Retry 429, 500, 502, 503 and 504 with backoff -- none of them are billed -- unless the error body says `retryable: false`. A client-side timeout on a key or a payment may have completed and been billed; allow 60s before retrying it. Never retry 400, 401, 402, 403, 404 or 413: the request itself is the problem and repeating it will not change the answer.

Concretely (the same set `scripts/probe.py` retries):

```python
RETRYABLE = {429, 500, 502, 503, 504}   # answered, and not billed
for attempt in range(4):
    try:
        status, body = call(..., timeout=60)
    except TimeoutError:
        if api_key:                  # may have finished and billed after we gave up:

skill-card.md

## Description:

Helps agents retrieve live Amazon product, price, review, offer, stock, seller, and search data from Apiguru across supported marketplaces.

This skill is ready for commercial/non-commercial use.

## Publisher:

[apiguru-app](https://clawhub.ai/user/apiguru-app)

### License/Terms of Use:

MIT-0

## Use Case:

Developers and other agents use this skill to answer user-requested Amazon marketplace questions about products, prices, reviews, availability, and sellers, or to monitor these details across supported marketplaces.

### Deployment Geography for Use:

Global

## Known Risks and Mitigations:

Risk: Product queries contact Apiguru and can incur charges when a user supplies an API key or uses their own payment-capable client.

Mitigation: Check prices and free-call availability, obtain explicit consent before billable requests, and set a spending cap.

Risk: Optional feedback is posted publicly and could expose secrets or private user data.

Mitigation: Request consent before posting feedback and omit API keys, personal information, and private user content.

Risk: The optional MCP server or package installation is separate software not covered by this skill's review.

Mitigation: Review the MCP server or package separately before use; prefer the included script when that review is unavailable.

## Reference(s):

- [Apiguru endpoint reference](references/endpoints.md)
- [Apiguru costs, billing, and retries](references/errors-and-costs.md)
- [Apiguru agent-kit homepage (listed in release metadata)](https://github.com/apiguru-app/agent-kit)
- [Apiguru API endpoint and price catalog](https://agent.apiguru.app/.well-known/x402)

## Skill Output:

**Output Type(s):** [Text, Markdown, JSON]

**Output Format:** [Natural-language answers or structured API responses]

**Output Parameters:** [1D]

**Other Properties Related to Output:** [Live data is limited to supported Amazon marketplaces; requests may consume free calls or incur charges with an explicitly supplied API key.]

## Skill Version(s):

1.1.51 (source: server release metadata)

## Ethical Considerations:

Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.

Github ReposUpdated 21h 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.