What makes 1688-以图搜图 notable?

1.2K downloads. Trust evidence available

How should 1688-以图搜图 be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this agent.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

agentCLAWHUBUnverified

1688-以图搜图

1688平台以图搜图，通过商品图片精准检索外观相似或同款的1688货源，返回标题、价格、起批量、月销量、复购率、交易评分等核心数据。当用户提到1688以图搜图、1688找货源、以图找同款、跨境找工厂、1688识图、图片找货源、找相似货源、image search 1688、find supplier by image时触发此技能。即使用户未明确提及"以图搜图"，只要用户提供了图片URL并希望在1688上查找匹配或相似的货源商品，也应触发此技能。 Skill: 1688-以图搜图 Owner: linkfox-ai Summary: 1688平台以图搜图，通过商品图片精准检索外观相似或同款的1688货源，返回标题、价格、起批量、月销量、复购率、交易评分等核心数据。当用户提到1688以图搜图、1688找货源、以图找同款、跨境找工厂、1688识图、图片找货源、找相似货源、image search 1688、find supplier by image时触发此技能。即使用户未明确提及"以图搜图"，只要用户提供了图片URL并希望在1688上查找匹配或相似的货源商品，也应触发此技能。 Tags: latest:1.0.7 Version history: v1.0.7 | 2026-09-14T04:52:26.162Z | user Update from 1.0.6 to 1.0.7 v1.0.6 | 2026-08-14T14:39:00.851Z | user Update

OpenClaw

View on ClawHub Homepage

Rank

Safety

Downloads

1.2k

Updated

Oct 11, 2026

Version

1.0.7

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 1.2K downloads reported by the source. Last updated 10/11/2026.

Avoid when

Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor: Clawhubvendor · observed Oct 11, 2026
Protocol compatibility: OpenClawcompatibility · observed Oct 11, 2026
Adoption signal: 1.2K downloadsadoption · observed Oct 11, 2026
Latest release: 1.0.7release · observed Sep 14, 2026
Handshake status: UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s171g8b6m2khwdy9ye8bxj0wx183vd4z:linkfox-1688-search-by-image

Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.
Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-1688-search-by-image/snapshot"

Documentation

CLAWHUB

143,571 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: linkfox-1688-search-by-image
description: 1688平台以图搜图，通过商品图片精准检索外观相似或同款的1688货源，返回标题、价格、起批量、月销量、复购率、交易评分等核心数据。当用户提到1688以图搜图、1688找货源、以图找同款、跨境找工厂、1688识图、图片找货源、找相似货源、image search 1688、find supplier by image时触发此技能。即使用户未明确提及"以图搜图"，只要用户提供了图片URL并希望在1688上查找匹配或相似的货源商品，也应触发此技能。
---

# 1688 Image-Based Product Search

This skill performs visual product searches on the 1688 platform using an image URL, helping cross-border sellers find visually similar supplier products for sourcing.

## Core Concepts

1688 Image Search uses visual recognition to find products with similar appearance on the 1688 wholesale marketplace. It returns supplier product data including title, price, minimum order quantity, monthly sales, repurchase rate, trade score, and seller identity badges.

## Data Fields

| Field | Description |
|-------|-------------|
| offerId | Product ID on 1688 |
| title | Product title |
| imageUrl | Product main image |
| price | Wholesale price (CNY) |
| consignPrice | Dropship price (CNY) |
| salesQuantity | Monthly sales volume |
| estimatedSalesAmount | Estimated monthly revenue |
| quantityBegin | Minimum order quantity |
| repurchaseRate | Repurchase rate |
| tradeScore | Product trade score |
| compositeServiceScore | Composite service experience score |
| sellerIdentities | Seller identity (超级工厂/实力商家/诚信通会员) |
| offerIdentities | Product badge (严选) |
| sendGoodsAddressText | Shipping origin |
| deliveryTime | Delivery time (24/48 hours) |
| isOnePsale | Supports dropshipping (是/否) |
| isJxhy | Premium sourcing (是/否) |
| hasPromotion | Has promotion (是/否) |
| isPatentProduct | Patent product (是/否) |

## Parameter Guide

**Image Rules:**
1. Only png, jpg, jpeg formats are supported. webp, gif, and other formats are NOT supported.
2. Base64 string must be pure encoded content WITHOUT the `data:image/jpeg;base64,` prefix.
3. Image source — one of imageUrl, imageBase64, or imageId must be provided (at least one required).

| Parameter | Required | Default | Description |
|-----------|----------|---------|-------------|
| imageUrl | Conditional | - | Public image URL (max 1000 chars). Only png/jpg/jpeg formats supported |
| imageBase64 | Conditional | - | Pure Base64 encoded image string, without `data:image/...;base64,` prefix. Only png/jpg/jpeg supported |
| imageId | Conditional | - | 1688 image ID from previous search result (speeds up pagination) |
| page | No | 1 | Page number, starting from 1 |
| pageSize | No | 20 | Results per page (1-50) |
| priceStart | No | - | Min price filter (CNY) |
| priceEnd | No | - | Max price filter (CNY) |
| filter | No | - | Filter conditions, comma-separated (see supported filters below) |
| sort | No | {"monthSold":"desc"} | Sort as JSON: {field: direction} (see supported sort fields below) |
| keyword | No | - | Keyword to further filter results |
| productCollectionId | No | - | Product collection ID (see supported IDs below) |

### Supported Filters

Multiple filters can be combined with commas (e.g. `

_meta.json

{
  "ownerId": "kn7dmc1t4j28hem1twwyav85p182pb1j",
  "slug": "linkfox-1688-search-by-image",
  "version": "1.0.7",
  "publishedAt": 1789361546162
}

references/api.md

# 1688-以图搜图 API 参考

## 调用规范

- **请求地址**：`${LINKFOX_TOOL_GATEWAY}/alibaba1688/imageSearch`
- **请求方式**：POST，Content-Type: application/json
- **认证方式**：Header `Authorization: <api_key>`，api_key 优先从环境变量 `LINKFOX_AGENT_API_KEY` 读取，回退 `LINKFOXAGENT_API_KEY`（如未配置 按 SKILL.md 的 **## 解决认证和算力问题** 处理）
- **User-Agent**：`LinkFox-Skill/1.0`
- **超时**：150s

## 请求参数

POST Body（JSON）：

| 参数 | 类型 | 必填 | 默认值 | 说明 |
|------|------|------|--------|------|
| imageUrl | string | 条件必填 | - | 图片URL地址，请确保图片URL有效且可公开访问。最大长度：1000。仅支持 png/jpg/jpeg 格式，不支持 webp/gif 等。imageUrl/imageBase64/imageId 三选一必填 |
| imageBase64 | string | 条件必填 | - | 图片 Base64 编码字符串，为纯编码内容，不包含 `data:image/jpeg;base64,` 前缀。仅支持 png/jpg/jpeg 格式（imageUrl为空时使用） |
| imageId | string | 条件必填 | - | 图片ID（1688图片ID），以图搜图查询结果中也会返回，建议当分页 page>1 查询时带 imageId，加快响应速度 |
| page | int | 否 | 1 | 页码，从1开始 |
| pageSize | int | 否 | 20 | 每页返回的商品数量，最大不超过50 |
| priceStart | string | 否 | - | 价格筛选起始值（人民币），如 10 |
| priceEnd | string | 否 | - | 价格筛选结束值（人民币），如 100 |
| filter | string | 否 | - | 过滤条件，多个条件用逗号分隔。有效值见下方「支持的过滤条件」 |
| sort | string | 否 | {"monthSold":"desc"} | 排序条件，JSON格式 {排序字段: 排序方式}。有效字段：price、rePurchaseRate、monthSold；方式：asc/desc |
| keyword | string | 否 | - | 关键词，在结果中搜索 |
| productCollectionId | string | 否 | - | 货盘ID，单选。有效值见下方「支持的货盘ID」 |

### 支持的过滤条件

多个条件用逗号分隔，如 `1688Selection,totalEpScoreLv1,qrr0`。

| 值 | 说明 |
|----|------|
| 1688Selection | 1688严选 |
| certifiedFactory | 认证工厂 |
| totalEpScoreLv1 | 综合体验分5星 |
| totalEpScoreLv2 | 综合体验分4星 |
| totalEpScoreLv3 | 综合体验分3星 |
| totalEpScoreLv4 | 综合体验分2星 |
| qrr0 | 无品质退款 |
| qrr1 | 品质退款率<1% |
| qrr5 | 品质退款率<5% |
| qrr10 | 品质退款率<10% |
| shipInToday | 当日发货 |
| shipIn24Hours | 24小时发货 |
| shipIn48Hours | 48小时发货 |
| noReason7DReturn | 7天无理由退货 |
| isOnePsale | 一件代发 |
| isOnePsaleFreePost | 一件代发包邮 |
| new7 | 7天内新品 |
| new30 | 30天内新品 |
| isQqyx | 全球严选 |
| JPFL | 日本专线 |
| USFL | 美国专线 |
| KRFL | 韩国专线 |
| VNFL | 越南专线 |
| SAFL | 沙特专线 |
| RUFL | 俄罗斯专线 |
| KZFL | 哈萨克斯坦专线 |
| HKFL | 香港专线 |
| MOFL | 澳门专线 |
| TWFL | 台湾专线 |

### 支持的排序字段

| 字段 | 说明 |
|------|------|
| price | 价格 |
| monthSold | 月销量 |
| rePurchaseRate | 复购率 |

排序方式：`asc`（升序）、`desc`（降序）。格式示例：`{"price":"asc"}`

### 支持的货盘ID

| ID | 说明 |
|----|------|
| 262105288 | 跨境货盘 |
| 262105286 | 跨境货盘 |
| 262105253 | 跨境货盘 |
| 262105281 | 跨境货盘 |
| 262105280 | 跨境货盘 |
| 262105277 | 跨境货盘 |
| 262105276 | 跨境货盘 |
| 262105274 | 跨境货盘 |
| 262105269 | 跨境货盘 |
| 262185282 | 跨境货盘 |

## 响应结构

| 字段 | 类型 | 说明 |
|------|------|------|
| imageId | string | 上传后的图片ID（分页查询时回传可加速） |
| total | integer | 本页商品数量 |
| totalPage | integer | 总页数 |
| sourceType | string | 来源类型（固定值 "1688"） |
| type | string | 渲染样式（固定值 "productWorkbenches"） |
| columns | array | 渲染列定义 |
| costToken | integer | 消耗 token |
| products | array | 商品列表（详见下方商品字段） |

### 商品字段

| 字段 | 类型 | 说明 |
|------|------|------|
| offerId | string | 商品ID |
| asin | string | 商品编号（同 offerId） |
| imageUrl | string | 商品图片 |
| title | string | 商品标题 |
| price | number | 批发价（元） |
| consignPrice | number | 一件代发价（元） |
| salesQuantity

references/onboarding.md

# 解决认证和算力问题

调用本 skill 时若网关返回 **auth** 或 **billing** 错误，走本 skill 自带的 `scripts/onboarding.py` 完成引导。

**auth 场景**：`errcode=401` 或消息含 `authorized error`/`鉴权失败`/`未授权`/`unauthorized`；或 `LINKFOX_AGENT_API_KEY` 与 `LINKFOXAGENT_API_KEY` 均为空。
1. 若已配置 key → 先让用户重启会话（最常见误判），仍失败让用户重新取 key 或换手机号重注册
2. 未配置 → 询问：自助去 https://agent.linkfox.com/ 取 key，或提供手机号让脚本注册
3. 手机号路径：
   - `python scripts/onboarding.py send-code <phone>` → 展示 JSON 里的 phone/agreements
   - 收到验证码后：`python scripts/onboarding.py login <phone> <code>`
   - 拿到 `api_key` 后把下面三平台配置转发给用户，提示重启会话生效：
     - Windows PowerShell（永久）：`setx LINKFOX_AGENT_API_KEY "<key>"`
     - macOS zsh：`echo 'export LINKFOX_AGENT_API_KEY="<key>"' >> ~/.zshrc && source ~/.zshrc`
     - Linux bash：`echo 'export LINKFOX_AGENT_API_KEY="<key>"' >> ~/.bashrc && source ~/.bashrc`
     - 变量名 `LINKFOX_AGENT_API_KEY`（主推）或 `LINKFOXAGENT_API_KEY`（老规范）任一即可

**billing 场景**：`errcode=402` 或消息含 `算力/余额/quota/insufficient/充值/套餐到期`。
- `python scripts/onboarding.py list-plans` → 有 AskUserQuestion 就弹菜单，否则输出编号清单让用户选
- 校验 `plan_id` ∈ 清单、支付方式 ∈ 该套餐 `available_methods`（通常 `wechat/alipay`）
- `python scripts/onboarding.py order <plan_id> <method>` → 展示优先级 PNG > `pay_url` > `ascii_qr`（标注兜底）
- 已付款可选调 `python scripts/onboarding.py query <order_id>`，不主动轮询

排除 `errcode=403`（无权限，不归入这两类）。所有子命令输出 stdout JSON，`error` 字段已含阶段前缀，透传给用户即可。完整用法：`python scripts/onboarding.py --help`。

skill-card.md

## Description:

Searches 1688 by product image to help cross-border sellers find visually similar supplier listings with prices, minimum order quantities, sales, repurchase rates, scores, and seller badges.

This skill is ready for commercial/non-commercial use.

## Publisher:

[linkfox-ai](https://clawhub.ai/user/linkfox-ai)

### License/Terms of Use:

MIT-0

## Use Case:

External users, cross-border sellers, and sourcing agents use this skill to search 1688 with a product image URL or uploaded local image, compare visually similar supplier listings, and apply supported filters or sorting during supplier discovery.

### Deployment Geography for Use:

Global

## Known Risks and Mitigations:

Risk: The skill uses LinkFox credentials for authenticated API calls and bundled account onboarding flows.

Mitigation: Install and run it only when you trust LinkFox as the service provider, keep API keys scoped to this use case, and avoid sharing SMS codes unless you initiated the login flow.

Risk: Local image inputs may be uploaded to a public URL for search.

Mitigation: Use only images that are acceptable to expose publicly for the upload validity window, and avoid confidential product images unless disclosure is approved.

Risk: Full search responses are saved locally and may include supplier, product, pricing, and query context.

Mitigation: Review the LinkFox session output directory after use and remove retained JSON files when they are no longer needed.

Risk: Searches consume LinkFox compute credits and billing flows may be triggered for insufficient balance.

Mitigation: Confirm additional searches, pagination, and recharge actions with the user before proceeding.

Risk: Custom LINKFOX_* endpoint environment variables can redirect traffic to alternate destinations.

Mitigation: Leave default endpoints in place unless the destination is explicitly trusted and reviewed.

## Reference(s):

- [ClawHub skill page](https://clawhub.ai/linkfox-ai/skills/linkfox-1688-search-by-image)
- [1688-以图搜图 API reference](artifact/references/api.md)
- [Authentication and billing onboarding](artifact/references/onboarding.md)
- [LinkFox Skills](https://skill.linkfox.com/)

## Skill Output:

**Output Type(s):** [text, markdown, JSON, shell commands, configuration, guidance]

**Output Format:** [Markdown tables or JSON summaries, with complete API responses saved as JSON files.]

**Output Parameters:** [1D]

**Other Properties Related to Output:** [The skill may upload local images to public URLs, consumes LinkFox compute credits, uses 24-hour local caching for repeated parameter sets, and persists full search responses under a LinkFox session directory.]

## Skill Version(s):

1.0.7 (source: server release evidence)

## Ethical Considerations:

Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before

Github ReposUpdated 1d agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW

Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW

Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.