← Back to Skills Marketplace
justoneapi

JD.com API

by justoneapi · GitHub ↗ · v1.0.9 · MIT-0
cross-platform ✓ Security Clean
209
Downloads
0
Stars
1
Active Installs
10
Versions
Install in OpenClaw
/install justoneapi-jd
Description
Analyze JD.com workflows with JustOneAPI, including product Details, product Comments, and shop Product List.
README (SKILL.md)

JD.com

This skill wraps 3 JD.com operations exposed by JustOneAPI. It is strongest for product Details, product Comments, and shop Product List. Expect common inputs such as itemId, page, shopId.

When To Use It

  • The user needs product Details or product Comments on JD.com.
  • 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, shopId.
  • The user wants an exact API-backed answer instead of a freeform summary.

Representative Operations

  • getJdItemDetailV1: Product Details — Get JD.com product Details data, including pricing, images, and shop information, for catalog analysis, product monitoring, and ecommerce research
  • getItemCommentsV1: Product Comments — Get JD.com product Comments data, including ratings, timestamps, and reviewer signals, for customer feedback analysis and product research
  • getJdShopItemListV1: Shop Product List — Get JD.com shop Product List data, including item titles, prices, and images, for catalog tracking and seller research

Request Pattern

  • 3 operations are available in this skill.
  • HTTP methods used here: GET.
  • The most common non-token parameters are itemId, page, 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: getJdItemDetailV1, getItemCommentsV1, getJdShopItemListV1.
  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 JD.com task the user asked for.
  • Include the most decision-relevant fields from the selected endpoint before dumping raw JSON.
  • When using getJdItemDetailV1, explain why the returned fields answer the user's question.
  • If the user gave filters such as itemId, page, shopId, echo those back so the scope is explicit.
  • If the backend errors, include the backend payload and the exact operation ID.
Usage Guidance
This appears to be a straightforward wrapper around JustOneAPI's JD.com endpoints. Before installing: (1) confirm you trust JustOneAPI and its privacy/policy (https://api.justoneapi.com and the dashboard link in SKILL.md); (2) keep JUST_ONE_API_TOKEN secret and do not paste it into chat; (3) consider creating a scoped/limited API key on JustOneAPI if available and enable rotation; (4) be aware the included run.mjs will perform outbound HTTPS requests to api.justoneapi.com and will print the API responses to stdout — avoid running it in an environment where sensitive data could be captured in logs; (5) verify rate limits and billing on JustOneAPI to avoid unexpected charges. If you want higher assurance, inspect or run the bundled bin/run.mjs in a sandbox before granting your token.
Capability Analysis
Type: OpenClaw Skill Name: justoneapi-jd Version: 1.0.9 The skill is a standard API wrapper for JD.com via the JustOneAPI service. The execution script (bin/run.mjs) is a clean Node.js implementation that performs authenticated GET requests to the official domain (api.justoneapi.com) without any suspicious side effects, obfuscation, or unauthorized data access.
Capability Tags
requires-oauth-tokenrequires-sensitive-credentials
Capability Assessment
Purpose & Capability
Name/description (JD.com via JustOneAPI) match the actual behavior: the bundled script calls https://api.justoneapi.com endpoints to fetch item details, comments, and shop lists. Required binaries (node) and the single env var JUST_ONE_API_TOKEN are appropriate for this purpose.
Instruction Scope
SKILL.md limits actions to selecting an operation, asking the user for missing parameters, and running the included node helper to call the API. It does not instruct reading unrelated files, other env vars, or exfiltrating data to third-party endpoints.
Install Mechanism
There is no external install step or download; this is instruction-only with a bundled bin/run.mjs. No remote archives, shorteners, or untrusted URLs are used for installation.
Credentials
The skill requests one credential (JUST_ONE_API_TOKEN) and documents it as the token used only for authenticated JustOneAPI requests. No additional unrelated secrets, config paths, or high-privilege credentials are required.
Persistence & Privilege
always is false and the skill does not request persistent/system-wide privileges or modify other skills. The skill will run only when invoked; autonomous invocation is permitted by default but is not combined with other concerning privileges here.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install justoneapi-jd
  3. After installation, invoke the skill by name or use /justoneapi-jd
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.9
- Operation names updated: `getItemDetailV1` is now `getJdItemDetailV1`, and `getShopItemListV1` is now `getJdShopItemListV1`. - All docs and operation references updated to use the new operation IDs. - No user-facing feature or parameter changes; only naming adjustments for consistency.
v1.0.8
- Updated authentication documentation link under "Environment" to include UTM tracking parameters - No functional or structural changes to the skill logic or behavior
v1.0.7
- Updated the Just One API dashboard link in the Environment section for improved token retrieval guidance. - No functional or behavioral changes; documentation update only.
v1.0.6
- Clarified that JUST_ONE_API_TOKEN is used only for authenticated Just One API requests. - No changes to functionality or endpoints; documentation update only.
v1.0.5
- Updated security guidance: added instruction to keep the `JUST_ONE_API_TOKEN` private and not share it in chat messages, screenshots, or logs. - No changes to functionality or operations; only documentation enhanced for safer handling of API tokens.
v1.0.4
Version 1.0.4 - Added specific instructions on how to obtain the required `JUST_ONE_API_TOKEN`, including links to the Just One API Dashboard and Usage Guide. - No changes to operations, usage pattern, or parameters. - Enhanced environment setup guidance for improved onboarding.
v1.0.3
rename
v1.0.2
rename
v1.0.1
- Updated the skill name in SKILL.md from "justoneapi_jd" to "JD.com API". - No functional or operational changes; documentation only. - Maintains all usage, output, and operational details as before.
v1.0.0
- Initial release of justoneapi_jd skill. - Provides programmatic access to JD.com data via JustOneAPI. - Supports three operations: product Details (`getItemDetailV1`), product Comments (`getItemCommentsV1`), and shop Product List (`getShopItemListV1`). - Designed for tasks requiring exact, API-backed JD.com product information, user comments, and shop listings. - Requires `JUST_ONE_API_TOKEN` for authentication. - Usage guidelines and required parameters clearly documented.
Metadata
Slug justoneapi-jd
Version 1.0.9
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 10
Frequently Asked Questions

What is JD.com API?

Analyze JD.com workflows with JustOneAPI, including product Details, product Comments, and shop Product List. It is an AI Agent Skill for Claude Code / OpenClaw, with 209 downloads so far.

How do I install JD.com API?

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

Is JD.com API free?

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

Which platforms does JD.com API support?

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

Who created JD.com API?

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

💬 Comments