← 返回 Skills 市场
justoneapi

JD.com API

作者 justoneapi · GitHub ↗ · v1.0.9 · MIT-0
cross-platform ✓ 安全检测通过
209
总下载
0
收藏
1
当前安装
10
版本数
在 OpenClaw 中安装
/install justoneapi-jd
功能描述
Analyze JD.com workflows with JustOneAPI, including product Details, product Comments, and shop Product List.
使用说明 (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.
安全使用建议
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.
功能分析
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.
能力标签
requires-oauth-tokenrequires-sensitive-credentials
能力评估
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.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install justoneapi-jd
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /justoneapi-jd 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
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.
元数据
Slug justoneapi-jd
版本 1.0.9
许可证 MIT-0
累计安装 1
当前安装数 1
历史版本数 10
常见问题

JD.com API 是什么?

Analyze JD.com workflows with JustOneAPI, including product Details, product Comments, and shop Product List. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 209 次。

如何安装 JD.com API?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install justoneapi-jd」即可一键安装,无需额外配置。

JD.com API 是免费的吗?

是的,JD.com API 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

JD.com API 支持哪些平台?

JD.com API 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 JD.com API?

由 justoneapi(@justoneapi)开发并维护,当前版本 v1.0.9。

💬 留言讨论