Open Claw 封裝的 1688.item_search_img（按圖搜款） 接口，是 1688 官方拍立淘能力的標(biāo)準(zhǔn)化輸出，無需企業(yè)資質(zhì)、無需復(fù)雜權(quán)限，拿到 Key 即可調(diào)用，5 分鐘就能實(shí)現(xiàn) “圖片→同款貨源→全量數(shù)據(jù)” 的全自動(dòng)選品，效率比手動(dòng)翻頁提升 10 倍以上。

一、核心優(yōu)勢(shì)：為什么選 Open Claw 做圖片選品

零門檻接入：不用對(duì)接 1688 開放平臺(tái)、不用申請(qǐng)應(yīng)用、不用處理簽名 / Token，注冊(cè)即得 Key+Secret。

全字段返回：一次請(qǐng)求拿到標(biāo)題、主圖、價(jià)格、銷量、庫存、一件代發(fā)、店鋪回頭率、詳情鏈接等選品全數(shù)據(jù)。

穩(wěn)定合規(guī)：官方授權(quán)封裝，無爬蟲風(fēng)險(xiǎn)、無反爬攔截、數(shù)據(jù)實(shí)時(shí)同步 1688 平臺(tái)。

多場(chǎng)景適配：支持網(wǎng)絡(luò)圖片 / 本地圖片（轉(zhuǎn) URL）、淘寶 / 抖音 / 小紅書爆款圖搜同款、批量選品 + 貨源監(jiān)控。

二、接口核心信息（直接套用）

1. 基礎(chǔ)信息

接口名稱：1688 按圖搜索商品（item_search_img）

請(qǐng)求地址：https://api-gw.onebound.cn/1688/item_search_img

請(qǐng)求方式：GET/POST

返回格式：JSON

2. 核心參數(shù)（必填 + 常用）

表格

3. 選品必看字段（直接用）

title：商品標(biāo)題（可直接用于鋪貨標(biāo)題優(yōu)化）

pic_url：商品主圖（可下載用于店鋪裝修）

price/promotion_price：原價(jià) / 促銷價(jià)（快速比價(jià)）

sales：30 天銷量（判斷爆款潛力）

num_iid：商品 ID（用于后續(xù)詳情查詢 / 監(jiān)控）

one_psale：是否一件代發(fā)（無貨源賣家核心）

turn_head：店鋪回頭率（篩選優(yōu)質(zhì)供應(yīng)商）

detail_url：商品詳情頁（一鍵核對(duì)貨源）

三、5 分鐘實(shí)戰(zhàn)：從注冊(cè)到選品全流程

步驟 1：注冊(cè)獲取調(diào)用憑證（3 分鐘）

訪問 Open Claw 官網(wǎng)注冊(cè)賬號(hào)

登錄后進(jìn)入控制臺(tái)→我的密鑰，復(fù)制 Key 和 Secret（妥善保管，勿泄露）

確認(rèn) 1688.item_search_img 接口狀態(tài)為正常（默認(rèn)開通）

步驟 2：準(zhǔn)備圖片 URL（2 分鐘）

網(wǎng)絡(luò)圖片：直接復(fù)制圖片鏈接（如抖音 / 淘寶爆款圖）

本地圖片：上傳至阿里云 OSS / 免費(fèi)圖床，生成公網(wǎng)可訪問 URL

格式要求：支持 JPG/PNG，建議尺寸 500×500px 以上，相似度更高

步驟 3：代碼調(diào)用（Python 示例，復(fù)制即用）

1）安裝依賴

bash

運(yùn)行

pip install requests openpyxl  # openpyxl用于導(dǎo)出Excel

2）完整代碼（替換 Key/Secret/ 圖片 URL）

python

運(yùn)行

import requests
import openpyxl
from datetime import datetime

# 1. 配置核心參數(shù)（替換為你自己的）
API_KEY = "你的Key"
API_SECRET = "你的Secret"
IMG_URL = "https://example.com/your-image.jpg"  # 替換為目標(biāo)圖片URL
API_URL = "https://api-gw.onebound.cn/1688/item_search_img"

def image_search_1688():
    """按圖搜索1688同款商品"""
    params = {
        "key": API_KEY,
        "secret": API_SECRET,
        "api_name": "item_search_img",
        "imgid": IMG_URL,
        "sort": "_sale",  # 按銷量排序
        "page": "1"
    }

    try:
        # 發(fā)送請(qǐng)求
        response = requests.get(API_URL, params=params, timeout=10)
        data = response.json()

        if data.get("code") == 200:
            items = data.get("result", {}).get("items", [])
            print(f"? 搜索成功，找到 {len(items)} 款相似商品")
            return items
        else:
            print(f"? 請(qǐng)求失?。簕data.get('msg')}")
            return []
    except Exception as e:
        print(f"? 網(wǎng)絡(luò)異常：{str(e)}")
        return []

def export_to_excel(items):
    """導(dǎo)出選品數(shù)據(jù)到Excel"""
    if not items:
        return

    wb = openpyxl.Workbook()
    ws = wb.active
    ws.title = "1688圖片選品結(jié)果"

    # 表頭
    headers = ["商品標(biāo)題", "價(jià)格", "銷量", "是否一件代發(fā)", "店鋪回頭率", "商品鏈接", "主圖鏈接"]
    ws.append(headers)

    # 寫入數(shù)據(jù)
    for item in items:
        row = [
            item.get("title", ""),
            item.get("price", ""),
            item.get("sales", "0"),
            "是" if item.get("one_psale") else "否",
            item.get("turn_head", "0%"),
            item.get("detail_url", ""),
            item.get("pic_url", "")
        ]
        ws.append(row)

    # 保存文件
    filename = f"1688圖片選品_{datetime.now().strftime('%Y%m%d_%H%M%S')}.xlsx"
    wb.save(filename)
    print(f"

審核編輯 黃宇