Skillppx logo

query-1688-product-detail

通过AlphaShop API获取1688跨境商品详情，支持URL或ID输入。

已扫描
适合谁
跨境电商从业者、商品数据分析师
不适合谁
无1688-AlphaShop API密钥的用户、希望绕过API直接抓取页面的用户
国内可用性
需网络配置。可能需要网络配置或第三方服务可访问。
安装难度
新手友好（★☆☆）。基于终端操作、依赖、API Key 和本地环境要求的初步判断。

安装与下载

openclaw skills install @1688aiinfra/query-1688-product-detail
下载官方 ZIP

Skill 说明

命令、参数、文件名以原文为准

何时使用

当用户请求与1688商品信息相关的内容时，必须使用此技能，包括但不限于：

  • "获取1688商品详情"
  • "查商品详情"
  • "解析商品"
  • "分析这个1688链接"
  • "提取商品信息"
  • "查看产品规格"
  • 任何涉及1688商品数据提取的类似意图

用户会提供一个1688商品链接（例如 https://detail.1688.com/offer/945957565364.html）或商品编号，需要获取结构化的商品数据（如标题、价格、图片、规格、供应商等）。

前置配置（必须先完成）

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

配置项说明必填获取方式
apiKeyAlphaShop API 的 Access Key✅ 必填可通过1688-AlphaShop（遨虾）申请 https://www.alphashop.cn/seller-center/apikey-management ，使用1688/淘宝/支付宝/手机登录即可
secretKeyAlphaShop 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 中进行配置（注意：本技能使用 apiKey/secretKey 字段，而非 env）：

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

API 详情

  • 接口地址： POST https://api.alphashop.cn/alphashop.openclaw.offer.detail.query/1.0
  • 认证方式： Authorization: Bearer <api_key>
  • 请求体： {"productId": "<id>"}

使用方法

# 通过链接
python3 query.py "https://detail.1688.com/offer/945957565364.html"

# 通过商品编号
python3 query.py "945957565364"

# 多个编号（批量查询）
python3 query.py "945957565364,653762281679"

输入解析

支持三种格式：

  1. 商品链接 — 从 /offer/<id>.html 路径或 ?offerId=<id> 查询参数中提取编号
  2. 纯数字编号 — 直接使用
  3. 逗号分隔的编号列表 — 支持批量查询

依赖项

  • Python 3.8+
  • requests
1
@1688aiinfra

已收录 1 个 Skill

相关推荐