← Back to Skills Marketplace
justoneapi

Amazon API

by justoneapi · GitHub ↗ · v1.0.10 · MIT-0
cross-platform ✓ Security Clean
208
Downloads
0
Stars
1
Active Installs
11
Versions
Install in OpenClaw
/install justoneapi-amazon
Description
Analyze Amazon workflows with JustOneAPI, including product Details, product Top Reviews, and best Sellers across 4 operations.
README (SKILL.md)

Amazon

This skill wraps 4 Amazon operations exposed by JustOneAPI. It is strongest for product Details, product Top Reviews, best Sellers, and products By Category. Expect common inputs such as country, asin, page, category, categoryId.

When To Use It

  • The user needs product Details or product Top Reviews on Amazon.
  • The task lines up with best Sellers rather than a generic cross-platform workflow.
  • The user can provide identifiers or filters such as country, asin, page, category.
  • The user wants an exact API-backed answer instead of a freeform summary.

Representative Operations

  • getAmazonProductDetailV1: Product Details — Get Amazon product Details data, including title, brand, and price, for building product catalogs and enriching item content (e.g., images), price monitoring and availability tracking, and e-commerce analytics and competitor tracking
  • getProductTopReviewsV1: Product Top Reviews — Get Amazon product Top Reviews data, including most helpful) public reviews, for sentiment analysis and consumer feedback tracking, product research and quality assessment, and monitoring competitor customer experience
  • getBestSellersV1: Best Sellers — Get Amazon best Sellers data, including rank positions, product metadata, and pricing, for identifying trending products in specific categories, market share analysis and category research, and tracking sales rank and popularity over time
  • getProductsByCategoryV1: Products By Category — Get Amazon products By Category data, including title, price, and rating, for category-based product discovery and returns product information such as title, price, and rating

Request Pattern

  • 4 operations are available in this skill.
  • HTTP methods used here: GET.
  • The most common non-token parameters are country, asin, page, category, categoryId.
  • All operations in this skill are parameter-driven requests; none require a request body.

How To Work

  1. Read generated/operations.md before choosing an endpoint.
  2. Start with one of these operations when it matches the user's request: getAmazonProductDetailV1, getProductTopReviewsV1, getBestSellersV1, getProductsByCategoryV1.
  3. Pick the smallest matching operation instead of guessing.
  4. Ask the user for any missing required parameter. Do not invent values.
  5. Call the helper with:
node {baseDir}/bin/run.mjs --operation "\x3Coperation-id>" --token "$JUST_ONE_API_TOKEN" --params-json '{"key":"value"}'

Environment

  • Required: JUST_ONE_API_TOKEN
  • This skill uses JUST_ONE_API_TOKEN only for authenticated Just One API requests.
  • Keep JUST_ONE_API_TOKEN private. Do not paste it into chat messages, screenshots, or logs.
  • Get a token from Just One API Dashboard.
  • Authentication details: Just One API Usage Guide.

Output Rules

  • Start with a plain-language answer tied to the Amazon task the user asked for.
  • Include the most decision-relevant fields from the selected endpoint before dumping raw JSON.
  • When using getAmazonProductDetailV1, explain why the returned fields answer the user's question.
  • If the user gave filters such as country, asin, page, echo those back so the scope is explicit.
  • If the backend errors, include the backend payload and the exact operation ID.
Usage Guidance
This skill appears to do what it says: it will run the included Node script and make authenticated GET requests to https://api.justoneapi.com using the JUST_ONE_API_TOKEN you provide. Before installing: (1) only supply a JustOneAPI token you trust — create a dedicated token you can revoke if needed; (2) review bin/run.mjs locally if you want to confirm behavior (it will perform network calls); (3) do not paste the token into chat or logs; (4) be aware the script will egress to the third‑party service (network billing/data exposure); and (5) if you require stricter controls, run the skill in an environment with limited network access or use a short‑lived/dedicated API key.
Capability Analysis
Type: OpenClaw Skill Name: justoneapi-amazon Version: 1.0.10 The skill is a standard API wrapper for JustOneAPI's Amazon data services, facilitating access to product details, reviews, and best sellers. The execution logic in bin/run.mjs is straightforward, using the native fetch API to communicate with the official endpoint (api.justoneapi.com) without any signs of obfuscation, unauthorized data exfiltration, or malicious command execution.
Capability Assessment
Purpose & Capability
Name/description match the requested items: the skill calls JustOneAPI Amazon endpoints. Required binary (node) and required env var (JUST_ONE_API_TOKEN) are exactly what you'd expect for a small Node-based API wrapper.
Instruction Scope
SKILL.md directs the agent to pick one of four GET endpoints, ask for missing parameters, and invoke bin/run.mjs with the token and params. It does not instruct reading unrelated files, accessing other credentials, or sending data to unexpected endpoints; operations target api.justoneapi.com per manifest.
Install Mechanism
No install spec or external downloads are present — the skill is instruction+script only. The single code file (bin/run.mjs) will be executed by node; there are no remote installers or archive extracts to inspect.
Credentials
Only JUST_ONE_API_TOKEN is required and declared as the primary credential. That single token is proportional to the described functionality (authenticated requests to JustOneAPI).
Persistence & Privilege
always is false and the skill does not request persistent or elevated platform privileges. The skill can be invoked autonomously (platform default), which is expected for API wrapper skills.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install justoneapi-amazon
  3. After installation, invoke the skill by name or use /justoneapi-amazon
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.10
- Updated the Product Details operation ID from getProductDetailV1 to getAmazonProductDetailV1 throughout the documentation and workflow. - All usage, reference, and output rules now point to getAmazonProductDetailV1 for Amazon product detail tasks. - No changes to parameters, endpoints, or function beyond the operation ID rename.
v1.0.9
- Updated the Just One API usage guide link for improved referral tracking in the Environment section. - No changes to core functionality or operations; this is a documentation update only.
v1.0.8
- Updated the Just One API Dashboard link in the Environment section to include additional referral and campaign parameters. - No other changes to skill functionality or usage.
v1.0.7
- Clarified that JUST_ONE_API_TOKEN is used only for authenticated Just One API requests. - No changes to operations or endpoints. - Minor text edit in the Environment section for greater transparency.
v1.0.6
- Added guidance to keep `JUST_ONE_API_TOKEN` private; do not paste it into chat messages, screenshots, or logs. - No other functional or usage changes; documentation update only.
v1.0.5
- Added links for acquiring the required API token and detailed authentication instructions in the Environment section. - No changes to operations or parameters; documentation update only.
v1.0.4
rename
v1.0.3
- Updated skill name in documentation from "justoneapi_amazon" to "Amazon API". - No changes to features, endpoints, or underlying operations—documentation only.
v1.0.2
- Expanded skill summary to highlight 4 specific Amazon operations: product Details, product Top Reviews, best Sellers, and products By Category. - Clarified and structured “When To Use It” and “How To Work” sections with guidance on operation selection and parameter requirements. - Added concise descriptions and use-cases for each supported operation. - Listed typical input parameters and clarified that all requests are parameter-driven (no request body). - Improved output instructions, including explicit field explanations, handling of filters, and detailed error reporting with operation IDs.
v1.0.1
- Added explicit --token argument usage in the command example for API calls. - Documentation updated to clarify that the API token must be passed via --token when running the helper script.
v1.0.0
Initial release of justoneapi_amazon skill: - Enables access to JustOneAPI Amazon endpoints through HTTP APIs. - Provides guidance on when and how to use the skill. - Includes clear output rules for presenting results and handling errors. - Requires the environment variable JUST_ONE_API_TOKEN for authentication.
Metadata
Slug justoneapi-amazon
Version 1.0.10
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 11
Frequently Asked Questions

What is Amazon API?

Analyze Amazon workflows with JustOneAPI, including product Details, product Top Reviews, and best Sellers across 4 operations. It is an AI Agent Skill for Claude Code / OpenClaw, with 208 downloads so far.

How do I install Amazon API?

Run "/install justoneapi-amazon" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Amazon API free?

Yes, Amazon API is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Amazon API support?

Amazon API is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Amazon API?

It is built and maintained by justoneapi (@justoneapi); the current version is v1.0.10.

💬 Comments