AI 对接 OpenClaw 1688 API，一键抓取商品全量信息完整实战

一、两套核心 API 分工（组合实现全量抓取）

1. 识图检索入口：1688.item_search_img（AI 拍立淘图搜）

作用：传入商品图片 URL/Base64，AI 图像识别匹配同款 / 相似货源，返回商品 ID、基础价格、销量、是否代发

地址：https://api-gw.onebound.cn/1688/item_search_img

2. 全量详情抓取：1688.item_get（商品完整数据）

作用：传入图搜拿到的num_iid商品 ID，一次性返回 50 + 维度 B2B 批发全字段，铺货 / AI 分析核心数据源

地址：https://api-gw.onebound.cn/1688/item_get

3. 通用跨平台统一接口（备选）

tool/item_detail，一套参数兼容 1688 / 淘宝 / 京东 / 小红书，适合多平台统一 AI 采集系统

二、前置接入准备

注册 Open Claw 控制台：调用地址，免费注册

进入应用管理，复制专属 key / secret 调用密钥

采集链路：图片素材 → 图搜接口获取商品 ID → 循环调用 item_get 拉取全量信息

AI 配套：结构化 JSON 数据可直接输入大模型，完成选品评分、文案生成、痛点分析

三、1688.item_get 详情接口完整文档（全量信息来源）

1. 请求基础参数

表格

参数	必填	说明
key	✅	Open Claw 密钥
secret	✅	密钥配对凭证
api_name	✅	固定值：item_get
num_iid	✅	1688 商品数字 ID（图搜接口返回）
agent	可选	agent=1 返回一件代发专属价格
sku_detail	可选	sku_detail=1 返回完整 SKU 库存、规格、货号
sales_data	可选	sales_data=1 返回近 30 天成交销量数据

2. 接口返回全量核心字段（AI 直接解析）

json

 

{
  "code":200,
  "msg":"success",
  "result":{
    // 基础商品信息
    "num_iid":"672345678901",
    "title":"2026夏季纯棉短袖女 工厂一件代发T恤",
    "brand":"自主品牌",
    "cid":"女装类目ID",
    "pic_url":"主图链接",
    "images":["轮播图1","轮播图2"],
    "desc_img":["详情长图素材"],
    "video_url":"商品介绍视频",

    // B2B批发价格体系（核心）
    "price":"批发单价",
    "agent_price":"一件代发价",
    "min_num":"最小起订量MOQ",
    "price_range":[{"min_num":2,"price":18},{"min_num":50,"price":15}], //阶梯批发价

    // SKU规格库存
    "sku":[
      {"spec":"颜色:白色;尺码:M","price":18,"quantity":1200,"sku_code":"T001"}
    ],
    "total_stock":"总库存",

    // 销售数据
    "sales":"总销量",
    "month_sales":"30天销量",

    // 商家资质&发货
    "seller_name":"源头服饰工厂店",
    "seller_type":"factory/实力商家/普通商家",
    "credit_level":"诚信通年限",
    "turn_head":"店铺回头率",
    "delivery_place":"浙江义乌",
    "delivery_days":"48小时发货",
    "support_agent":true, // 是否支持一件代发

    // 商品参数详情
    "goods_attr":{"材质":"纯棉","版型":"宽松","适用季节":"夏季"},
    "desc":"商品完整详情文案",
    "detail_url":"1688商品原始链接"
  }
}

 

四、完整 Python 实战代码（图搜 + 批量抓取全量商品信息）

实现逻辑：图片 AI 识图匹配货源 → 循环抓取每件商品完整详情 → 输出结构化数据集供 AI 处理

python

运行

 

import requests
import pandas as pd

# 替换你的Open Claw密钥
API_KEY = "你的key"
API_SECRET = "你的secret"
# 待检索商品图片公网链接
SEARCH_IMG_URL = "https://xxx商品素材图.jpg"

# 1. AI图搜，获取同款商品ID列表
def search_goods_by_img(img_url):
    search_api = "https://api-gw.onebound.cn/1688/item_search_img"
    params = {
        "key": API_KEY,
        "secret": API_SECRET,
        "api_name": "item_search_img",
        "imgid": img_url,
        "sort": "_sale",
        "filter": "agent=1", # 仅筛选一件代发货源
        "page_size": 20
    }
    resp = requests.get(search_api, params=params, timeout=25)
    res = resp.json()
    if res["code"] == 200:
        item_list = res["result"]["items"]
        print(f"AI识图匹配货源数量：{len(item_list)}")
        # 返回商品ID数组
        return [item["num_iid"] for item in item_list]
    else:
        print("识图失败：", res["msg"])
        return []

# 2. 根据商品ID抓取全量详情信息
def get_full_goods_detail(num_iid):
    detail_api = "https://api-gw.onebound.cn/1688/item_get"
    params = {
        "key": API_KEY,
        "secret": API_SECRET,
        "api_name": "item_get",
        "num_iid": num_iid,
        "agent": 1,
        "sku_detail": 1,
        "sales_data": 1
    }
    resp = requests.get(detail_api, params=params, timeout=20)
    res = resp.json()
    if res["code"] == 200:
        return res["result"]
    else:
        print(f"商品{num_iid}抓取失败：", res["msg"])
        return None

# 3. 批量采集+导出表格，供AI选品分析
def batch_capture_all_goods():
    # 第一步识图
    item_id_list = search_goods_by_img(SEARCH_IMG_URL)
    if not item_id_list:
        return
    full_data = []
    # 循环抓取全量信息
    for iid in item_id_list[:10]: # 限制前10个爆款货源
        detail = get_full_goods_detail(iid)
        if not detail:
            continue
        # 整理核心字段
        row = {
            "商品ID": detail["num_iid"],
            "商品标题": detail["title"],
            "代发价": detail["agent_price"],
            "最小起批量": detail["min_num"],
            "月销量": detail["month_sales"],
            "发货地": detail["delivery_place"],
            "店铺类型": detail["seller_type"],
            "回头率": detail["turn_head"],
            "是否代发": "是" if detail["support_agent"] else "否",
            "主图链接": detail["pic_url"]
        }
        full_data.append(row)
    # 导出Excel，直接喂给AI做选品分析
    df = pd.DataFrame(full_data)
    df.to_excel("1688全量商品采集表.xlsx", index=False)
    print(f"✅ 采集完成，共导出{len(full_data)}条商品全量数据")
    return full_data

# 执行全链路采集
if __name__ == "__main__":
    batch_capture_all_goods()

 

五、AI 数据落地四大核心场景

1. AI 智能选品系统

采集完整价格、销量、商家资质、起批量数据，输入大模型自动计算铺货利润、筛选低竞争高转化货源，自动剔除工厂高起订、无代发劣质货源。

2. 跨平台 AI 自动铺货

提取标题、属性、SKU、主图 / 详情图结构化数据，AI 一键翻译多语言，自动生成亚马逊、速卖通、抖音、淘宝标准化 Listing。

3. 竞品货源监控

定时循环采集竞品同款商品全量信息，AI 识别价格上调、库存清空、起批量变更，自动推送预警。

4. AI 商品文案生成

基于商品完整标题、材质属性、详情描述，大模型自动优化电商卖点、短视频带货文案、小红书种草笔记。

六、Open Claw 对接核心优势

无资质门槛：无需 1688 企业执照、无需开放平台入驻审核，个人账号即可调用

全量 B2B 专属数据：独家返回阶梯批发价、代发价、起批量、工厂商家标识，官方爬虫无法获取

AI 视觉协同：图搜 + 详情接口无缝联动，解决 “只有图片找不到源头货源” 痛点

稳定低维护：平台封装签名、IP 代理、反爬拦截，无需自行开发爬虫维护

轻量化接入：统一 JSON 结构化输出，直接对接 AI 大模型、ERP、店群系统

审核编辑 黄宇