Amazon ASIN Query for Openclaw

An AI agent skill to query real-time Amazon product details, pricing, reviews, and categories using an ASIN or direct product link.

anyunzhong
v1.0.1
May 27, 2026
0
1.1k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install clawec-amazon-asin-query

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install clawec-amazon-asin-query using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Amazon ASIN Query?

The Amazon ASIN Query skill connects your AI agent directly to ClawEC, an AI-driven collaborative platform tailored for cross-border e-commerce. By automating product lookup, this capability allows AI agents to bypass manual web scraping hurdles and collect highly accurate Amazon product details on demand.

Designed to integrate natively within Openclaw Skills, this tool acts as an automated research assistant. It can parse direct Amazon product URLs or standard ASIN identifiers across multiple regional storefronts, fetching critical fields such as pricing, sales volume, rankings, review counts, and product imagery. This facilitates accelerated product discovery, inventory analysis, and competitor tracking.

Amazon ASIN Query Use Cases

  • Competitor Benchmarking: Extract pricing, rating, and review metrics from rival Amazon listings to refine your e-commerce strategies.
  • Product Sourcing Research: Feed ASINs directly to your AI agent to auto-generate deep-dive research reports on trending items.
  • Automated Catalog Synchronization: Convert bare Amazon product URLs into clean, structured JSON data arrays containing taxonomy and imagery.
  • Multi-Region Monitoring: Track price points and listings across global Amazon storefronts without manual navigation.

How Amazon ASIN Query Works

  1. Analyze Query Mode: The agent detects whether the user provided a full product url or an asin combined with a country region code.
  2. Verify Credentials: The skill validates the presence of the CLAWEC_API_KEY environment variable prior to dispatching the request.
  3. Execute API Request: The skill makes a POST request containing JSON-encoded query targets to the endpoints of ClawEC.
  4. Handle Error Thresholds: If the response code is invalid or missing, it triggers fallback prompts instructing the developer to check API limits or keys.
  5. Format and Output Data: The parsed JSON response is translated into organized tables, structured lists, or custom payloads suited to the operator's downstream apps.

Amazon ASIN Query Setup

1. Retrieve API Credentials

Generate your authentication keys by registering on ClawEC:

2. Configure Your Environment

Save your API key as an environment variable so your Openclaw Skills runtime can reference it securely:

export CLAWEC_API_KEY="your_clawec_api_key_here"

3. Verification Commands

Verify that connection endpoints work correctly with curl:

Query by Product URL:

curl -s -X POST "https://www.clawec.com/api/aigc/tool/amazon_asin_query" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $CLAWEC_API_KEY" \
  -d '{"url":"https://www.amazon.com/dp/B0D1XD1ZV3"}'

Query by ASIN and Region:

curl -s -X POST "https://www.clawec.com/api/aigc/tool/amazon_asin_query" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $CLAWEC_API_KEY" \
  -d '{"asin":"B0D1XD1ZV3","region":"NA"}'

Or execute using the local bash wrapper script:

bash scripts/query.sh B0D1XD1ZV3 NA

Amazon ASIN Query Data Schema & Taxonomy

Request Parameters

Parameter Location Required Description
url Body Conditional* Complete Amazon product link. If supplied, asin and region are optional.
asin Body Conditional* Amazon Standard Identification Number. Required if url is not specified.
region Body Conditional* 2-letter uppercase region code representing target marketplace. Defaults to NA (North America) if omitted.

* Note: You must supply either the url OR a valid asin + region pair.

Region Identifiers

Code Marketplace Area
NA North America / US (Default)
CA Canada
BR Brazil
UK United Kingdom
DE Germany
FR France
JP Japan
SG Singapore
AU Australia

Expected Response Schema

{
  "status": 1,
  "data": {
    "title": "Sample Amazon Product",
    "price": "$19.99",
    "rating": "4.7",
    "reviews_count": 430,
    "brand": "Manufacturer Brand",
    "main_image": "https://images-na.ssl-images-amazon.com/images/I/sample.jpg",
    "url": "https://www.amazon.com/dp/B0D1XD1ZV3"
  }
}

Amazon ASIN Query Advanced Features

  • Intelligent Parameter Fallbacks: Gracefully determines input type and defaults to North America (NA) region whenever unspecified.
  • Seamless SOP Orchestration: Integrates with automated workflow triggers to periodically refresh competitor inventory counts and price adjustments.
  • Structured Output Generation: Standardizes complex API raw data into customizable markdown tables highlighting ratings, brand metrics, and listing statuses.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*