当前位置：首页 > ops >正文

利用 Java 爬虫按图搜索 1688 商品（拍立淘）实战指南

ops 2025/8/15 11:17:16

在电商领域，按图搜索商品（类似于淘宝的拍立淘）是一种非常实用的功能，尤其适合用户通过图片快速查找相似商品。1688 开放平台提供了按图搜索商品的 API 接口，允许开发者通过图片获取相关的商品信息。本文将详细介绍如何使用 Java 爬虫技术调用 1688 的按图搜索 API 接口，并解析返回的数据。

一、前期准备

（一）Java 开发环境

确保已安装 Java 开发环境，推荐使用 JDK 1.8 或更高版本。

（二）依赖管理

使用 Maven 或 Gradle 管理项目依赖，主要包括以下库：

Apache HttpClient：用于发送 HTTP 请求。
Jackson：用于解析 JSON 数据。

以下是 Maven 项目的 pom.xml 依赖配置示例：

xml

<dependencies><dependency><groupId>org.apache.httpcomponents</groupId><artifactId>httpclient</artifactId><version>4.5.13</version></dependency><dependency><groupId>com.fasterxml.jackson.core</groupId><artifactId>jackson-databind</artifactId><version>2.10.0</version></dependency>
</dependencies>

二、构建 API 请求

根据 1688 开放平台的 API 文档，按图搜索商品的接口地址为 https://api-gw.onebound.cn/1688/item_search_img。以下是请求参数的说明：

key：AppKey。
secret：AppSecret。
image_url：图片的 URL，需要是可访问的图片地址。
page：页码（默认为 1）。
page_size：每页显示的商品数量（默认为 40）。
sort：排序方式（如 price 按价格排序）。

三、Java 爬虫实现

（一）生成签名

1688 API 接口需要对请求参数进行签名验证。以下是一个生成签名的 Java 方法示例：

java

import java.util.TreeMap;public class ApiUtil {public static String generateSign(TreeMap<String, String> params, String appSecret) {StringBuilder sb = new StringBuilder();for (Map.Entry<String, String> entry : params.entrySet()) {sb.append(entry.getKey()).append(entry.getValue());}sb.append(appSecret);return md5(sb.toString()).toUpperCase();}private static String md5(String str) {try {java.security.MessageDigest md = java.security.MessageDigest.getInstance("MD5");byte[] array = md.digest(str.getBytes());StringBuilder sb = new StringBuilder();for (byte b : array) {sb.append(String.format("%02x", b));}return sb.toString();} catch (Exception e) {throw new RuntimeException(e);}}
}

（二）发送 HTTP 请求

使用 Apache HttpClient 发送 GET 请求，获取 API 返回的 JSON 数据：

java

import org.apache.http.client.methods.HttpGet;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.util.EntityUtils;import java.util.Map;public class AlibabaImageSearchCrawler {private static final String APP_KEY = "your_app_key";private static final String APP_SECRET = "your_app_secret";public static void main(String[] args) {String imageUrl = "https://example.com/image.jpg"; // 图片 URLint page = 1;int pageSize = 40;TreeMap<String, String> params = new TreeMap<>();params.put("key", APP_KEY);params.put("image_url", imageUrl);params.put("page", String.valueOf(page));params.put("page_size", String.valueOf(pageSize));params.put("sort", "price");String sign = ApiUtil.generateSign(params, APP_SECRET);params.put("sign", sign);StringBuilder urlBuilder = new StringBuilder("https://api-gw.onebound.cn/1688/item_search_img?");for (Map.Entry<String, String> entry : params.entrySet()) {urlBuilder.append(entry.getKey()).append("=").append(entry.getValue()).append("&");}String url = urlBuilder.toString().substring(0, urlBuilder.length() - 1);try (CloseableHttpClient httpClient = HttpClients.createDefault()) {HttpGet request = new HttpGet(url);String jsonResponse = EntityUtils.toString(httpClient.execute(request).getEntity());System.out.println("API Response: " + jsonResponse);} catch (Exception e) {e.printStackTrace();}}
}

（三）解析 API 返回的 JSON 数据

假设 API 返回的 JSON 数据结构如下：

JSON

{"items": [{"title": "商品标题","price": "100.00","shop": "店铺名称","link": "商品链接"}]
}

可以使用 Jackson 库解析 JSON 数据：

java

import com.fasterxml.jackson.databind.JsonNode;
import com.fasterxml.jackson.databind.ObjectMapper;import java.io.IOException;
import java.util.ArrayList;
import java.util.List;public class Product {private String title;private String price;private String shop;private String link;// Getters and Setters
}public class JsonParser {public static List<Product> parseJson(String jsonResponse) throws IOException {ObjectMapper objectMapper = new ObjectMapper();JsonNode rootNode = objectMapper.readTree(jsonResponse);JsonNode itemsNode = rootNode.path("items");List<Product> products = new ArrayList<>();for (JsonNode itemNode : itemsNode) {Product product = new Product();product.setTitle(itemNode.path("title").asText());product.setPrice(itemNode.path("price").asText());product.setShop(itemNode.path("shop").asText());product.setLink(itemNode.path("link").asText());products.add(product);}return products;}
}