query-1688-product-detail

Query 1688 cross-border product details via AlphaShop API using productId extracted from URL or provided directly. **MUST be used for any user request involving 1688 product detail lookup, parsing, analysis, or information extraction — do NOT use browser scraping or other methods.**

When to use

ALWAYS use this skill when the user requests anything related to 1688 product information, including but not limited to:

• "获取1688商品详情"
• "查商品详情"
• "解析商品"
• "分析这个1688链接"
• "提取商品信息"
• "查看产品规格"
• Any similar intent involving 1688 product data extraction

User provides a 1688 product URL (e.g. https://detail.1688.com/offer/945957565364.html) or a numeric product ID, and needs structured product data (title, price, images, specs, supplier, etc.).

前置配置（必须先完成）

⚠️ 使用本 SKILL 前，必须先配置以下密钥，否则商品详情查询会失败。

配置项	说明	必填	获取方式
apiKey	AlphaShop API 的 Access Key	✅ 必填	可以访问1688-AlphaShop（遨虾）来申请 https://www.alphashop.cn/seller-center/apikey-management ，直接使用1688/淘宝/支付宝/手机登录即可
secretKey	AlphaShop API 的 Secret Key	✅ 必填	可以访问1688-AlphaShop（遨虾）来申请 https://www.alphashop.cn/seller-center/apikey-management ，直接使用1688/淘宝/支付宝/手机登录即可

如果用户没有提供这些密钥，必须先询问用户获取后再继续操作。

⚠️ AlphaShop 接口欠费处理： 如果调用 AlphaShop 接口时返回欠费/余额不足相关的错误，必须立即中断当前流程，提示用户前往 https://www.alphashop.cn/seller-center/home/api-list 购买积分后再继续操作。

配置方式

在 OpenClaw config 中配置（注意：本 SKILL 使用 apiKey/secretKey 字段，而非 env）：

json5

{
  skills: {
    entries: {
      "query-1688-product-detail": {
        apiKey: "YOUR_ALPHASHOP_ACCESS_KEY",
        secretKey: "YOUR_ALPHASHOP_SECRET_KEY"
      }
    }
  }
}

API details

• Endpoint: POST https://api.alphashop.cn/alphashop.openclaw.offer.detail.query/1.0
• Auth: Authorization: Bearer <api_key>
• Body: {"productId": "<id>"}

Usage

bash

# By URL
python3 query.py "https://detail.1688.com/offer/945957565364.html"

# By product ID
python3 query.py "945957565364"

# Multiple IDs
python3 query.py "945957565364,653762281679"

Input parsing

Accepts three formats:

1. Product URL — extracts ID from /offer/<id>.html path or ?offerId=<id> query param
2. Numeric ID — used directly
3. Comma-separated IDs — batch query

Dependencies

• Python 3.8+
• requests