← 返回 Skills 市场

Amazon Best Sellers API

Name: Amazon Best Sellers API
Author: justoneapi

作者 justoneapi · GitHub ↗ · v1.0.2 · MIT-0

cross-platform ✓ 安全检测通过

103

总下载

当前安装

版本数

在 OpenClaw 中安装

/install justoneapi-amazon-get-best-sellers

功能描述

Call GET /api/amazon/get-best-sellers/v1 for Amazon Best Sellers through JustOneAPI with category.

使用说明 (SKILL.md)

Amazon Best Sellers

Use this focused JustOneAPI skill for best Sellers in Amazon. It targets GET /api/amazon/get-best-sellers/v1. Required non-token inputs are category. OpenAPI describes it as: 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.

Endpoint Scope

Platform key: amazon
Endpoint key: get-best-sellers
Platform family: Amazon
Skill slug: justoneapi-amazon-get-best-sellers

Operation	Version	Method	Path	OpenAPI summary
`getBestSellersV1`	`v1`	`GET`	`/api/amazon/get-best-sellers/v1`	Best Sellers

Inputs

Parameter	In	Required by	Optional by	Type	Notes
`category`	`query`	all	n/a	`string`	Best sellers category to return products for (e.g. 'baby-products' or 'baby-products/166777011'). The value is derived from the URL path of the Amazon Best Sellers page, such as: https://www.amazon.com/Best-Sellers-Baby-Baby-Toddler-Feeding-Supplies/zgbs/baby-products/166777011
`country`	`query`	n/a	all	`string`	Country code for the Amazon product. Available Values: - `US`: United States - `AU`: Australia - `BR`: Brazil - `CA`: Canada - `CN`: China - `FR`: France - `DE`: Germany - `IN`: India - `IT`: Italy - `MX`: Mexico - `NL`: Netherlands - `SG`: Singapore - `ES`: Spain - `TR`: Turkey - `AE`: United Arab Emirates - `GB`: United Kingdom - `JP`: Japan - `SA`: Saudi Arabia - `PL`: Poland - `SE`: Sweden - `BE`: Belgium - `EG`: Egypt - `ZA`: South Africa - `IE`: Ireland
`country` enum	values	n/a	n/a	n/a	`AE`, `AU`, `BE`, `BR`, `CA`, `CN`, `DE`, `EG`, `ES`, `FR`, `GB`, `IE`, `IN`, `IT`, `JP`, `MX`, `NL`, `PL`, `SA`, `SE`, `SG`, `TR`, `US`, `ZA`
`page`	`query`	n/a	all	`integer`	Page number for pagination

Request body: none documented; send parameters through path or query arguments.

Version Choice

Use getBestSellersV1 for the documented v1 endpoint. There are no alternate versions grouped in this skill.

Run This Endpoint

Supported operation IDs in this skill: getBestSellersV1.

node {baseDir}/bin/run.mjs --operation "getBestSellersV1" --token "$JUST_ONE_API_TOKEN" --params-json '{"category":"\x3Ccategory>"}'

Ask for any missing required parameter before calling the helper. Keep user-provided IDs, cursors, keywords, and filters unchanged.

Environment

Required: JUST_ONE_API_TOKEN
Pass the token with --token "$JUST_ONE_API_TOKEN"; do not paste token values into chat messages, screenshots, or logs.
Get a token from Just One API Dashboard.
Authentication details: Just One API Usage Guide.

Output Focus

State the operation ID and endpoint path used, for example getBestSellersV1 on /api/amazon/get-best-sellers/v1.
Echo the required lookup scope (category) before summarizing results.
Prioritize fields that support this endpoint purpose: 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.
Return raw JSON only after the short, endpoint-specific summary.
If the backend errors, include the backend payload and the exact operation ID.

安全使用建议

This skill is coherent with its purpose. Before installing: ensure you trust JustOneAPI and the listed homepage; keep JUST_ONE_API_TOKEN secret (do not paste it into chats or logs); be aware the token is passed in the URL/query string and may appear in server logs; restrict the token's permissions if possible and rotate it if exposed; review the provider's pricing/rate limits and privacy policy so you understand what data is sent to the third party.

功能分析

Type: OpenClaw Skill Name: justoneapi-amazon-get-best-sellers Version: 1.0.2 The skill is a standard API wrapper for the JustOneAPI Amazon Best Sellers service. The execution logic in `bin/run.mjs` is straightforward, using standard Node.js fetch to interact with the official domain (api.justoneapi.com), and the instructions in `SKILL.md` correctly advise the agent on secure token handling.

能力评估

✓ Purpose & Capability

Name/description, required env var (JUST_ONE_API_TOKEN), required binary (node), and the bundled run.mjs script all match the declared purpose of calling JustOneAPI's GET /api/amazon/get-best-sellers/v1 endpoint.

✓ Instruction Scope

SKILL.md and bin/run.mjs only ask for the API token and query parameters (category, optional country/page) and perform a single HTTP GET to the documented base URL. The instructions do not request unrelated files, credentials, or system data.

✓ Install Mechanism

There is no install spec; the skill includes a small node script (bin/run.mjs). Requiring node is proportionate and no external downloads or archives are used.

✓ Credentials

Only JUST_ONE_API_TOKEN is required and is the primary credential for the stated API. No other secrets or config paths are requested. Note: the token is sent as a query parameter (per the API), which can be visible in logs/URLs — the SKILL.md warns against pasting the token into chats or logs.

✓ Persistence & Privilege

The skill does not request always: true and does not modify other skills or system-wide settings. It runs only when invoked.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install justoneapi-amazon-get-best-sellers
安装完成后，直接呼叫该 Skill 的名称或使用 /justoneapi-amazon-get-best-sellers 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.0.2

- Simplified and focused documentation to highlight the primary endpoint, required parameters, and use cases. - Clarified that `category` is the only required parameter; improved parameter table and country code documentation. - Added explicit endpoint and operation details (operation ID, path, summary table). - Updated output instructions to prioritize the summary, required scope, and endpoint focus. - Streamlined setup and usage instructions for environment configuration.

v1.0.1

- Updated internal operation definitions and documentation files. - No changes to the user interface or input/output behavior. - Maintenance release; keeps references and generated files in sync.

v1.0.0

Initial publish

元数据

Slug justoneapi-amazon-get-best-sellers

版本 1.0.2

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 3

常见问题