← Back to Skills Marketplace
justoneapi

Taobao and Tmall API

by justoneapi · GitHub ↗ · v1.0.6 · MIT-0
cross-platform ✓ Security Clean
184
Downloads
0
Stars
1
Active Installs
7
Versions
Install in OpenClaw
/install justoneapi-taobao
Description
Analyze Taobao and Tmall workflows with JustOneAPI, including product Details, product Reviews, and shop Product List across 10 operations.
README (SKILL.md)

Taobao and Tmall

This skill wraps 10 Taobao and Tmall operations exposed by JustOneAPI. It is strongest for product Details, product Reviews, shop Product List, and product Search. Expect common inputs such as itemId, page, sort, userId, shopId.

When To Use It

  • The user needs product Details or product Reviews on Taobao and Tmall.
  • The task lines up with shop Product List rather than a generic cross-platform workflow.
  • The user can provide identifiers or filters such as itemId, page, sort, userId.
  • The user wants an exact API-backed answer instead of a freeform summary.

Representative Operations

  • getTaobaoItemDetailV1: Product Details — Get Taobao and Tmall product Details data, including pricing, images, and shop details, for product research, catalog monitoring, and ecommerce analysis
  • getItemCommentV3: Product Reviews — Get Taobao and Tmall product Reviews data, including ratings, timestamps, and reviewer signals, for feedback analysis and product research
  • getTaobaoShopItemListV1: Shop Product List — Get Taobao and Tmall shop Product List data, including item titles, prices, and images, for seller research and catalog tracking
  • searchItemListV1: Product Search — Get Taobao and Tmall product Search data, including titles, prices, and images, for product discovery

Request Pattern

  • 10 operations are available in this skill.
  • HTTP methods used here: GET.
  • The most common non-token parameters are itemId, page, sort, userId, shopId.
  • 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: getTaobaoItemDetailV1, getItemCommentV3, getTaobaoShopItemListV1, searchItemListV1.
  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 Taobao and Tmall task the user asked for.
  • Include the most decision-relevant fields from the selected endpoint before dumping raw JSON.
  • When using getTaobaoItemDetailV1, explain why the returned fields answer the user's question.
  • If the user gave filters such as itemId, page, sort, 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 be a straightforward client for JustOneAPI's Taobao/Tmall endpoints. Before installing: (1) Confirm you trust the publisher/source (JustOneAPI) and the homepage URL; (2) Only provide a JUST_ONE_API_TOKEN that is scoped for this service (do not reuse high-privilege or unrelated credentials); (3) If you are concerned, open bin/run.mjs locally to review what it sends and to which host (it should call https://api.justoneapi.com); (4) Avoid pasting the token into chat or logs; revoke the token if you later detect misuse.
Capability Analysis
Type: OpenClaw Skill Name: justoneapi-taobao Version: 1.0.6 The skill bundle is a standard API wrapper for Taobao and Tmall data via JustOneAPI. The execution script `bin/run.mjs` safely constructs and executes HTTP GET requests to the legitimate domain `api.justoneapi.com` using the provided token and parameters, without any evidence of data exfiltration, malicious execution, or prompt injection.
Capability Tags
requires-oauth-tokenrequires-sensitive-credentials
Capability Assessment
Purpose & Capability
Name and description match the actual operations: the package exposes GET endpoints on api.justoneapi.com for item details, reviews, shop lists and search. Requiring JUST_ONE_API_TOKEN and node is proportionate for this API client.
Instruction Scope
SKILL.md limits actions to selecting one of the documented endpoints, asking for missing parameters, and running bin/run.mjs to call the JustOneAPI endpoints. It does not instruct reading unrelated files or exfiltrating data to other endpoints.
Install Mechanism
There is no install spec (instruction-only), which is low risk; however a runnable code file (bin/run.mjs) is included and will be executed with the local node binary. The code's baseUrl points to api.justoneapi.com (no obscure download URLs).
Credentials
Only a single credential (JUST_ONE_API_TOKEN) is required and documented as used to authenticate with JustOneAPI. No unrelated secret/env access is requested.
Persistence & Privilege
The skill is not always-on, does not request persistent elevated privileges, and does not modify other skills or system-wide settings. Autonomous invocation is enabled by default but is not combined with other red flags.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install justoneapi-taobao
  3. After installation, invoke the skill by name or use /justoneapi-taobao
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.6
- Added a new operation, increasing total supported operations from 9 to 10. - Introduced new endpoints: getTaobaoItemDetailV1 and getTaobaoShopItemListV1. - Updated references and examples to use the new operation IDs where appropriate. - Improved documentation to reflect the expanded capability and updated representative operations.
v1.0.5
- Updated the authentication link in the Environment section to include additional referral parameters. - No changes to functionality or endpoints.
v1.0.4
- Updated the Just One API Dashboard link in the SKILL.md Environment section to include referral and campaign tracking parameters. - No changes to functionality or API endpoints. Documentation only.
v1.0.3
- Clarified usage of the JUST_ONE_API_TOKEN environment variable, specifying it is only used for authenticated Just One API requests. - No functional or API-breaking changes; documentation update only.
v1.0.2
- Added a security note: Keep `JUST_ONE_API_TOKEN` private and do not share in chat messages, screenshots, or logs. - No functional changes to skill logic or endpoints. - Documentation improved for safer environment variable handling.
v1.0.1
- Added instructions on obtaining the required `JUST_ONE_API_TOKEN`, including dashboard and usage guide links. - No functional or interface changes to endpoints or usage.
v1.0.0
init
Metadata
Slug justoneapi-taobao
Version 1.0.6
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 7
Frequently Asked Questions

What is Taobao and Tmall API?

Analyze Taobao and Tmall workflows with JustOneAPI, including product Details, product Reviews, and shop Product List across 10 operations. It is an AI Agent Skill for Claude Code / OpenClaw, with 184 downloads so far.

How do I install Taobao and Tmall API?

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

Is Taobao and Tmall API free?

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

Which platforms does Taobao and Tmall API support?

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

Who created Taobao and Tmall API?

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

💬 Comments