{"id":"5bde7714-a286-4768-92d7-868929fead6e","entityType":"agent","slug":"clawhub-linkfox-ai-linkfox-1688-search-by-image","name":"1688-以图搜图","canonicalUrl":"https://www.xpersona.co/agent/clawhub-linkfox-ai-linkfox-1688-search-by-image","canonicalPath":"/agent/clawhub-linkfox-ai-linkfox-1688-search-by-image","generatedAt":"2026-10-11T07:42:53.980Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-11T04:31:00.889Z","emptyReason":null},"description":"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","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.2K downloads reported by the source. Last updated 10/11/2026.","installCommand":"clawhub skill install s171g8b6m2khwdy9ye8bxj0wx183vd4z:linkfox-1688-search-by-image","sourceUrl":"https://clawhub.ai/linkfox-ai/linkfox-1688-search-by-image","homepage":"https://clawhub.ai/linkfox-ai/skills/linkfox-1688-search-by-image","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/linkfox-ai/linkfox-1688-search-by-image","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/linkfox-ai/skills/linkfox-1688-search-by-image","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":61,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"1688平台以图搜图，通过商品图片精准检索外观相似或同款的1688货源，返回标题、价格、起批量、月销量、复购率、交易评分等核心数据。当用户提到1688以图搜图、1688找货源、以图找同款、跨境找工厂、1688识图、图片找货源、找相似货源、image search 1688、find supplier by image时"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-11T04:31:00.889Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T04:31:00.889Z","emptyReason":null},"stars":null,"forks":null,"downloads":1159,"packageName":null,"latestVersion":"1.0.7","tractionLabel":"1.2K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T04:31:00.874Z","emptyReason":null},"lastUpdatedAt":"2026-10-11T04:31:00.889Z","lastCrawledAt":"2026-10-11T04:31:00.874Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-12T04:31:00.874Z","lastVerifiedAt":null,"highlights":[{"version":"1.0.7","createdAt":"2026-09-14T04:52:26.162Z","changelog":"Update from 1.0.6 to 1.0.7","fileCount":8,"zipByteSize":27450},{"version":"1.0.6","createdAt":"2026-08-14T14:39:00.851Z","changelog":"Update from 1.0.5 to 1.0.6","fileCount":8,"zipByteSize":27313},{"version":"1.0.5","createdAt":"2026-08-07T10:34:35.918Z","changelog":"Update from 1.0.4 to 1.0.5","fileCount":8,"zipByteSize":27383},{"version":"1.0.4","createdAt":"2026-07-13T12:00:51.857Z","changelog":"Update from 1.0.3 to 1.0.4","fileCount":6,"zipByteSize":18311},{"version":"1.0.3","createdAt":"2026-07-06T11:06:45.427Z","changelog":"Update from 1.0.2 to 1.0.3","fileCount":5,"zipByteSize":16290},{"version":"1.0.2","createdAt":"2026-07-03T08:06:10.267Z","changelog":"Update from 1.0.1 to 1.0.2","fileCount":5,"zipByteSize":16291},{"version":"1.0.1","createdAt":"2026-07-03T04:32:32.363Z","changelog":"Update from 1.0.0 to 1.0.1","fileCount":5,"zipByteSize":16255},{"version":"1.0.0","createdAt":"2026-06-12T11:54:27.213Z","changelog":"Initial release","fileCount":7,"zipByteSize":20008}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s171g8b6m2khwdy9ye8bxj0wx183vd4z:linkfox-1688-search-by-image","setupComplexity":"low","setupSteps":["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":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-1688-search-by-image/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-1688-search-by-image/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-1688-search-by-image/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-1688-search-by-image/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-1688-search-by-image/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-1688-search-by-image/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-11T07:42:53.976Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-1688-search-by-image/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-1688-search-by-image/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-1688-search-by-image/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-1688-search-by-image/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-11T04:31:00.889Z","emptyReason":null},"readme":"Skill: 1688-以图搜图\n\nOwner: linkfox-ai\n\nSummary: 1688平台以图搜图，通过商品图片精准检索外观相似或同款的1688货源，返回标题、价格、起批量、月销量、复购率、交易评分等核心数据。当用户提到1688以图搜图、1688找货源、以图找同款、跨境找工厂、1688识图、图片找货源、找相似货源、image search 1688、find supplier by image时触发此技能。即使用户未明确提及\"以图搜图\"，只要用户提供了图片URL并希望在1688上查找匹配或相似的货源商品，也应触发此技能。\n\nTags: latest:1.0.7\n\nVersion history:\n\nv1.0.7 | 2026-09-14T04:52:26.162Z | user\n\nUpdate from 1.0.6 to 1.0.7\n\nv1.0.6 | 2026-08-14T14:39:00.851Z | user\n\nUpdate from 1.0.5 to 1.0.6\n\nv1.0.5 | 2026-08-07T10:34:35.918Z | user\n\nUpdate from 1.0.4 to 1.0.5\n\nv1.0.4 | 2026-07-13T12:00:51.857Z | user\n\nUpdate from 1.0.3 to 1.0.4\n\nv1.0.3 | 2026-07-06T11:06:45.427Z | user\n\nUpdate from 1.0.2 to 1.0.3\n\nv1.0.2 | 2026-07-03T08:06:10.267Z | user\n\nUpdate from 1.0.1 to 1.0.2\n\nv1.0.1 | 2026-07-03T04:32:32.363Z | user\n\nUpdate from 1.0.0 to 1.0.1\n\nv1.0.0 | 2026-06-12T11:54:27.213Z | user\n\nInitial release\n\nArchive index:\n\nArchive v1.0.7: 8 files, 27450 bytes\n\nFiles: references/api.md (8787b), references/onboarding.md (1999b), scripts/alibaba1688_image_search.py (12781b), scripts/onboarding.py (24027b), scripts/upload_image.py (4822b), skill-card.md (3021b), SKILL.md (11951b), _meta.json (147b)\n\nFile v1.0.7:SKILL.md\n\n---\nname: linkfox-1688-search-by-image\ndescription: 1688平台以图搜图，通过商品图片精准检索外观相似或同款的1688货源，返回标题、价格、起批量、月销量、复购率、交易评分等核心数据。当用户提到1688以图搜图、1688找货源、以图找同款、跨境找工厂、1688识图、图片找货源、找相似货源、image search 1688、find supplier by image时触发此技能。即使用户未明确提及\"以图搜图\"，只要用户提供了图片URL并希望在1688上查找匹配或相似的货源商品，也应触发此技能。\n---\n\n# 1688 Image-Based Product Search\n\nThis skill performs visual product searches on the 1688 platform using an image URL, helping cross-border sellers find visually similar supplier products for sourcing.\n\n## Core Concepts\n\n1688 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.\n\n## Data Fields\n\n| Field | Description |\n|-------|-------------|\n| offerId | Product ID on 1688 |\n| title | Product title |\n| imageUrl | Product main image |\n| price | Wholesale price (CNY) |\n| consignPrice | Dropship price (CNY) |\n| salesQuantity | Monthly sales volume |\n| estimatedSalesAmount | Estimated monthly revenue |\n| quantityBegin | Minimum order quantity |\n| repurchaseRate | Repurchase rate |\n| tradeScore | Product trade score |\n| compositeServiceScore | Composite service experience score |\n| sellerIdentities | Seller identity (超级工厂/实力商家/诚信通会员) |\n| offerIdentities | Product badge (严选) |\n| sendGoodsAddressText | Shipping origin |\n| deliveryTime | Delivery time (24/48 hours) |\n| isOnePsale | Supports dropshipping (是/否) |\n| isJxhy | Premium sourcing (是/否) |\n| hasPromotion | Has promotion (是/否) |\n| isPatentProduct | Patent product (是/否) |\n\n## Parameter Guide\n\n**Image Rules:**\n1. Only png, jpg, jpeg formats are supported. webp, gif, and other formats are NOT supported.\n2. Base64 string must be pure encoded content WITHOUT the `data:image/jpeg;base64,` prefix.\n3. Image source — one of imageUrl, imageBase64, or imageId must be provided (at least one required).\n\n| Parameter | Required | Default | Description |\n|-----------|----------|---------|-------------|\n| imageUrl | Conditional | - | Public image URL (max 1000 chars). Only png/jpg/jpeg formats supported |\n| imageBase64 | Conditional | - | Pure Base64 encoded image string, without `data:image/...;base64,` prefix. Only png/jpg/jpeg supported |\n| imageId | Conditional | - | 1688 image ID from previous search result (speeds up pagination) |\n| page | No | 1 | Page number, starting from 1 |\n| pageSize | No | 20 | Results per page (1-50) |\n| priceStart | No | - | Min price filter (CNY) |\n| priceEnd | No | - | Max price filter (CNY) |\n| filter | No | - | Filter conditions, comma-separated (see supported filters below) |\n| sort | No | {\"monthSold\":\"desc\"} | Sort as JSON: {field: direction} (see supported sort fields below) |\n| keyword | No | - | Keyword to further filter results |\n| productCollectionId | No | - | Product collection ID (see supported IDs below) |\n\n### Supported Filters\n\nMultiple filters can be combined with commas (e.g. `1688Selection,totalEpScoreLv1,qrr0`).\n\n| Filter Value | Description |\n|--------------|-------------|\n| 1688Selection | 1688严选 |\n| certifiedFactory | 认证工厂 |\n| totalEpScoreLv1 | 综合体验分5星 |\n| totalEpScoreLv2 | 综合体验分4星 |\n| totalEpScoreLv3 | 综合体验分3星 |\n| totalEpScoreLv4 | 综合体验分2星 |\n| qrr0 | 无品质退款 |\n| qrr1 | 品质退款率<1% |\n| qrr5 | 品质退款率<5% |\n| qrr10 | 品质退款率<10% |\n| shipInToday | 当日发货 |\n| shipIn24Hours | 24小时发货 |\n| shipIn48Hours | 48小时发货 |\n| noReason7DReturn | 7天无理由退货 |\n| isOnePsale | 一件代发 |\n| isOnePsaleFreePost | 一件代发包邮 |\n| new7 | 7天内新品 |\n| new30 | 30天内新品 |\n| isQqyx | 全球严选 |\n| JPFL | 日本专线 |\n| USFL | 美国专线 |\n| KRFL | 韩国专线 |\n| VNFL | 越南专线 |\n| SAFL | 沙特专线 |\n| RUFL | 俄罗斯专线 |\n| KZFL | 哈萨克斯坦专线 |\n| HKFL | 香港专线 |\n| MOFL | 澳门专线 |\n| TWFL | 台湾专线 |\n\n### Supported Sort Fields\n\n| Field | Direction | Description |\n|-------|-----------|-------------|\n| price | asc/desc | Price ascending/descending |\n| monthSold | asc/desc | Monthly sales ascending/descending |\n| rePurchaseRate | asc/desc | Repurchase rate ascending/descending |\n\nSort format example: `{\"price\":\"asc\"}` for price low to high.\n\n### Supported Product Collection IDs\n\n| ID | Usage |\n|----|-------|\n| 262105288 | 跨境货盘 |\n| 262105286 | 跨境货盘 |\n| 262105253 | 跨境货盘 |\n| 262105281 | 跨境货盘 |\n| 262105280 | 跨境货盘 |\n| 262105277 | 跨境货盘 |\n| 262105276 | 跨境货盘 |\n| 262105274 | 跨境货盘 |\n| 262105269 | 跨境货盘 |\n| 262185282 | 跨境货盘 |\n\n## 调用方式\n\n- **API 端点**：`POST /alibaba1688/imageSearch`（完整参数/响应/错误码见 `references/api.md`）\n- **Python 脚本**：`python scripts/alibaba1688_image_search.py '<JSON 参数>' [--inline]`\n- **成本约束**：本工具会消耗算力；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。\n\n**输出策略（脚本默认行为）**：\n- **始终**将完整响应写入 `<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-1688-search-by-image-<timestamp>.json`（`<cwd>` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`<session>` 取自环境变量 `SESSION_ID`，按用户任务自动聚合；**禁止写入 /tmp**，当前目录不可写则报错）\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段的长度 + 前 3 条样本）\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\n\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq`或`ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\n\n## 解决认证和算力问题\n发生以下异常情况时，采用 references/onboarding.md 引导解决问题：\n\n### 异常情况\n- **未配置API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\n- **响应401或402状态码**\n- **响应提示算力或余额不足**：消息含\"算力余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值\"，或类似含义的内容。\n\n## Local Image Upload\n\nThis tool requires a **publicly accessible image URL**. If the user provides a local image file path, you must upload it first to obtain a public URL.\n\nRun the upload script:\n```bash\npython scripts/upload_image.py /path/to/local/image.png\n```\n\nThe script will return a public URL (valid for 24 hours) that can be used as the imageUrl parameter.\n\n## Usage Examples\n\n**1. Basic image search**\n```\n在1688搜索与图片相似的商品，图片地址为 https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg\n```\n\n**2. Search with filters**\n```\n在1688搜索与图片相似的商品，图片地址为 https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg，查询第1页，筛选1688严选，并按价格从高到低排序\n```\n\n**3. Search with sorting**\n```\n在1688搜索与图片相似的商品，图片地址为 https://example.com/product.jpg，按价格从高到低排序\n```\n\n**4. Paginated search**\n```\n在1688搜索与图片相似的商品，图片地址为 https://example.com/product.jpg，查询第2页，每页50条\n```\n\n**5. Price range filter**\n```\n在1688搜索与图片相似的商品，图片地址为 https://example.com/product.jpg，价格区间10-100元\n```\n\n## Display Rules\n\n1. **Present data clearly**: Show results in a structured table with key columns: product image, title, price, dropship price, monthly sales, minimum order quantity, repurchase rate, and seller identity\n2. **Image display**: When the response includes imageUrl for products, display them inline for visual comparison\n3. **Price display**: Always show price in CNY (¥) format\n4. **Seller badges**: Display seller identity badges (超级工厂/实力商家/诚信通会员) and product badges (严选) prominently\n5. **Result count**: Always inform the user of total results and current page/total pages\n6. **Pagination hint**: When more pages are available, suggest the user can request the next page\n7. **Filter/sort limitation**: If the user requests a sort or filter not in the supported list, do NOT attempt any workaround. Inform the user of the supported options\n8. **No secondary processing**: Results are real-time and not stored in a database, so secondary SQL/data processing is not available\n\n## Important Limitations\n\n1. **Data real-time nature**: Results are live searches, not stored in any database. Cannot use `_dataQuery_executeDynamicQuery` for secondary processing.\n2. **Logic constraint**: If the user requests sort or filter conditions not in the preset supported list, do NOT call any other tool or logic to compensate.\n3. **Image input**: One of imageUrl, imageBase64, or imageId is required. For page > 1, prefer passing imageId from the first page result to speed up queries.\n4. **Image format**: Only png, jpg, jpeg are supported. webp, gif, and other formats will be rejected.\n5. **Base64 format**: The imageBase64 value must be the raw Base64 string only — do NOT include the `data:image/jpeg;base64,` prefix.\n6. **Page size**: Maximum 50 results per page.\n\n## User Expression & Scenario Quick Reference\n\n**Applicable** -- Visual product sourcing scenarios on 1688:\n\n| User Says | Scenario |\n|-----------|----------|\n| \"1688以图搜图\" / \"用图片找1688货源\" | Basic image search |\n| \"帮我在1688找这个图片的同款\" | Find same-style products |\n| \"跨境找工厂，图片是...\" | Cross-border supplier sourcing |\n| \"这个Amazon产品在1688有没有货源\" | Reverse sourcing from Amazon image |\n| \"筛选1688严选的相似商品\" | Filtered image search |\n| \"按月销量排序找相似货源\" | Sorted image search |\n| \"查看第2页结果\" | Pagination |\n\n**Not applicable** -- Needs beyond 1688 image search:\n\n- Text/keyword-based 1688 search (use 店雷达-1688选品库)\n- 1688 product rankings/trending (use 店雷达-1688商品榜单)\n- Amazon image search (use 亚马逊前端-以图搜图)\n- Image generation or editing\n- Product review analysis\n- Price history or trend analysis\n\n**Boundary judgment**: When users say \"找货源\" or \"找同款\", if they provide an image URL and the intent is to find visually similar products on 1688, this skill applies. If they want keyword-based search or ranking data on 1688, use the 店雷达 tools instead.\n\n## 算力消耗规则\n\n消耗 5 算力。\n\n> 用户会因算力消耗而支付费用。请充分评估：当需要高频调用本技能，或用户对算力消耗量预期不足时，务必提醒用户，由用户决定是否继续。\n\n**Feedback:**\n\nAuto-detect and report feedback via the Feedback API when any of the following apply:\n1. The functionality or purpose described in this skill does not match actual behavior\n2. The skill's results do not match the user's intent\n3. The user expresses dissatisfaction or praise about this skill\n4. Anything you believe could be improved\n\nCall the feedback API as specified in `references/api.md`. Do not interrupt the user's flow.\n\n---\n*For more high-quality, professional cross-border e-commerce skills, visit [LinkFox Skills](https://skill.linkfox.com/).*\n\nFile v1.0.7:_meta.json\n\n{\n  \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n  \"slug\": \"linkfox-1688-search-by-image\",\n  \"version\": \"1.0.7\",\n  \"publishedAt\": 1789361546162\n}\n\nFile v1.0.7:references/api.md\n\n# 1688-以图搜图 API 参考\n\n## 调用规范\n\n- **请求地址**：`${LINKFOX_TOOL_GATEWAY}/alibaba1688/imageSearch`\n- **请求方式**：POST，Content-Type: application/json\n- **认证方式**：Header `Authorization: <api_key>`，api_key 优先从环境变量 `LINKFOX_AGENT_API_KEY` 读取，回退 `LINKFOXAGENT_API_KEY`（如未配置 按 SKILL.md 的 **## 解决认证和算力问题** 处理）\n- **User-Agent**：`LinkFox-Skill/1.0`\n- **超时**：150s\n\n## 请求参数\n\nPOST Body（JSON）：\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| imageUrl | string | 条件必填 | - | 图片URL地址，请确保图片URL有效且可公开访问。最大长度：1000。仅支持 png/jpg/jpeg 格式，不支持 webp/gif 等。imageUrl/imageBase64/imageId 三选一必填 |\n| imageBase64 | string | 条件必填 | - | 图片 Base64 编码字符串，为纯编码内容，不包含 `data:image/jpeg;base64,` 前缀。仅支持 png/jpg/jpeg 格式（imageUrl为空时使用） |\n| imageId | string | 条件必填 | - | 图片ID（1688图片ID），以图搜图查询结果中也会返回，建议当分页 page>1 查询时带 imageId，加快响应速度 |\n| page | int | 否 | 1 | 页码，从1开始 |\n| pageSize | int | 否 | 20 | 每页返回的商品数量，最大不超过50 |\n| priceStart | string | 否 | - | 价格筛选起始值（人民币），如 10 |\n| priceEnd | string | 否 | - | 价格筛选结束值（人民币），如 100 |\n| filter | string | 否 | - | 过滤条件，多个条件用逗号分隔。有效值见下方「支持的过滤条件」 |\n| sort | string | 否 | {\"monthSold\":\"desc\"} | 排序条件，JSON格式 {排序字段: 排序方式}。有效字段：price、rePurchaseRate、monthSold；方式：asc/desc |\n| keyword | string | 否 | - | 关键词，在结果中搜索 |\n| productCollectionId | string | 否 | - | 货盘ID，单选。有效值见下方「支持的货盘ID」 |\n\n### 支持的过滤条件\n\n多个条件用逗号分隔，如 `1688Selection,totalEpScoreLv1,qrr0`。\n\n| 值 | 说明 |\n|----|------|\n| 1688Selection | 1688严选 |\n| certifiedFactory | 认证工厂 |\n| totalEpScoreLv1 | 综合体验分5星 |\n| totalEpScoreLv2 | 综合体验分4星 |\n| totalEpScoreLv3 | 综合体验分3星 |\n| totalEpScoreLv4 | 综合体验分2星 |\n| qrr0 | 无品质退款 |\n| qrr1 | 品质退款率<1% |\n| qrr5 | 品质退款率<5% |\n| qrr10 | 品质退款率<10% |\n| shipInToday | 当日发货 |\n| shipIn24Hours | 24小时发货 |\n| shipIn48Hours | 48小时发货 |\n| noReason7DReturn | 7天无理由退货 |\n| isOnePsale | 一件代发 |\n| isOnePsaleFreePost | 一件代发包邮 |\n| new7 | 7天内新品 |\n| new30 | 30天内新品 |\n| isQqyx | 全球严选 |\n| JPFL | 日本专线 |\n| USFL | 美国专线 |\n| KRFL | 韩国专线 |\n| VNFL | 越南专线 |\n| SAFL | 沙特专线 |\n| RUFL | 俄罗斯专线 |\n| KZFL | 哈萨克斯坦专线 |\n| HKFL | 香港专线 |\n| MOFL | 澳门专线 |\n| TWFL | 台湾专线 |\n\n### 支持的排序字段\n\n| 字段 | 说明 |\n|------|------|\n| price | 价格 |\n| monthSold | 月销量 |\n| rePurchaseRate | 复购率 |\n\n排序方式：`asc`（升序）、`desc`（降序）。格式示例：`{\"price\":\"asc\"}`\n\n### 支持的货盘ID\n\n| ID | 说明 |\n|----|------|\n| 262105288 | 跨境货盘 |\n| 262105286 | 跨境货盘 |\n| 262105253 | 跨境货盘 |\n| 262105281 | 跨境货盘 |\n| 262105280 | 跨境货盘 |\n| 262105277 | 跨境货盘 |\n| 262105276 | 跨境货盘 |\n| 262105274 | 跨境货盘 |\n| 262105269 | 跨境货盘 |\n| 262185282 | 跨境货盘 |\n\n## 响应结构\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| imageId | string | 上传后的图片ID（分页查询时回传可加速） |\n| total | integer | 本页商品数量 |\n| totalPage | integer | 总页数 |\n| sourceType | string | 来源类型（固定值 \"1688\"） |\n| type | string | 渲染样式（固定值 \"productWorkbenches\"） |\n| columns | array | 渲染列定义 |\n| costToken | integer | 消耗 token |\n| products | array | 商品列表（详见下方商品字段） |\n\n### 商品字段\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| offerId | string | 商品ID |\n| asin | string | 商品编号（同 offerId） |\n| imageUrl | string | 商品图片 |\n| title | string | 商品标题 |\n| price | number | 批发价（元） |\n| consignPrice | number | 一件代发价（元） |\n| salesQuantity | integer | 月销售件数 |\n| estimatedSalesAmount | number | 预估销售额 |\n| asinUrl | string | 商品链接 |\n| isOnePsale | string | 是否一件代发（是/否） |\n| isJxhy | string | 是否精选货源（是/否） |\n| sellerIdentities | string | 商家身份（超级工厂/实力商家/诚信通会员） |\n| offerIdentities | string | 商品标（严选） |\n| repurchaseRate | string | 复购率 |\n| tradeScore | string | 商品交易评分 |\n| compositeServiceScore | string | 综合服务体验分 |\n| sendGoodsAddressText | string | 发货地 |\n| deliveryTime | string | 发货时间（24/48小时） |\n| quantityBegin | integer | 起批量 |\n| hasPromotion | string | 是否有营销活动（是/否） |\n| promotionType | string | 营销类型 |\n| isPatentProduct | string | 是否专利商品（是/否） |\n| isSelect | string | 跨境select货盘标识 |\n| currency | string | 币种（固定值 \"¥\"） |\n| sourceType | string | 来源类型（固定值 \"1688\"） |\n| sourceTool | string | 来源工具（固定值 \"1688以图搜图\"） |\n| dataType | string | 数据类型（固定值 \"monthlyData\"） |\n\n## 错误码\n\n正常情况下，接口的 HTTP 状态码均为 200，业务的成功与否通过响应体中的 errorCode 字段区分（errorCode = 200 表示成功，其他值表示业务错误）。当遇到未授权等情况时，HTTP 状态码为 401，且对应的 errorCode 也是 401。\n\n| errcode | 含义 | 处理建议 |\n|---------|------|----------|\n| 200 | 成功 | 正常解析业务字段 |\n| 401 | 认证失败 | HTTP 401 或 authorized error：按 SKILL.md 的 **## 解决认证和算力问题** 处理。 |\n| 402 | 算力不足 | HTTP 402：按 SKILL.md 的 **## 解决认证和算力问题** 处理。 |\n| 其他非200值 | 业务异常 | 参考 `errmsg` 字段获取具体错误原因 |\n\n错误响应示例：\n\n```json\n{\n    \"errcode\": 401,\n    \"errmsg\": \"authorized error\"\n}\n```\n\n## curl 示例\n\n### 基础以图搜图\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/alibaba1688/imageSearch \\\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"User-Agent: LinkFox-Skill/1.0\" \\\n  -d '{\n    \"imageUrl\": \"https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg\",\n    \"page\": 1,\n    \"pageSize\": 20\n  }'\n```\n\n### 带筛选和排序\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/alibaba1688/imageSearch \\\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"User-Agent: LinkFox-Skill/1.0\" \\\n  -d '{\n    \"imageUrl\": \"https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg\",\n    \"page\": 1,\n    \"pageSize\": 20,\n    \"filter\": \"1688Selection,totalEpScoreLv1,qrr0\",\n    \"sort\": \"{\\\"price\\\":\\\"desc\\\"}\"\n  }'\n```\n\n### 分页查询（使用 imageId）\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/alibaba1688/imageSearch \\\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"User-Agent: LinkFox-Skill/1.0\" \\\n  -d '{\n    \"imageId\": \"abc123456\",\n    \"page\": 2,\n    \"pageSize\": 20\n  }'\n```\n\n### 价格区间筛选\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/alibaba1688/imageSearch \\\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"User-Agent: LinkFox-Skill/1.0\" \\\n  -d '{\n    \"imageUrl\": \"https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg\",\n    \"page\": 1,\n    \"pageSize\": 20,\n    \"priceStart\": \"10\",\n    \"priceEnd\": \"100\"\n  }'\n```\n\n---\n\n## Feedback API\n\n> This endpoint is **separate** from the tool API above. Do not mix the two base URLs.\n\n- **POST** `https://skill-api.linkfox.com/api/v1/public/feedback`\n- **Content-Type:** `application/json`\n\n```json\n{\n  \"skillName\": \"linkfox-1688-search-by-image\",\n  \"sentiment\": \"POSITIVE\",\n  \"category\": \"OTHER\",\n  \"content\": \"Results were accurate, user was satisfied.\"\n}\n```\n\n**Field rules:**\n- `skillName`: Use this skill's `name` from the YAML frontmatter (`linkfox-1688-search-by-image`)\n- `sentiment`: Choose ONE — `POSITIVE` (praise), `NEUTRAL` (suggestion without emotion), `NEGATIVE` (complaint or error)\n- `category`: Choose ONE — `BUG` (malfunction or wrong data), `COMPLAINT` (user dissatisfaction), `SUGGESTION` (improvement idea), `OTHER`\n- `content`: Include what the user said or intended, what actually happened, and why it is a problem or praise\n\nFile v1.0.7:references/onboarding.md\n\n# 解决认证和算力问题\n\n调用本 skill 时若网关返回 **auth** 或 **billing** 错误，走本 skill 自带的 `scripts/onboarding.py` 完成引导。\n\n**auth 场景**：`errcode=401` 或消息含 `authorized error`/`鉴权失败`/`未授权`/`unauthorized`；或 `LINKFOX_AGENT_API_KEY` 与 `LINKFOXAGENT_API_KEY` 均为空。\n1. 若已配置 key → 先让用户重启会话（最常见误判），仍失败让用户重新取 key 或换手机号重注册\n2. 未配置 → 询问：自助去 https://agent.linkfox.com/ 取 key，或提供手机号让脚本注册\n3. 手机号路径：\n   - `python scripts/onboarding.py send-code <phone>` → 展示 JSON 里的 phone/agreements\n   - 收到验证码后：`python scripts/onboarding.py login <phone> <code>`\n   - 拿到 `api_key` 后把下面三平台配置转发给用户，提示重启会话生效：\n     - Windows PowerShell（永久）：`setx LINKFOX_AGENT_API_KEY \"<key>\"`\n     - macOS zsh：`echo 'export LINKFOX_AGENT_API_KEY=\"<key>\"' >> ~/.zshrc && source ~/.zshrc`\n     - Linux bash：`echo 'export LINKFOX_AGENT_API_KEY=\"<key>\"' >> ~/.bashrc && source ~/.bashrc`\n     - 变量名 `LINKFOX_AGENT_API_KEY`（主推）或 `LINKFOXAGENT_API_KEY`（老规范）任一即可\n\n**billing 场景**：`errcode=402` 或消息含 `算力/余额/quota/insufficient/充值/套餐到期`。\n- `python scripts/onboarding.py list-plans` → 有 AskUserQuestion 就弹菜单，否则输出编号清单让用户选\n- 校验 `plan_id` ∈ 清单、支付方式 ∈ 该套餐 `available_methods`（通常 `wechat/alipay`）\n- `python scripts/onboarding.py order <plan_id> <method>` → 展示优先级 PNG > `pay_url` > `ascii_qr`（标注兜底）\n- 已付款可选调 `python scripts/onboarding.py query <order_id>`，不主动轮询\n\n排除 `errcode=403`（无权限，不归入这两类）。所有子命令输出 stdout JSON，`error` 字段已含阶段前缀，透传给用户即可。完整用法：`python scripts/onboarding.py --help`。\n\nFile v1.0.7:skill-card.md\n\n## Description:\n\nSearches 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.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[linkfox-ai](https://clawhub.ai/user/linkfox-ai)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal 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.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill uses LinkFox credentials for authenticated API calls and bundled account onboarding flows.\n\nMitigation: 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.\n\nRisk: Local image inputs may be uploaded to a public URL for search.\n\nMitigation: Use only images that are acceptable to expose publicly for the upload validity window, and avoid confidential product images unless disclosure is approved.\n\nRisk: Full search responses are saved locally and may include supplier, product, pricing, and query context.\n\nMitigation: Review the LinkFox session output directory after use and remove retained JSON files when they are no longer needed.\n\nRisk: Searches consume LinkFox compute credits and billing flows may be triggered for insufficient balance.\n\nMitigation: Confirm additional searches, pagination, and recharge actions with the user before proceeding.\n\nRisk: Custom LINKFOX_* endpoint environment variables can redirect traffic to alternate destinations.\n\nMitigation: Leave default endpoints in place unless the destination is explicitly trusted and reviewed.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/linkfox-ai/skills/linkfox-1688-search-by-image)\n- [1688-以图搜图 API reference](artifact/references/api.md)\n- [Authentication and billing onboarding](artifact/references/onboarding.md)\n- [LinkFox Skills](https://skill.linkfox.com/)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, JSON, shell commands, configuration, guidance]\n\n**Output Format:** [Markdown tables or JSON summaries, with complete API responses saved as JSON files.]\n\n**Output Parameters:** [1D]\n\n**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.]\n\n## Skill Version(s):\n\n1.0.7 (source: server release evidence)\n\n## Ethical Considerations:\n\nUsers 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 deployment.\n\nArchive v1.0.6: 8 files, 27313 bytes\n\nFiles: references/api.md (8787b), references/onboarding.md (2046b), scripts/alibaba1688_image_search.py (12725b), scripts/onboarding.py (24089b), scripts/upload_image.py (4592b), skill-card.md (2751b), SKILL.md (11951b), _meta.json (147b)\n\nFile v1.0.6:SKILL.md\n\n---\nname: linkfox-1688-search-by-image\ndescription: 1688平台以图搜图，通过商品图片精准检索外观相似或同款的1688货源，返回标题、价格、起批量、月销量、复购率、交易评分等核心数据。当用户提到1688以图搜图、1688找货源、以图找同款、跨境找工厂、1688识图、图片找货源、找相似货源、image search 1688、find supplier by image时触发此技能。即使用户未明确提及\"以图搜图\"，只要用户提供了图片URL并希望在1688上查找匹配或相似的货源商品，也应触发此技能。\n---\n\n# 1688 Image-Based Product Search\n\nThis skill performs visual product searches on the 1688 platform using an image URL, helping cross-border sellers find visually similar supplier products for sourcing.\n\n## Core Concepts\n\n1688 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.\n\n## Data Fields\n\n| Field | Description |\n|-------|-------------|\n| offerId | Product ID on 1688 |\n| title | Product title |\n| imageUrl | Product main image |\n| price | Wholesale price (CNY) |\n| consignPrice | Dropship price (CNY) |\n| salesQuantity | Monthly sales volume |\n| estimatedSalesAmount | Estimated monthly revenue |\n| quantityBegin | Minimum order quantity |\n| repurchaseRate | Repurchase rate |\n| tradeScore | Product trade score |\n| compositeServiceScore | Composite service experience score |\n| sellerIdentities | Seller identity (超级工厂/实力商家/诚信通会员) |\n| offerIdentities | Product badge (严选) |\n| sendGoodsAddressText | Shipping origin |\n| deliveryTime | Delivery time (24/48 hours) |\n| isOnePsale | Supports dropshipping (是/否) |\n| isJxhy | Premium sourcing (是/否) |\n| hasPromotion | Has promotion (是/否) |\n| isPatentProduct | Patent product (是/否) |\n\n## Parameter Guide\n\n**Image Rules:**\n1. Only png, jpg, jpeg formats are supported. webp, gif, and other formats are NOT supported.\n2. Base64 string must be pure encoded content WITHOUT the `data:image/jpeg;base64,` prefix.\n3. Image source — one of imageUrl, imageBase64, or imageId must be provided (at least one required).\n\n| Parameter | Required | Default | Description |\n|-----------|----------|---------|-------------|\n| imageUrl | Conditional | - | Public image URL (max 1000 chars). Only png/jpg/jpeg formats supported |\n| imageBase64 | Conditional | - | Pure Base64 encoded image string, without `data:image/...;base64,` prefix. Only png/jpg/jpeg supported |\n| imageId | Conditional | - | 1688 image ID from previous search result (speeds up pagination) |\n| page | No | 1 | Page number, starting from 1 |\n| pageSize | No | 20 | Results per page (1-50) |\n| priceStart | No | - | Min price filter (CNY) |\n| priceEnd | No | - | Max price filter (CNY) |\n| filter | No | - | Filter conditions, comma-separated (see supported filters below) |\n| sort | No | {\"monthSold\":\"desc\"} | Sort as JSON: {field: direction} (see supported sort fields below) |\n| keyword | No | - | Keyword to further filter results |\n| productCollectionId | No | - | Product collection ID (see supported IDs below) |\n\n### Supported Filters\n\nMultiple filters can be combined with commas (e.g. `1688Selection,totalEpScoreLv1,qrr0`).\n\n| Filter Value | Description |\n|--------------|-------------|\n| 1688Selection | 1688严选 |\n| certifiedFactory | 认证工厂 |\n| totalEpScoreLv1 | 综合体验分5星 |\n| totalEpScoreLv2 | 综合体验分4星 |\n| totalEpScoreLv3 | 综合体验分3星 |\n| totalEpScoreLv4 | 综合体验分2星 |\n| qrr0 | 无品质退款 |\n| qrr1 | 品质退款率<1% |\n| qrr5 | 品质退款率<5% |\n| qrr10 | 品质退款率<10% |\n| shipInToday | 当日发货 |\n| shipIn24Hours | 24小时发货 |\n| shipIn48Hours | 48小时发货 |\n| noReason7DReturn | 7天无理由退货 |\n| isOnePsale | 一件代发 |\n| isOnePsaleFreePost | 一件代发包邮 |\n| new7 | 7天内新品 |\n| new30 | 30天内新品 |\n| isQqyx | 全球严选 |\n| JPFL | 日本专线 |\n| USFL | 美国专线 |\n| KRFL | 韩国专线 |\n| VNFL | 越南专线 |\n| SAFL | 沙特专线 |\n| RUFL | 俄罗斯专线 |\n| KZFL | 哈萨克斯坦专线 |\n| HKFL | 香港专线 |\n| MOFL | 澳门专线 |\n| TWFL | 台湾专线 |\n\n### Supported Sort Fields\n\n| Field | Direction | Description |\n|-------|-----------|-------------|\n| price | asc/desc | Price ascending/descending |\n| monthSold | asc/desc | Monthly sales ascending/descending |\n| rePurchaseRate | asc/desc | Repurchase rate ascending/descending |\n\nSort format example: `{\"price\":\"asc\"}` for price low to high.\n\n### Supported Product Collection IDs\n\n| ID | Usage |\n|----|-------|\n| 262105288 | 跨境货盘 |\n| 262105286 | 跨境货盘 |\n| 262105253 | 跨境货盘 |\n| 262105281 | 跨境货盘 |\n| 262105280 | 跨境货盘 |\n| 262105277 | 跨境货盘 |\n| 262105276 | 跨境货盘 |\n| 262105274 | 跨境货盘 |\n| 262105269 | 跨境货盘 |\n| 262185282 | 跨境货盘 |\n\n## 调用方式\n\n- **API 端点**：`POST /alibaba1688/imageSearch`（完整参数/响应/错误码见 `references/api.md`）\n- **Python 脚本**：`python scripts/alibaba1688_image_search.py '<JSON 参数>' [--inline]`\n- **成本约束**：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。\n\n**输出策略（脚本默认行为）**：\n- **始终**将完整响应写入 `<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-1688-search-by-image-<timestamp>.json`（`<cwd>` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`<session>` 取自环境变量 `SESSION_ID`，按用户任务自动聚合；**禁止写入 /tmp**，当前目录不可写则报错）\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段的长度 + 前 3 条样本）\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\n\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq`或`ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\n\n## 解决认证和积分问题\n发生以下异常情况时，采用 references/onboarding.md 引导解决问题：\n\n### 异常情况\n- **未配置API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\n- **响应401或402状态码**\n- **响应提示积分或余额不足**：消息含\"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值\"，或类似含义的内容。\n\n## Local Image Upload\n\nThis tool requires a **publicly accessible image URL**. If the user provides a local image file path, you must upload it first to obtain a public URL.\n\nRun the upload script:\n```bash\npython scripts/upload_image.py /path/to/local/image.png\n```\n\nThe script will return a public URL (valid for 24 hours) that can be used as the imageUrl parameter.\n\n## Usage Examples\n\n**1. Basic image search**\n```\n在1688搜索与图片相似的商品，图片地址为 https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg\n```\n\n**2. Search with filters**\n```\n在1688搜索与图片相似的商品，图片地址为 https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg，查询第1页，筛选1688严选，并按价格从高到低排序\n```\n\n**3. Search with sorting**\n```\n在1688搜索与图片相似的商品，图片地址为 https://example.com/product.jpg，按价格从高到低排序\n```\n\n**4. Paginated search**\n```\n在1688搜索与图片相似的商品，图片地址为 https://example.com/product.jpg，查询第2页，每页50条\n```\n\n**5. Price range filter**\n```\n在1688搜索与图片相似的商品，图片地址为 https://example.com/product.jpg，价格区间10-100元\n```\n\n## Display Rules\n\n1. **Present data clearly**: Show results in a structured table with key columns: product image, title, price, dropship price, monthly sales, minimum order quantity, repurchase rate, and seller identity\n2. **Image display**: When the response includes imageUrl for products, display them inline for visual comparison\n3. **Price display**: Always show price in CNY (¥) format\n4. **Seller badges**: Display seller identity badges (超级工厂/实力商家/诚信通会员) and product badges (严选) prominently\n5. **Result count**: Always inform the user of total results and current page/total pages\n6. **Pagination hint**: When more pages are available, suggest the user can request the next page\n7. **Filter/sort limitation**: If the user requests a sort or filter not in the supported list, do NOT attempt any workaround. Inform the user of the supported options\n8. **No secondary processing**: Results are real-time and not stored in a database, so secondary SQL/data processing is not available\n\n## Important Limitations\n\n1. **Data real-time nature**: Results are live searches, not stored in any database. Cannot use `_dataQuery_executeDynamicQuery` for secondary processing.\n2. **Logic constraint**: If the user requests sort or filter conditions not in the preset supported list, do NOT call any other tool or logic to compensate.\n3. **Image input**: One of imageUrl, imageBase64, or imageId is required. For page > 1, prefer passing imageId from the first page result to speed up queries.\n4. **Image format**: Only png, jpg, jpeg are supported. webp, gif, and other formats will be rejected.\n5. **Base64 format**: The imageBase64 value must be the raw Base64 string only — do NOT include the `data:image/jpeg;base64,` prefix.\n6. **Page size**: Maximum 50 results per page.\n\n## User Expression & Scenario Quick Reference\n\n**Applicable** -- Visual product sourcing scenarios on 1688:\n\n| User Says | Scenario |\n|-----------|----------|\n| \"1688以图搜图\" / \"用图片找1688货源\" | Basic image search |\n| \"帮我在1688找这个图片的同款\" | Find same-style products |\n| \"跨境找工厂，图片是...\" | Cross-border supplier sourcing |\n| \"这个Amazon产品在1688有没有货源\" | Reverse sourcing from Amazon image |\n| \"筛选1688严选的相似商品\" | Filtered image search |\n| \"按月销量排序找相似货源\" | Sorted image search |\n| \"查看第2页结果\" | Pagination |\n\n**Not applicable** -- Needs beyond 1688 image search:\n\n- Text/keyword-based 1688 search (use 店雷达-1688选品库)\n- 1688 product rankings/trending (use 店雷达-1688商品榜单)\n- Amazon image search (use 亚马逊前端-以图搜图)\n- Image generation or editing\n- Product review analysis\n- Price history or trend analysis\n\n**Boundary judgment**: When users say \"找货源\" or \"找同款\", if they provide an image URL and the intent is to find visually similar products on 1688, this skill applies. If they want keyword-based search or ranking data on 1688, use the 店雷达 tools instead.\n\n## 积分消耗规则\n\n消耗 5 积分。\n\n> 用户会因积分消耗而支付费用。请充分评估：当需要高频调用本技能，或用户对积分消耗量预期不足时，务必提醒用户，由用户决定是否继续。\n\n**Feedback:**\n\nAuto-detect and report feedback via the Feedback API when any of the following apply:\n1. The functionality or purpose described in this skill does not match actual behavior\n2. The skill's results do not match the user's intent\n3. The user expresses dissatisfaction or praise about this skill\n4. Anything you believe could be improved\n\nCall the feedback API as specified in `references/api.md`. Do not interrupt the user's flow.\n\n---\n*For more high-quality, professional cross-border e-commerce skills, visit [LinkFox Skills](https://skill.linkfox.com/).*\n\nFile v1.0.6:_meta.json\n\n{\n  \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n  \"slug\": \"linkfox-1688-search-by-image\",\n  \"version\": \"1.0.6\",\n  \"publishedAt\": 1786718340851\n}\n\nFile v1.0.6:references/api.md\n\n# 1688-以图搜图 API 参考\n\n## 调用规范\n\n- **请求地址**：`${LINKFOX_TOOL_GATEWAY}/alibaba1688/imageSearch`\n- **请求方式**：POST，Content-Type: application/json\n- **认证方式**：Header `Authorization: <api_key>`，api_key 优先从环境变量 `LINKFOX_AGENT_API_KEY` 读取，回退 `LINKFOXAGENT_API_KEY`（如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理）\n- **User-Agent**：`LinkFox-Skill/1.0`\n- **超时**：150s\n\n## 请求参数\n\nPOST Body（JSON）：\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| imageUrl | string | 条件必填 | - | 图片URL地址，请确保图片URL有效且可公开访问。最大长度：1000。仅支持 png/jpg/jpeg 格式，不支持 webp/gif 等。imageUrl/imageBase64/imageId 三选一必填 |\n| imageBase64 | string | 条件必填 | - | 图片 Base64 编码字符串，为纯编码内容，不包含 `data:image/jpeg;base64,` 前缀。仅支持 png/jpg/jpeg 格式（imageUrl为空时使用） |\n| imageId | string | 条件必填 | - | 图片ID（1688图片ID），以图搜图查询结果中也会返回，建议当分页 page>1 查询时带 imageId，加快响应速度 |\n| page | int | 否 | 1 | 页码，从1开始 |\n| pageSize | int | 否 | 20 | 每页返回的商品数量，最大不超过50 |\n| priceStart | string | 否 | - | 价格筛选起始值（人民币），如 10 |\n| priceEnd | string | 否 | - | 价格筛选结束值（人民币），如 100 |\n| filter | string | 否 | - | 过滤条件，多个条件用逗号分隔。有效值见下方「支持的过滤条件」 |\n| sort | string | 否 | {\"monthSold\":\"desc\"} | 排序条件，JSON格式 {排序字段: 排序方式}。有效字段：price、rePurchaseRate、monthSold；方式：asc/desc |\n| keyword | string | 否 | - | 关键词，在结果中搜索 |\n| productCollectionId | string | 否 | - | 货盘ID，单选。有效值见下方「支持的货盘ID」 |\n\n### 支持的过滤条件\n\n多个条件用逗号分隔，如 `1688Selection,totalEpScoreLv1,qrr0`。\n\n| 值 | 说明 |\n|----|------|\n| 1688Selection | 1688严选 |\n| certifiedFactory | 认证工厂 |\n| totalEpScoreLv1 | 综合体验分5星 |\n| totalEpScoreLv2 | 综合体验分4星 |\n| totalEpScoreLv3 | 综合体验分3星 |\n| totalEpScoreLv4 | 综合体验分2星 |\n| qrr0 | 无品质退款 |\n| qrr1 | 品质退款率<1% |\n| qrr5 | 品质退款率<5% |\n| qrr10 | 品质退款率<10% |\n| shipInToday | 当日发货 |\n| shipIn24Hours | 24小时发货 |\n| shipIn48Hours | 48小时发货 |\n| noReason7DReturn | 7天无理由退货 |\n| isOnePsale | 一件代发 |\n| isOnePsaleFreePost | 一件代发包邮 |\n| new7 | 7天内新品 |\n| new30 | 30天内新品 |\n| isQqyx | 全球严选 |\n| JPFL | 日本专线 |\n| USFL | 美国专线 |\n| KRFL | 韩国专线 |\n| VNFL | 越南专线 |\n| SAFL | 沙特专线 |\n| RUFL | 俄罗斯专线 |\n| KZFL | 哈萨克斯坦专线 |\n| HKFL | 香港专线 |\n| MOFL | 澳门专线 |\n| TWFL | 台湾专线 |\n\n### 支持的排序字段\n\n| 字段 | 说明 |\n|------|------|\n| price | 价格 |\n| monthSold | 月销量 |\n| rePurchaseRate | 复购率 |\n\n排序方式：`asc`（升序）、`desc`（降序）。格式示例：`{\"price\":\"asc\"}`\n\n### 支持的货盘ID\n\n| ID | 说明 |\n|----|------|\n| 262105288 | 跨境货盘 |\n| 262105286 | 跨境货盘 |\n| 262105253 | 跨境货盘 |\n| 262105281 | 跨境货盘 |\n| 262105280 | 跨境货盘 |\n| 262105277 | 跨境货盘 |\n| 262105276 | 跨境货盘 |\n| 262105274 | 跨境货盘 |\n| 262105269 | 跨境货盘 |\n| 262185282 | 跨境货盘 |\n\n## 响应结构\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| imageId | string | 上传后的图片ID（分页查询时回传可加速） |\n| total | integer | 本页商品数量 |\n| totalPage | integer | 总页数 |\n| sourceType | string | 来源类型（固定值 \"1688\"） |\n| type | string | 渲染样式（固定值 \"productWorkbenches\"） |\n| columns | array | 渲染列定义 |\n| costToken | integer | 消耗 token |\n| products | array | 商品列表（详见下方商品字段） |\n\n### 商品字段\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| offerId | string | 商品ID |\n| asin | string | 商品编号（同 offerId） |\n| imageUrl | string | 商品图片 |\n| title | string | 商品标题 |\n| price | number | 批发价（元） |\n| consignPrice | number | 一件代发价（元） |\n| salesQuantity | integer | 月销售件数 |\n| estimatedSalesAmount | number | 预估销售额 |\n| asinUrl | string | 商品链接 |\n| isOnePsale | string | 是否一件代发（是/否） |\n| isJxhy | string | 是否精选货源（是/否） |\n| sellerIdentities | string | 商家身份（超级工厂/实力商家/诚信通会员） |\n| offerIdentities | string | 商品标（严选） |\n| repurchaseRate | string | 复购率 |\n| tradeScore | string | 商品交易评分 |\n| compositeServiceScore | string | 综合服务体验分 |\n| sendGoodsAddressText | string | 发货地 |\n| deliveryTime | string | 发货时间（24/48小时） |\n| quantityBegin | integer | 起批量 |\n| hasPromotion | string | 是否有营销活动（是/否） |\n| promotionType | string | 营销类型 |\n| isPatentProduct | string | 是否专利商品（是/否） |\n| isSelect | string | 跨境select货盘标识 |\n| currency | string | 币种（固定值 \"¥\"） |\n| sourceType | string | 来源类型（固定值 \"1688\"） |\n| sourceTool | string | 来源工具（固定值 \"1688以图搜图\"） |\n| dataType | string | 数据类型（固定值 \"monthlyData\"） |\n\n## 错误码\n\n正常情况下，接口的 HTTP 状态码均为 200，业务的成功与否通过响应体中的 errorCode 字段区分（errorCode = 200 表示成功，其他值表示业务错误）。当遇到未授权等情况时，HTTP 状态码为 401，且对应的 errorCode 也是 401。\n\n| errcode | 含义 | 处理建议 |\n|---------|------|----------|\n| 200 | 成功 | 正常解析业务字段 |\n| 401 | 认证失败 | HTTP 401 或 authorized error：按 SKILL.md 的 **## 解决认证和积分问题** 处理。 |\n| 402 | 积分不足 | HTTP 402：按 SKILL.md 的 **## 解决认证和积分问题** 处理。 |\n| 其他非200值 | 业务异常 | 参考 `errmsg` 字段获取具体错误原因 |\n\n错误响应示例：\n\n```json\n{\n    \"errcode\": 401,\n    \"errmsg\": \"authorized error\"\n}\n```\n\n## curl 示例\n\n### 基础以图搜图\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/alibaba1688/imageSearch \\\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"User-Agent: LinkFox-Skill/1.0\" \\\n  -d '{\n    \"imageUrl\": \"https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg\",\n    \"page\": 1,\n    \"pageSize\": 20\n  }'\n```\n\n### 带筛选和排序\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/alibaba1688/imageSearch \\\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"User-Agent: LinkFox-Skill/1.0\" \\\n  -d '{\n    \"imageUrl\": \"https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg\",\n    \"page\": 1,\n    \"pageSize\": 20,\n    \"filter\": \"1688Selection,totalEpScoreLv1,qrr0\",\n    \"sort\": \"{\\\"price\\\":\\\"desc\\\"}\"\n  }'\n```\n\n### 分页查询（使用 imageId）\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/alibaba1688/imageSearch \\\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"User-Agent: LinkFox-Skill/1.0\" \\\n  -d '{\n    \"imageId\": \"abc123456\",\n    \"page\": 2,\n    \"pageSize\": 20\n  }'\n```\n\n### 价格区间筛选\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/alibaba1688/imageSearch \\\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"User-Agent: LinkFox-Skill/1.0\" \\\n  -d '{\n    \"imageUrl\": \"https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg\",\n    \"page\": 1,\n    \"pageSize\": 20,\n    \"priceStart\": \"10\",\n    \"priceEnd\": \"100\"\n  }'\n```\n\n---\n\n## Feedback API\n\n> This endpoint is **separate** from the tool API above. Do not mix the two base URLs.\n\n- **POST** `https://skill-api.linkfox.com/api/v1/public/feedback`\n- **Content-Type:** `application/json`\n\n```json\n{\n  \"skillName\": \"linkfox-1688-search-by-image\",\n  \"sentiment\": \"POSITIVE\",\n  \"category\": \"OTHER\",\n  \"content\": \"Results were accurate, user was satisfied.\"\n}\n```\n\n**Field rules:**\n- `skillName`: Use this skill's `name` from the YAML frontmatter (`linkfox-1688-search-by-image`)\n- `sentiment`: Choose ONE — `POSITIVE` (praise), `NEUTRAL` (suggestion without emotion), `NEGATIVE` (complaint or error)\n- `category`: Choose ONE — `BUG` (malfunction or wrong data), `COMPLAINT` (user dissatisfaction), `SUGGESTION` (improvement idea), `OTHER`\n- `content`: Include what the user said or intended, what actually happened, and why it is a problem or praise\n\nFile v1.0.6:references/onboarding.md\n\n# 解决认证和积分问题\n\n调用本 skill 时若网关返回 **auth** 或 **billing** 错误，走本 skill 自带的 `scripts/onboarding.py` 完成引导。\n\n**auth 场景**：`errcode=401` 或消息含 `authorized error`/`鉴权失败`/`未授权`/`unauthorized`；或 `LINKFOX_AGENT_API_KEY` 与 `LINKFOXAGENT_API_KEY` 均为空。\n1. 若已配置 key → 先让用户重启会话（最常见误判），仍失败让用户重新取 key 或换手机号重注册\n2. 未配置 → 询问：自助去 https://agent.linkfox.com/ 取 key，或提供手机号让脚本注册\n3. 手机号路径：\n   - `python scripts/onboarding.py send-code <phone>` → 展示 JSON 里的 phone/agreements\n   - 收到验证码后：`python scripts/onboarding.py login <phone> <code>`（workbuddy 宿主加 `--channel workbuddy`）\n   - 拿到 `api_key` 后把下面三平台配置转发给用户，提示重启会话生效：\n     - Windows PowerShell（永久）：`setx LINKFOX_AGENT_API_KEY \"<key>\"`\n     - macOS zsh：`echo 'export LINKFOX_AGENT_API_KEY=\"<key>\"' >> ~/.zshrc && source ~/.zshrc`\n     - Linux bash：`echo 'export LINKFOX_AGENT_API_KEY=\"<key>\"' >> ~/.bashrc && source ~/.bashrc`\n     - 变量名 `LINKFOX_AGENT_API_KEY`（主推）或 `LINKFOXAGENT_API_KEY`（老规范）任一即可\n\n**billing 场景**：`errcode=402` 或消息含 `积分/余额/quota/insufficient/充值/套餐到期`。\n- `python scripts/onboarding.py list-plans` → 有 AskUserQuestion 就弹菜单，否则输出编号清单让用户选\n- 校验 `plan_id` ∈ 清单、支付方式 ∈ 该套餐 `available_methods`（通常 `wechat/alipay`）\n- `python scripts/onboarding.py order <plan_id> <method>` → 展示优先级 PNG > `pay_url` > `ascii_qr`（标注兜底）\n- 已付款可选调 `python scripts/onboarding.py query <order_id>`，不主动轮询\n\n排除 `errcode=403`（无权限，不归入这两类）。所有子命令输出 stdout JSON，`error` 字段已含阶段前缀，透传给用户即可。完整用法：`python scripts/onboarding.py --help`。\n\nFile v1.0.6:skill-card.md\n\n## Description:\n\nSearches 1688 by product image to help cross-border sellers find visually similar supplier listings with sourcing data such as price, minimum order quantity, sales, repurchase rate, trade score, and supplier badges.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[linkfox-ai](https://clawhub.ai/user/linkfox-ai)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal sellers and sourcing agents use this skill to find same-style or visually similar 1688 supplier products from a public image URL, uploaded local image, base64 image, or prior 1688 image ID. It supports filtered and sorted sourcing workflows where the agent returns structured product data and guidance for pagination or authentication issues.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: LinkFox may receive image URLs or uploaded images, search parameters, API credentials, and possible onboarding or payment information.\n\nMitigation: Use the skill only when that data sharing is acceptable; review the configured LinkFox gateway URL and provide phone numbers, SMS codes, or payment actions only when intentionally starting those flows.\n\nRisk: Search responses and cached results may be persisted in local linkfox folders, which can expose sensitive sourcing data on shared machines.\n\nMitigation: Review and periodically delete local linkfox response and cache folders when the product or supplier data is sensitive.\n\nRisk: The skill consumes credits for 1688 searches and includes onboarding and billing flows.\n\nMitigation: Confirm the expected credit cost before repeated calls, avoid automatic retry loops, and require user approval before purchase or recharge actions.\n\n## Reference(s):\n\n- [1688-以图搜图 API reference](references/api.md)\n- [Authentication and billing onboarding guidance](references/onboarding.md)\n- [ClawHub skill page](https://clawhub.ai/linkfox-ai/skills/linkfox-1688-search-by-image)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, code, shell commands, configuration, guidance]\n\n**Output Format:** [Markdown guidance with JSON product-search results and optional shell commands]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [The search script writes full responses to local JSON files, prints small responses inline, summarizes large responses, and may cache repeated parameter combinations for 24 hours.]\n\n## Skill Version(s):\n\n1.0.6 (source: server release metadata)\n\n## Ethical Considerations:\n\nUsers 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 deployment.\n\nArchive v1.0.5: 8 files, 27383 bytes\n\nFiles: references/api.md (8786b), references/onboarding.md (2046b), scripts/alibaba1688_image_search.py (12725b), scripts/onboarding.py (24089b), scripts/upload_image.py (4591b), skill-card.md (3022b), SKILL.md (11951b), _meta.json (147b)\n\nFile v1.0.5:SKILL.md\n\n---\nname: linkfox-1688-search-by-image\ndescription: 1688平台以图搜图，通过商品图片精准检索外观相似或同款的1688货源，返回标题、价格、起批量、月销量、复购率、交易评分等核心数据。当用户提到1688以图搜图、1688找货源、以图找同款、跨境找工厂、1688识图、图片找货源、找相似货源、image search 1688、find supplier by image时触发此技能。即使用户未明确提及\"以图搜图\"，只要用户提供了图片URL并希望在1688上查找匹配或相似的货源商品，也应触发此技能。\n---\n\n# 1688 Image-Based Product Search\n\nThis skill performs visual product searches on the 1688 platform using an image URL, helping cross-border sellers find visually similar supplier products for sourcing.\n\n## Core Concepts\n\n1688 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.\n\n## Data Fields\n\n| Field | Description |\n|-------|-------------|\n| offerId | Product ID on 1688 |\n| title | Product title |\n| imageUrl | Product main image |\n| price | Wholesale price (CNY) |\n| consignPrice | Dropship price (CNY) |\n| salesQuantity | Monthly sales volume |\n| estimatedSalesAmount | Estimated monthly revenue |\n| quantityBegin | Minimum order quantity |\n| repurchaseRate | Repurchase rate |\n| tradeScore | Product trade score |\n| compositeServiceScore | Composite service experience score |\n| sellerIdentities | Seller identity (超级工厂/实力商家/诚信通会员) |\n| offerIdentities | Product badge (严选) |\n| sendGoodsAddressText | Shipping origin |\n| deliveryTime | Delivery time (24/48 hours) |\n| isOnePsale | Supports dropshipping (是/否) |\n| isJxhy | Premium sourcing (是/否) |\n| hasPromotion | Has promotion (是/否) |\n| isPatentProduct | Patent product (是/否) |\n\n## Parameter Guide\n\n**Image Rules:**\n1. Only png, jpg, jpeg formats are supported. webp, gif, and other formats are NOT supported.\n2. Base64 string must be pure encoded content WITHOUT the `data:image/jpeg;base64,` prefix.\n3. Image source — one of imageUrl, imageBase64, or imageId must be provided (at least one required).\n\n| Parameter | Required | Default | Description |\n|-----------|----------|---------|-------------|\n| imageUrl | Conditional | - | Public image URL (max 1000 chars). Only png/jpg/jpeg formats supported |\n| imageBase64 | Conditional | - | Pure Base64 encoded image string, without `data:image/...;base64,` prefix. Only png/jpg/jpeg supported |\n| imageId | Conditional | - | 1688 image ID from previous search result (speeds up pagination) |\n| page | No | 1 | Page number, starting from 1 |\n| pageSize | No | 20 | Results per page (1-50) |\n| priceStart | No | - | Min price filter (CNY) |\n| priceEnd | No | - | Max price filter (CNY) |\n| filter | No | - | Filter conditions, comma-separated (see supported filters below) |\n| sort | No | {\"monthSold\":\"desc\"} | Sort as JSON: {field: direction} (see supported sort fields below) |\n| keyword | No | - | Keyword to further filter results |\n| productCollectionId | No | - | Product collection ID (see supported IDs below) |\n\n### Supported Filters\n\nMultiple filters can be combined with commas (e.g. `1688Selection,totalEpScoreLv1,qrr0`).\n\n| Filter Value | Description |\n|--------------|-------------|\n| 1688Selection | 1688严选 |\n| certifiedFactory | 认证工厂 |\n| totalEpScoreLv1 | 综合体验分5星 |\n| totalEpScoreLv2 | 综合体验分4星 |\n| totalEpScoreLv3 | 综合体验分3星 |\n| totalEpScoreLv4 | 综合体验分2星 |\n| qrr0 | 无品质退款 |\n| qrr1 | 品质退款率<1% |\n| qrr5 | 品质退款率<5% |\n| qrr10 | 品质退款率<10% |\n| shipInToday | 当日发货 |\n| shipIn24Hours | 24小时发货 |\n| shipIn48Hours | 48小时发货 |\n| noReason7DReturn | 7天无理由退货 |\n| isOnePsale | 一件代发 |\n| isOnePsaleFreePost | 一件代发包邮 |\n| new7 | 7天内新品 |\n| new30 | 30天内新品 |\n| isQqyx | 全球严选 |\n| JPFL | 日本专线 |\n| USFL | 美国专线 |\n| KRFL | 韩国专线 |\n| VNFL | 越南专线 |\n| SAFL | 沙特专线 |\n| RUFL | 俄罗斯专线 |\n| KZFL | 哈萨克斯坦专线 |\n| HKFL | 香港专线 |\n| MOFL | 澳门专线 |\n| TWFL | 台湾专线 |\n\n### Supported Sort Fields\n\n| Field | Direction | Description |\n|-------|-----------|-------------|\n| price | asc/desc | Price ascending/descending |\n| monthSold | asc/desc | Monthly sales ascending/descending |\n| rePurchaseRate | asc/desc | Repurchase rate ascending/descending |\n\nSort format example: `{\"price\":\"asc\"}` for price low to high.\n\n### Supported Product Collection IDs\n\n| ID | Usage |\n|----|-------|\n| 262105288 | 跨境货盘 |\n| 262105286 | 跨境货盘 |\n| 262105253 | 跨境货盘 |\n| 262105281 | 跨境货盘 |\n| 262105280 | 跨境货盘 |\n| 262105277 | 跨境货盘 |\n| 262105276 | 跨境货盘 |\n| 262105274 | 跨境货盘 |\n| 262105269 | 跨境货盘 |\n| 262185282 | 跨境货盘 |\n\n## 调用方式\n\n- **API 端点**：`POST /alibaba1688/imageSearch`（完整参数/响应/错误码见 `references/api.md`）\n- **Python 脚本**：`python scripts/alibaba1688_image_search.py '<JSON 参数>' [--inline]`\n- **成本约束**：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。\n\n**输出策略（脚本默认行为）**：\n- **始终**将完整响应写入 `<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-1688-search-by-image-<timestamp>.json`（`<cwd>` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`<session>` 取自环境变量 `SESSION_ID`，按用户任务自动聚合；**禁止写入 /tmp**，当前目录不可写则报错）\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段的长度 + 前 3 条样本）\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\n\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq`或`ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\n\n## 解决认证和积分问题\n发生以下异常情况时，采用 references/onboarding.md 引导解决问题：\n\n### 异常情况\n- **未配置API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\n- **响应401或402状态码**\n- **响应提示积分或余额不足**：消息含\"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值\"，或类似含义的内容。\n\n## Local Image Upload\n\nThis tool requires a **publicly accessible image URL**. If the user provides a local image file path, you must upload it first to obtain a public URL.\n\nRun the upload script:\n```bash\npython scripts/upload_image.py /path/to/local/image.png\n```\n\nThe script will return a public URL (valid for 24 hours) that can be used as the imageUrl parameter.\n\n## Usage Examples\n\n**1. Basic image search**\n```\n在1688搜索与图片相似的商品，图片地址为 https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg\n```\n\n**2. Search with filters**\n```\n在1688搜索与图片相似的商品，图片地址为 https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg，查询第1页，筛选1688严选，并按价格从高到低排序\n```\n\n**3. Search with sorting**\n```\n在1688搜索与图片相似的商品，图片地址为 https://example.com/product.jpg，按价格从高到低排序\n```\n\n**4. Paginated search**\n```\n在1688搜索与图片相似的商品，图片地址为 https://example.com/product.jpg，查询第2页，每页50条\n```\n\n**5. Price range filter**\n```\n在1688搜索与图片相似的商品，图片地址为 https://example.com/product.jpg，价格区间10-100元\n```\n\n## Display Rules\n\n1. **Present data clearly**: Show results in a structured table with key columns: product image, title, price, dropship price, monthly sales, minimum order quantity, repurchase rate, and seller identity\n2. **Image display**: When the response includes imageUrl for products, display them inline for visual comparison\n3. **Price display**: Always show price in CNY (¥) format\n4. **Seller badges**: Display seller identity badges (超级工厂/实力商家/诚信通会员) and product badges (严选) prominently\n5. **Result count**: Always inform the user of total results and current page/total pages\n6. **Pagination hint**: When more pages are available, suggest the user can request the next page\n7. **Filter/sort limitation**: If the user requests a sort or filter not in the supported list, do NOT attempt any workaround. Inform the user of the supported options\n8. **No secondary processing**: Results are real-time and not stored in a database, so secondary SQL/data processing is not available\n\n## Important Limitations\n\n1. **Data real-time nature**: Results are live searches, not stored in any database. Cannot use `_dataQuery_executeDynamicQuery` for secondary processing.\n2. **Logic constraint**: If the user requests sort or filter conditions not in the preset supported list, do NOT call any other tool or logic to compensate.\n3. **Image input**: One of imageUrl, imageBase64, or imageId is required. For page > 1, prefer passing imageId from the first page result to speed up queries.\n4. **Image format**: Only png, jpg, jpeg are supported. webp, gif, and other formats will be rejected.\n5. **Base64 format**: The imageBase64 value must be the raw Base64 string only — do NOT include the `data:image/jpeg;base64,` prefix.\n6. **Page size**: Maximum 50 results per page.\n\n## User Expression & Scenario Quick Reference\n\n**Applicable** -- Visual product sourcing scenarios on 1688:\n\n| User Says | Scenario |\n|-----------|----------|\n| \"1688以图搜图\" / \"用图片找1688货源\" | Basic image search |\n| \"帮我在1688找这个图片的同款\" | Find same-style products |\n| \"跨境找工厂，图片是...\" | Cross-border supplier sourcing |\n| \"这个Amazon产品在1688有没有货源\" | Reverse sourcing from Amazon image |\n| \"筛选1688严选的相似商品\" | Filtered image search |\n| \"按月销量排序找相似货源\" | Sorted image search |\n| \"查看第2页结果\" | Pagination |\n\n**Not applicable** -- Needs beyond 1688 image search:\n\n- Text/keyword-based 1688 search (use 店雷达-1688选品库)\n- 1688 product rankings/trending (use 店雷达-1688商品榜单)\n- Amazon image search (use 亚马逊前端-以图搜图)\n- Image generation or editing\n- Product review analysis\n- Price history or trend analysis\n\n**Boundary judgment**: When users say \"找货源\" or \"找同款\", if they provide an image URL and the intent is to find visually similar products on 1688, this skill applies. If they want keyword-based search or ranking data on 1688, use the 店雷达 tools instead.\n\n## 积分消耗规则\n\n消耗 5 积分。\n\n> 用户会因积分消耗而支付费用。请充分评估：当需要高频调用本技能，或用户对积分消耗量预期不足时，务必提醒用户，由用户决定是否继续。\n\n**Feedback:**\n\nAuto-detect and report feedback via the Feedback API when any of the following apply:\n1. The functionality or purpose described in this skill does not match actual behavior\n2. The skill's results do not match the user's intent\n3. The user expresses dissatisfaction or praise about this skill\n4. Anything you believe could be improved\n\nCall the feedback API as specified in `references/api.md`. Do not interrupt the user's flow.\n\n---\n*For more high-quality, professional cross-border e-commerce skills, visit [LinkFox Skills](https://skill.linkfox.com/).*\n\nFile v1.0.5:_meta.json\n\n{\n  \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n  \"slug\": \"linkfox-1688-search-by-image\",\n  \"version\": \"1.0.5\",\n  \"publishedAt\": 1786098875918\n}\n\nFile v1.0.5:references/api.md\n\n# 1688-以图搜图 API 参考\n\n## 调用规范\n\n- **请求地址**：`${LINKFOX_TOOL_GATEWAY}/alibaba1688/imageSearch`\n- **请求方式**：POST，Content-Type: application/json\n- **认证方式**：Header `Authorization: <api_key>`，api_key 优先从环境变量 `LINKFOX_AGENT_API_KEY` 读取，回退 `LINKFOXAGENT_API_KEY`（如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理）\n- **User-Agent**：`LinkFox-Skill/1.0`\n- **超时**：60s\n\n## 请求参数\n\nPOST Body（JSON）：\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| imageUrl | string | 条件必填 | - | 图片URL地址，请确保图片URL有效且可公开访问。最大长度：1000。仅支持 png/jpg/jpeg 格式，不支持 webp/gif 等。imageUrl/imageBase64/imageId 三选一必填 |\n| imageBase64 | string | 条件必填 | - | 图片 Base64 编码字符串，为纯编码内容，不包含 `data:image/jpeg;base64,` 前缀。仅支持 png/jpg/jpeg 格式（imageUrl为空时使用） |\n| imageId | string | 条件必填 | - | 图片ID（1688图片ID），以图搜图查询结果中也会返回，建议当分页 page>1 查询时带 imageId，加快响应速度 |\n| page | int | 否 | 1 | 页码，从1开始 |\n| pageSize | int | 否 | 20 | 每页返回的商品数量，最大不超过50 |\n| priceStart | string | 否 | - | 价格筛选起始值（人民币），如 10 |\n| priceEnd | string | 否 | - | 价格筛选结束值（人民币），如 100 |\n| filter | string | 否 | - | 过滤条件，多个条件用逗号分隔。有效值见下方「支持的过滤条件」 |\n| sort | string | 否 | {\"monthSold\":\"desc\"} | 排序条件，JSON格式 {排序字段: 排序方式}。有效字段：price、rePurchaseRate、monthSold；方式：asc/desc |\n| keyword | string | 否 | - | 关键词，在结果中搜索 |\n| productCollectionId | string | 否 | - | 货盘ID，单选。有效值见下方「支持的货盘ID」 |\n\n### 支持的过滤条件\n\n多个条件用逗号分隔，如 `1688Selection,totalEpScoreLv1,qrr0`。\n\n| 值 | 说明 |\n|----|------|\n| 1688Selection | 1688严选 |\n| certifiedFactory | 认证工厂 |\n| totalEpScoreLv1 | 综合体验分5星 |\n| totalEpScoreLv2 | 综合体验分4星 |\n| totalEpScoreLv3 | 综合体验分3星 |\n| totalEpScoreLv4 | 综合体验分2星 |\n| qrr0 | 无品质退款 |\n| qrr1 | 品质退款率<1% |\n| qrr5 | 品质退款率<5% |\n| qrr10 | 品质退款率<10% |\n| shipInToday | 当日发货 |\n| shipIn24Hours | 24小时发货 |\n| shipIn48Hours | 48小时发货 |\n| noReason7DReturn | 7天无理由退货 |\n| isOnePsale | 一件代发 |\n| isOnePsaleFreePost | 一件代发包邮 |\n| new7 | 7天内新品 |\n| new30 | 30天内新品 |\n| isQqyx | 全球严选 |\n| JPFL | 日本专线 |\n| USFL | 美国专线 |\n| KRFL | 韩国专线 |\n| VNFL | 越南专线 |\n| SAFL | 沙特专线 |\n| RUFL | 俄罗斯专线 |\n| KZFL | 哈萨克斯坦专线 |\n| HKFL | 香港专线 |\n| MOFL | 澳门专线 |\n| TWFL | 台湾专线 |\n\n### 支持的排序字段\n\n| 字段 | 说明 |\n|------|------|\n| price | 价格 |\n| monthSold | 月销量 |\n| rePurchaseRate | 复购率 |\n\n排序方式：`asc`（升序）、`desc`（降序）。格式示例：`{\"price\":\"asc\"}`\n\n### 支持的货盘ID\n\n| ID | 说明 |\n|----|------|\n| 262105288 | 跨境货盘 |\n| 262105286 | 跨境货盘 |\n| 262105253 | 跨境货盘 |\n| 262105281 | 跨境货盘 |\n| 262105280 | 跨境货盘 |\n| 262105277 | 跨境货盘 |\n| 262105276 | 跨境货盘 |\n| 262105274 | 跨境货盘 |\n| 262105269 | 跨境货盘 |\n| 262185282 | 跨境货盘 |\n\n## 响应结构\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| imageId | string | 上传后的图片ID（分页查询时回传可加速） |\n| total | integer | 本页商品数量 |\n| totalPage | integer | 总页数 |\n| sourceType | string | 来源类型（固定值 \"1688\"） |\n| type | string | 渲染样式（固定值 \"productWorkbenches\"） |\n| columns | array | 渲染列定义 |\n| costToken | integer | 消耗 token |\n| products | array | 商品列表（详见下方商品字段） |\n\n### 商品字段\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| offerId | string | 商品ID |\n| asin | string | 商品编号（同 offerId） |\n| imageUrl | string | 商品图片 |\n| title | string | 商品标题 |\n| price | number | 批发价（元） |\n| consignPrice | number | 一件代发价（元） |\n| salesQuantity | integer | 月销售件数 |\n| estimatedSalesAmount | number | 预估销售额 |\n| asinUrl | string | 商品链接 |\n| isOnePsale | string | 是否一件代发（是/否） |\n| isJxhy | string | 是否精选货源（是/否） |\n| sellerIdentities | string | 商家身份（超级工厂/实力商家/诚信通会员） |\n| offerIdentities | string | 商品标（严选） |\n| repurchaseRate | string | 复购率 |\n| tradeScore | string | 商品交易评分 |\n| compositeServiceScore | string | 综合服务体验分 |\n| sendGoodsAddressText | string | 发货地 |\n| deliveryTime | string | 发货时间（24/48小时） |\n| quantityBegin | integer | 起批量 |\n| hasPromotion | string | 是否有营销活动（是/否） |\n| promotionType | string | 营销类型 |\n| isPatentProduct | string | 是否专利商品（是/否） |\n| isSelect | string | 跨境select货盘标识 |\n| currency | string | 币种（固定值 \"¥\"） |\n| sourceType | string | 来源类型（固定值 \"1688\"） |\n| sourceTool | string | 来源工具（固定值 \"1688以图搜图\"） |\n| dataType | string | 数据类型（固定值 \"monthlyData\"） |\n\n## 错误码\n\n正常情况下，接口的 HTTP 状态码均为 200，业务的成功与否通过响应体中的 errorCode 字段区分（errorCode = 200 表示成功，其他值表示业务错误）。当遇到未授权等情况时，HTTP 状态码为 401，且对应的 errorCode 也是 401。\n\n| errcode | 含义 | 处理建议 |\n|---------|------|----------|\n| 200 | 成功 | 正常解析业务字段 |\n| 401 | 认证失败 | HTTP 401 或 authorized error：按 SKILL.md 的 **## 解决认证和积分问题** 处理。 |\n| 402 | 积分不足 | HTTP 402：按 SKILL.md 的 **## 解决认证和积分问题** 处理。 |\n| 其他非200值 | 业务异常 | 参考 `errmsg` 字段获取具体错误原因 |\n\n错误响应示例：\n\n```json\n{\n    \"errcode\": 401,\n    \"errmsg\": \"authorized error\"\n}\n```\n\n## curl 示例\n\n### 基础以图搜图\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/alibaba1688/imageSearch \\\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"User-Agent: LinkFox-Skill/1.0\" \\\n  -d '{\n    \"imageUrl\": \"https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg\",\n    \"page\": 1,\n    \"pageSize\": 20\n  }'\n```\n\n### 带筛选和排序\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/alibaba1688/imageSearch \\\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"User-Agent: LinkFox-Skill/1.0\" \\\n  -d '{\n    \"imageUrl\": \"https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg\",\n    \"page\": 1,\n    \"pageSize\": 20,\n    \"filter\": \"1688Selection,totalEpScoreLv1,qrr0\",\n    \"sort\": \"{\\\"price\\\":\\\"desc\\\"}\"\n  }'\n```\n\n### 分页查询（使用 imageId）\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/alibaba1688/imageSearch \\\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"User-Agent: LinkFox-Skill/1.0\" \\\n  -d '{\n    \"imageId\": \"abc123456\",\n    \"page\": 2,\n    \"pageSize\": 20\n  }'\n```\n\n### 价格区间筛选\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/alibaba1688/imageSearch \\\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"User-Agent: LinkFox-Skill/1.0\" \\\n  -d '{\n    \"imageUrl\": \"https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg\",\n    \"page\": 1,\n    \"pageSize\": 20,\n    \"priceStart\": \"10\",\n    \"priceEnd\": \"100\"\n  }'\n```\n\n---\n\n## Feedback API\n\n> This endpoint is **separate** from the tool API above. Do not mix the two base URLs.\n\n- **POST** `https://skill-api.linkfox.com/api/v1/public/feedback`\n- **Content-Type:** `application/json`\n\n```json\n{\n  \"skillName\": \"linkfox-1688-search-by-image\",\n  \"sentiment\": \"POSITIVE\",\n  \"category\": \"OTHER\",\n  \"content\": \"Results were accurate, user was satisfied.\"\n}\n```\n\n**Field rules:**\n- `skillName`: Use this skill's `name` from the YAML frontmatter (`linkfox-1688-search-by-image`)\n- `sentiment`: Choose ONE — `POSITIVE` (praise), `NEUTRAL` (suggestion without emotion), `NEGATIVE` (complaint or error)\n- `category`: Choose ONE — `BUG` (malfunction or wrong data), `COMPLAINT` (user dissatisfaction), `SUGGESTION` (improvement idea), `OTHER`\n- `content`: Include what the user said or intended, what actually happened, and why it is a problem or praise\n\nFile v1.0.5:references/onboarding.md\n\n# 解决认证和积分问题\n\n调用本 skill 时若网关返回 **auth** 或 **billing** 错误，走本 skill 自带的 `scripts/onboarding.py` 完成引导。\n\n**auth 场景**：`errcode=401` 或消息含 `authorized error`/`鉴权失败`/`未授权`/`unauthorized`；或 `LINKFOX_AGENT_API_KEY` 与 `LINKFOXAGENT_API_KEY` 均为空。\n1. 若已配置 key → 先让用户重启会话（最常见误判），仍失败让用户重新取 key 或换手机号重注册\n2. 未配置 → 询问：自助去 https://agent.linkfox.com/ 取 key，或提供手机号让脚本注册\n3. 手机号路径：\n   - `python scripts/onboarding.py send-code <phone>` → 展示 JSON 里的 phone/agreements\n   - 收到验证码后：`python scripts/onboarding.py login <phone> <code>`（workbuddy 宿主加 `--channel workbuddy`）\n   - 拿到 `api_key` 后把下面三平台配置转发给用户，提示重启会话生效：\n     - Windows PowerShell（永久）：`setx LINKFOX_AGENT_API_KEY \"<key>\"`\n     - macOS zsh：`echo 'export LINKFOX_AGENT_API_KEY=\"<key>\"' >> ~/.zshrc && source ~/.zshrc`\n     - Linux bash：`echo 'export LINKFOX_AGENT_API_KEY=\"<key>\"' >> ~/.bashrc && source ~/.bashrc`\n     - 变量名 `LINKFOX_AGENT_API_KEY`（主推）或 `LINKFOXAGENT_API_KEY`（老规范）任一即可\n\n**billing 场景**：`errcode=402` 或消息含 `积分/余额/quota/insufficient/充值/套餐到期`。\n- `python scripts/onboarding.py list-plans` → 有 AskUserQuestion 就弹菜单，否则输出编号清单让用户选\n- 校验 `plan_id` ∈ 清单、支付方式 ∈ 该套餐 `available_methods`（通常 `wechat/alipay`）\n- `python scripts/onboarding.py order <plan_id> <method>` → 展示优先级 PNG > `pay_url` > `ascii_qr`（标注兜底）\n- 已付款可选调 `python scripts/onboarding.py query <order_id>`，不主动轮询\n\n排除 `errcode=403`（无权限，不归入这两类）。所有子命令输出 stdout JSON，`error` 字段已含阶段前缀，透传给用户即可。完整用法：`python scripts/onboarding.py --help`。\n\nFile v1.0.5:skill-card.md\n\n## Description:\n\nSearches 1688 by product image to find visually similar or matching supplier listings with core sourcing data such as title, price, minimum order quantity, monthly sales, repurchase rate, trade score, and seller badges.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[linkfox-ai](https://clawhub.ai/user/linkfox-ai)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal sellers, sourcing teams, and agent users use this skill to locate visually similar 1688 wholesale products from a public image URL, uploaded local image, image ID, or raw Base64 image. It helps compare supplier listings by price, sales volume, order quantity, service score, repurchase rate, delivery details, and seller badges.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Image URLs, uploaded local images, search parameters, API keys, onboarding data, account actions, billing requests, and feedback content may be sent to LinkFox services.\n\nMitigation: Use the skill only with images and account data approved for third-party processing, avoid confidential product imagery, and review authentication, feedback, and billing flows before installation.\n\nRisk: Local image files can be uploaded to a public URL for 24 hours before search.\n\nMitigation: Prefer already public image URLs when appropriate, and upload local files only after confirming the image can be publicly accessible for the validity window.\n\nRisk: The skill persists full API responses and cache data under a local linkfox session directory.\n\nMitigation: Review generated response files for sensitive sourcing data, manage local retention, and clear the linkfox cache/session data when no longer needed.\n\nRisk: Search calls consume LinkFox credits and onboarding can initiate payment flows.\n\nMitigation: Confirm expected credit usage with the user before repeated searches, validate plan and payment choices, and avoid automatic retries that increase cost.\n\n## Reference(s):\n\n- [1688-以图搜图 ClawHub page](https://clawhub.ai/linkfox-ai/skills/linkfox-1688-search-by-image)\n- [API reference](references/api.md)\n- [Authentication and billing onboarding](references/onboarding.md)\n- [LinkFox Skills](https://skill.linkfox.com/)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, shell commands, configuration, JSON files]\n\n**Output Format:** [Markdown summaries and tables, shell command snippets, and saved JSON response files]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Writes full API responses under a local linkfox session directory, may print compact summaries for large responses, and can emit public image URLs after upload.]\n\n## Skill Version(s):\n\n1.0.5 (source: server release metadata)\n\n## Ethical Considerations:\n\nUsers 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 deployment.\n\nArchive v1.0.4: 6 files, 18311 bytes\n\nFiles: references/api.md (8786b), scripts/alibaba1688_image_search.py (12725b), scripts/upload_image.py (4591b), skill-card.md (2553b), SKILL.md (12570b), _meta.json (147b)\n\nFile v1.0.4:SKILL.md\n\n---\nname: linkfox-1688-search-by-image\ndescription: 1688平台以图搜图，通过商品图片精准检索外观相似或同款的1688货源，返回标题、价格、起批量、月销量、复购率、交易评分等核心数据。当用户提到1688以图搜图、1688找货源、以图找同款、跨境找工厂、1688识图、图片找货源、找相似货源、image search 1688、find supplier by image时触发此技能。即使用户未明确提及\"以图搜图\"，只要用户提供了图片URL并希望在1688上查找匹配或相似的货源商品，也应触发此技能。\n---\n\n# 1688 Image-Based Product Search\n\nThis skill performs visual product searches on the 1688 platform using an image URL, helping cross-border sellers find visually similar supplier products for sourcing.\n\n## Core Concepts\n\n1688 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.\n\n## Data Fields\n\n| Field | Description |\n|-------|-------------|\n| offerId | Product ID on 1688 |\n| title | Product title |\n| imageUrl | Product main image |\n| price | Wholesale price (CNY) |\n| consignPrice | Dropship price (CNY) |\n| salesQuantity | Monthly sales volume |\n| estimatedSalesAmount | Estimated monthly revenue |\n| quantityBegin | Minimum order quantity |\n| repurchaseRate | Repurchase rate |\n| tradeScore | Product trade score |\n| compositeServiceScore | Composite service experience score |\n| sellerIdentities | Seller identity (超级工厂/实力商家/诚信通会员) |\n| offerIdentities | Product badge (严选) |\n| sendGoodsAddressText | Shipping origin |\n| deliveryTime | Delivery time (24/48 hours) |\n| isOnePsale | Supports dropshipping (是/否) |\n| isJxhy | Premium sourcing (是/否) |\n| hasPromotion | Has promotion (是/否) |\n| isPatentProduct | Patent product (是/否) |\n\n## Parameter Guide\n\n**Image Rules:**\n1. Only png, jpg, jpeg formats are supported. webp, gif, and other formats are NOT supported.\n2. Base64 string must be pure encoded content WITHOUT the `data:image/jpeg;base64,` prefix.\n3. Image source — one of imageUrl, imageBase64, or imageId must be provided (at least one required).\n\n| Parameter | Required | Default | Description |\n|-----------|----------|---------|-------------|\n| imageUrl | Conditional | - | Public image URL (max 1000 chars). Only png/jpg/jpeg formats supported |\n| imageBase64 | Conditional | - | Pure Base64 encoded image string, without `data:image/...;base64,` prefix. Only png/jpg/jpeg supported |\n| imageId | Conditional | - | 1688 image ID from previous search result (speeds up pagination) |\n| page | No | 1 | Page number, starting from 1 |\n| pageSize | No | 20 | Results per page (1-50) |\n| priceStart | No | - | Min price filter (CNY) |\n| priceEnd | No | - | Max price filter (CNY) |\n| filter | No | - | Filter conditions, comma-separated (see supported filters below) |\n| sort | No | {\"monthSold\":\"desc\"} | Sort as JSON: {field: direction} (see supported sort fields below) |\n| keyword | No | - | Keyword to further filter results |\n| productCollectionId | No | - | Product collection ID (see supported IDs below) |\n\n### Supported Filters\n\nMultiple filters can be combined with commas (e.g. `1688Selection,totalEpScoreLv1,qrr0`).\n\n| Filter Value | Description |\n|--------------|-------------|\n| 1688Selection | 1688严选 |\n| certifiedFactory | 认证工厂 |\n| totalEpScoreLv1 | 综合体验分5星 |\n| totalEpScoreLv2 | 综合体验分4星 |\n| totalEpScoreLv3 | 综合体验分3星 |\n| totalEpScoreLv4 | 综合体验分2星 |\n| qrr0 | 无品质退款 |\n| qrr1 | 品质退款率<1% |\n| qrr5 | 品质退款率<5% |\n| qrr10 | 品质退款率<10% |\n| shipInToday | 当日发货 |\n| shipIn24Hours | 24小时发货 |\n| shipIn48Hours | 48小时发货 |\n| noReason7DReturn | 7天无理由退货 |\n| isOnePsale | 一件代发 |\n| isOnePsaleFreePost | 一件代发包邮 |\n| new7 | 7天内新品 |\n| new30 | 30天内新品 |\n| isQqyx | 全球严选 |\n| JPFL | 日本专线 |\n| USFL | 美国专线 |\n| KRFL | 韩国专线 |\n| VNFL | 越南专线 |\n| SAFL | 沙特专线 |\n| RUFL | 俄罗斯专线 |\n| KZFL | 哈萨克斯坦专线 |\n| HKFL | 香港专线 |\n| MOFL | 澳门专线 |\n| TWFL | 台湾专线 |\n\n### Supported Sort Fields\n\n| Field | Direction | Description |\n|-------|-----------|-------------|\n| price | asc/desc | Price ascending/descending |\n| monthSold | asc/desc | Monthly sales ascending/descending |\n| rePurchaseRate | asc/desc | Repurchase rate ascending/descending |\n\nSort format example: `{\"price\":\"asc\"}` for price low to high.\n\n### Supported Product Collection IDs\n\n| ID | Usage |\n|----|-------|\n| 262105288 | 跨境货盘 |\n| 262105286 | 跨境货盘 |\n| 262105253 | 跨境货盘 |\n| 262105281 | 跨境货盘 |\n| 262105280 | 跨境货盘 |\n| 262105277 | 跨境货盘 |\n| 262105276 | 跨境货盘 |\n| 262105274 | 跨境货盘 |\n| 262105269 | 跨境货盘 |\n| 262185282 | 跨境货盘 |\n\n## 调用方式\n\n- **API 端点**：`POST /alibaba1688/imageSearch`（完整参数/响应/错误码见 `references/api.md`）\n- **Python 脚本**：`python scripts/alibaba1688_image_search.py '<JSON 参数>' [--inline]`\n- **成本约束**：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。\n\n**输出策略（脚本默认行为）**：\n- **始终**将完整响应写入 `<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-1688-search-by-image-<timestamp>.json`（`<cwd>` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`<session>` 取自环境变量 `SESSION_ID`，按用户任务自动聚合；**禁止写入 /tmp**，当前目录不可写则报错）\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段的长度 + 前 3 条样本）\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\n\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq`或`ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\n\n## 解决认证和积分问题\n发生以下异常情况时，采用以下措施来处理：\n\n### 异常情况\n- **未配置API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\n- **响应401或402状态码**\n- **响应提示积分或余额不足**：消息含\"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值\"，或类似含义的内容。\n\n### 措施\n- 优先采用skill内的 onboarding.md 引导解决问题。\n- 如找不到 onboarding.md 文件，则加载 /linkfox-onboarding 这个skill并根据它的引导来处理。如未安装请先安装：\n    - 下载 https://agent-files.linkfox.com/skills/linkfox-onboarding/release.zip，解压后安装这个skill。如需用户授权才可下载，要询问用户获得授权，你不能自己放弃下载。\n- 兜底措施：仅当前面两个措施经过所有努力都走不通时，才提示用户依据 https://skill.linkfox.com/linkfoxskills/guide.htm 指引获取API Key，或去 https://os.linkfox.com/ 补充积分。\n\n## Local Image Upload\n\nThis tool requires a **publicly accessible image URL**. If the user provides a local image file path, you must upload it first to obtain a public URL.\n\nRun the upload script:\n```bash\npython scripts/upload_image.py /path/to/local/image.png\n```\n\nThe script will return a public URL (valid for 24 hours) that can be used as the imageUrl parameter.\n\n## Usage Examples\n\n**1. Basic image search**\n```\n在1688搜索与图片相似的商品，图片地址为 https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg\n```\n\n**2. Search with filters**\n```\n在1688搜索与图片相似的商品，图片地址为 https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg，查询第1页，筛选1688严选，并按价格从高到低排序\n```\n\n**3. Search with sorting**\n```\n在1688搜索与图片相似的商品，图片地址为 https://example.com/product.jpg，按价格从高到低排序\n```\n\n**4. Paginated search**\n```\n在1688搜索与图片相似的商品，图片地址为 https://example.com/product.jpg，查询第2页，每页50条\n```\n\n**5. Price range filter**\n```\n在1688搜索与图片相似的商品，图片地址为 https://example.com/product.jpg，价格区间10-100元\n```\n\n## Display Rules\n\n1. **Present data clearly**: Show results in a structured table with key columns: product image, title, price, dropship price, monthly sales, minimum order quantity, repurchase rate, and seller identity\n2. **Image display**: When the response includes imageUrl for products, display them inline for visual comparison\n3. **Price display**: Always show price in CNY (¥) format\n4. **Seller badges**: Display seller identity badges (超级工厂/实力商家/诚信通会员) and product badges (严选) prominently\n5. **Result count**: Always inform the user of total results and current page/total pages\n6. **Pagination hint**: When more pages are available, suggest the user can request the next page\n7. **Filter/sort limitation**: If the user requests a sort or filter not in the supported list, do NOT attempt any workaround. Inform the user of the supported options\n8. **No secondary processing**: Results are real-time and not stored in a database, so secondary SQL/data processing is not available\n\n## Important Limitations\n\n1. **Data real-time nature**: Results are live searches, not stored in any database. Cannot use `_dataQuery_executeDynamicQuery` for secondary processing.\n2. **Logic constraint**: If the user requests sort or filter conditions not in the preset supported list, do NOT call any other tool or logic to compensate.\n3. **Image input**: One of imageUrl, imageBase64, or imageId is required. For page > 1, prefer passing imageId from the first page result to speed up queries.\n4. **Image format**: Only png, jpg, jpeg are supported. webp, gif, and other formats will be rejected.\n5. **Base64 format**: The imageBase64 value must be the raw Base64 string only — do NOT include the `data:image/jpeg;base64,` prefix.\n6. **Page size**: Maximum 50 results per page.\n\n## User Expression & Scenario Quick Reference\n\n**Applicable** -- Visual product sourcing scenarios on 1688:\n\n| User Says | Scenario |\n|-----------|----------|\n| \"1688以图搜图\" / \"用图片找1688货源\" | Basic image search |\n| \"帮我在1688找这个图片的同款\" | Find same-style products |\n| \"跨境找工厂，图片是...\" | Cross-border supplier sourcing |\n| \"这个Amazon产品在1688有没有货源\" | Reverse sourcing from Amazon image |\n| \"筛选1688严选的相似商品\" | Filtered image search |\n| \"按月销量排序找相似货源\" | Sorted image search |\n| \"查看第2页结果\" | Pagination |\n\n**Not applicable** -- Needs beyond 1688 image search:\n\n- Text/keyword-based 1688 search (use 店雷达-1688选品库)\n- 1688 product rankings/trending (use 店雷达-1688商品榜单)\n- Amazon image search (use 亚马逊前端-以图搜图)\n- Image generation or editing\n- Product review analysis\n- Price history or trend analysis\n\n**Boundary judgment**: When users say \"找货源\" or \"找同款\", if they provide an image URL and the intent is to find visually similar products on 1688, this skill applies. If they want keyword-based search or ranking data on 1688, use the 店雷达 tools instead.\n\n## 积分消耗规则\n\n消耗 4.5 积分。\n\n> 用户会因积分消耗而支付费用。请充分评估：当需要高频调用本技能，或用户对积分消耗量预期不足时，务必提醒用户，由用户决定是否继续。\n\n**Feedback:**\n\nAuto-detect and report feedback via the Feedback API when any of the following apply:\n1. The functionality or purpose described in this skill does not match actual behavior\n2. The skill's results do not match the user's intent\n3. The user expresses dissatisfaction or praise about this skill\n4. Anything you believe could be improved\n\nCall the feedback API as specified in `references/api.md`. Do not interrupt the user's flow.\n\n---\n*For more high-quality, professional cross-border e-commerce skills, visit [LinkFox Skills](https://skill.linkfox.com/).*\n\nFile v1.0.4:_meta.json\n\n{\n  \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n  \"slug\": \"linkfox-1688-search-by-image\",\n  \"version\": \"1.0.4\",\n  \"publishedAt\": 1783944051857\n}\n\nFile v1.0.4:references/api.md\n\n# 1688-以图搜图 API 参考\n\n## 调用规范\n\n- **请求地址**：`${LINKFOX_TOOL_GATEWAY}/alibaba1688/imageSearch`\n- **请求方式**：POST，Content-Type: application/json\n- **认证方式**：Header `Authorization: <api_key>`，api_key 优先从环境变量 `LINKFOX_AGENT_API_KEY` 读取，回退 `LINKFOXAGENT_API_KEY`（如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理）\n- **User-Agent**：`LinkFox-Skill/1.0`\n- **超时**：60s\n\n## 请求参数\n\nPOST Body（JSON）：\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| imageUrl | string | 条件必填 | - | 图片URL地址，请确保图片URL有效且可公开访问。最大长度：1000。仅支持 png/jpg/jpeg 格式，不支持 webp/gif 等。imageUrl/imageBase64/imageId 三选一必填 |\n| imageBase64 | string | 条件必填 | - | 图片 Base64 编码字符串，为纯编码内容，不包含 `data:image/jpeg;base64,` 前缀。仅支持 png/jpg/jpeg 格式（imageUrl为空时使用） |\n| imageId | string | 条件必填 | - | 图片ID（1688图片ID），以图搜图查询结果中也会返回，建议当分页 page>1 查询时带 imageId，加快响应速度 |\n| page | int | 否 | 1 | 页码，从1开始 |\n| pageSize | int | 否 | 20 | 每页返回的商品数量，最大不超过50 |\n| priceStart | string | 否 | - | 价格筛选起始值（人民币），如 10 |\n| priceEnd | string | 否 | - | 价格筛选结束值（人民币），如 100 |\n| filter | string | 否 | - | 过滤条件，多个条件用逗号分隔。有效值见下方「支持的过滤条件」 |\n| sort | string | 否 | {\"monthSold\":\"desc\"} | 排序条件，JSON格式 {排序字段: 排序方式}。有效字段：price、rePurchaseRate、monthSold；方式：asc/desc |\n| keyword | string | 否 | - | 关键词，在结果中搜索 |\n| productCollectionId | string | 否 | - | 货盘ID，单选。有效值见下方「支持的货盘ID」 |\n\n### 支持的过滤条件\n\n多个条件用逗号分隔，如 `1688Selection,totalEpScoreLv1,qrr0`。\n\n| 值 | 说明 |\n|----|------|\n| 1688Selection | 1688严选 |\n| certifiedFactory | 认证工厂 |\n| totalEpScoreLv1 | 综合体验分5星 |\n| totalEpScoreLv2 | 综合体验分4星 |\n| totalEpScoreLv3 | 综合体验分3星 |\n| totalEpScoreLv4 | 综合体验分2星 |\n| qrr0 | 无品质退款 |\n| qrr1 | 品质退款率<1% |\n| qrr5 | 品质退款率<5% |\n| qrr10 | 品质退款率<10% |\n| shipInToday | 当日发货 |\n| shipIn24Hours | 24小时发货 |\n| shipIn48Hours | 48小时发货 |\n| noReason7DReturn | 7天无理由退货 |\n| isOnePsale | 一件代发 |\n| isOnePsaleFreePost | 一件代发包邮 |\n| new7 | 7天内新品 |\n| new30 | 30天内新品 |\n| isQqyx | 全球严选 |\n| JPFL | 日本专线 |\n| USFL | 美国专线 |\n| KRFL | 韩国专线 |\n| VNFL | 越南专线 |\n| SAFL | 沙特专线 |\n| RUFL | 俄罗斯专线 |\n| KZFL | 哈萨克斯坦专线 |\n| HKFL | 香港专线 |\n| MOFL | 澳门专线 |\n| TWFL | 台湾专线 |\n\n### 支持的排序字段\n\n| 字段 | 说明 |\n|------|------|\n| price | 价格 |\n| monthSold | 月销量 |\n| rePurchaseRate | 复购率 |\n\n排序方式：`asc`（升序）、`desc`（降序）。格式示例：`{\"price\":\"asc\"}`\n\n### 支持的货盘ID\n\n| ID | 说明 |\n|----|------|\n| 262105288 | 跨境货盘 |\n| 262105286 | 跨境货盘 |\n| 262105253 | 跨境货盘 |\n| 262105281 | 跨境货盘 |\n| 262105280 | 跨境货盘 |\n| 262105277 | 跨境货盘 |\n| 262105276 | 跨境货盘 |\n| 262105274 | 跨境货盘 |\n| 262105269 | 跨境货盘 |\n| 262185282 | 跨境货盘 |\n\n## 响应结构\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| imageId | string | 上传后的图片ID（分页查询时回传可加速） |\n| total | integer | 本页商品数量 |\n| totalPage | integer | 总页数 |\n| sourceType | string | 来源类型（固定值 \"1688\"） |\n| type | string | 渲染样式（固定值 \"productWorkbenches\"） |\n| columns | array | 渲染列定义 |\n| costToken | integer | 消耗 token |\n| products | array | 商品列表（详见下方商品字段） |\n\n### 商品字段\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| offerId | string | 商品ID |\n| asin | string | 商品编号（同 offerId） |\n| imageUrl | string | 商品图片 |\n| title | string | 商品标题 |\n| price | number | 批发价（元） |\n| consignPrice | number | 一件代发价（元） |\n| salesQuantity | integer | 月销售件数 |\n| estimatedSalesAmount | number | 预估销售额 |\n| asinUrl | string | 商品链接 |\n| isOnePsale | string | 是否一件代发（是/否） |\n| isJxhy | string | 是否精选货源（是/否） |\n| sellerIdentities | string | 商家身份（超级工厂/实力商家/诚信通会员） |\n| offerIdentities | string | 商品标（严选） |\n| repurchaseRate | string | 复购率 |\n| tradeScore | string | 商品交易评分 |\n| compositeServiceScore | string | 综合服务体验分 |\n| sendGoodsAddressText | string | 发货地 |\n| deliveryTime | string | 发货时间（24/48小时） |\n| quantityBegin | integer | 起批量 |\n| hasPromotion | string | 是否有营销活动（是/否） |\n| promotionType | string | 营销类型 |\n| isPatentProduct | string | 是否专利商品（是/否） |\n| isSelect | string | 跨境select货盘标识 |\n| currency | string | 币种（固定值 \"¥\"） |\n| sourceType | string | 来源类型（固定值 \"1688\"） |\n| sourceTool | string | 来源工具（固定值 \"1688以图搜图\"） |\n| dataType | string | 数据类型（固定值 \"monthlyData\"） |\n\n## 错误码\n\n正常情况下，接口的 HTTP 状态码均为 200，业务的成功与否通过响应体中的 errorCode 字段区分（errorCode = 200 表示成功，其他值表示业务错误）。当遇到未授权等情况时，HTTP 状态码为 401，且对应的 errorCode 也是 401。\n\n| errcode | 含义 | 处理建议 |\n|---------|------|----------|\n| 200 | 成功 | 正常解析业务字段 |\n| 401 | 认证失败 | HTTP 401 或 authorized error：按 SKILL.md 的 **## 解决认证和积分问题** 处理。 |\n| 402 | 积分不足 | HTTP 402：按 SKILL.md 的 **## 解决认证和积分问题** 处理。 |\n| 其他非200值 | 业务异常 | 参考 `errmsg` 字段获取具体错误原因 |\n\n错误响应示例：\n\n```json\n{\n    \"errcode\": 401,\n    \"errmsg\": \"authorized error\"\n}\n```\n\n## curl 示例\n\n### 基础以图搜图\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/alibaba1688/imageSearch \\\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"User-Agent: LinkFox-Skill/1.0\" \\\n  -d '{\n    \"imageUrl\": \"https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg\",\n    \"page\": 1,\n    \"pageSize\": 20\n  }'\n```\n\n### 带筛选和排序\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/alibaba1688/imageSearch \\\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"User-Agent: LinkFox-Skill/1.0\" \\\n  -d '{\n    \"imageUrl\": \"https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg\",\n    \"page\": 1,\n    \"pageSize\": 20,\n    \"filter\": \"1688Selection,totalEpScoreLv1,qrr0\",\n    \"sort\": \"{\\\"price\\\":\\\"desc\\\"}\"\n  }'\n```\n\n### 分页查询（使用 imageId）\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/alibaba1688/imageSearch \\\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"User-Agent: LinkFox-Skill/1.0\" \\\n  -d '{\n    \"imageId\": \"abc123456\",\n    \"page\": 2,\n    \"pageSize\": 20\n  }'\n```\n\n### 价格区间筛选\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/alibaba1688/imageSearch \\\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"User-Agent: LinkFox-Skill/1.0\" \\\n  -d '{\n    \"imageUrl\": \"https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg\",\n    \"page\": 1,\n    \"pageSize\": 20,\n    \"priceStart\": \"10\",\n    \"priceEnd\": \"100\"\n  }'\n```\n\n---\n\n## Feedback API\n\n> This endpoint is **separate** from the tool API above. Do not mix the two base URLs.\n\n- **POST** `https://skill-api.linkfox.com/api/v1/public/feedback`\n- **Content-Type:** `application/json`\n\n```json\n{\n  \"skillName\": \"linkfox-1688-search-by-image\",\n  \"sentiment\": \"POSITIVE\",\n  \"category\": \"OTHER\",\n  \"content\": \"Results were accurate, user was satisfied.\"\n}\n```\n\n**Field rules:**\n- `skillName`: Use this skill's `name` from the YAML frontmatter (`linkfox-1688-search-by-image`)\n- `sentiment`: Choose ONE — `POSITIVE` (praise), `NEUTRAL` (suggestion without emotion), `NEGATIVE` (complaint or error)\n- `category`: Choose ONE — `BUG` (malfunction or wrong data), `COMPLAINT` (user dissatisfaction), `SUGGESTION` (improvement idea), `OTHER`\n- `content`: Include what the user said or intended, what actually happened, and why it is a problem or praise\n\nFile v1.0.4:skill-card.md\n\n## Description: <br>\nSearches 1688 by product image and returns visually similar supplier listings with prices, minimum order quantities, sales, seller badges, and trade metrics. <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[linkfox-ai](https://clawhub.ai/user/linkfox-ai) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nExternal sourcing teams and agents use this skill to find visually similar products on 1688 from a public image URL, local uploaded image, Base64 image, or returned image ID. It helps compare supplier listings by price, minimum order quantity, monthly sales, repurchase rate, seller badges, and trade score. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: Local product images may be uploaded to a publicly reachable URL for search. <br>\nMitigation: Use non-sensitive images, confirm the user is comfortable with public upload before searching local files, and treat generated image URLs as temporary shared data. <br>\nRisk: Search requests are sent through LinkFox/1688 services using configured credentials and gateway endpoints. <br>\nMitigation: Verify LINKFOX_AGENT_API_KEY or LINKFOXAGENT_API_KEY and the gateway configuration before use, and avoid entering credentials into untrusted prompts. <br>\nRisk: Full API responses are persisted locally and may contain detailed search results. <br>\nMitigation: Review where response files are written, keep them out of shared workspaces when results are sensitive, and delete saved files when no longer needed. <br>\n\n\n## Reference(s): <br>\n- [ClawHub skill page](https://clawhub.ai/linkfox-ai/skills/linkfox-1688-search-by-image) <br>\n- [1688 image search API reference](references/api.md) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [Text, Markdown, JSON, Files, Shell commands, Guidance] <br>\n**Output Format:** [Markdown summaries and tables with saved JSON response files] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [Large responses are summarized while full API responses are saved under the LinkFox session data directory; product results may include inline image URLs.] <br>\n\n## Skill Version(s): <br>\n1.0.4 (source: server release evidence) <br>\n\n## Ethical Considerations: <br>\nUsers 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 deployment. <br>\n\nArchive v1.0.3: 5 files, 16290 bytes\n\nFiles: references/api.md (8757b), scripts/alibaba1688_image_search.py (12806b), scripts/upload_image.py (4755b), SKILL.md (11241b), _meta.json (147b)\n\nFile v1.0.3:SKILL.md\n\n---\nname: linkfox-1688-search-by-image\ndescription: 1688平台以图搜图，通过商品图片精准检索外观相似或同款的1688货源，返回标题、价格、起批量、月销量、复购率、交易评分等核心数据。当用户提到1688以图搜图、1688找货源、以图找同款、跨境找工厂、1688识图、图片找货源、找相似货源、image search 1688、find supplier by image时触发此技能。即使用户未明确提及\"以图搜图\"，只要用户提供了图片URL并希望在1688上查找匹配或相似的货源商品，也应触发此技能。\n---\n\n# 1688 Image-Based Product Search\n\nThis skill performs visual product searches on the 1688 platform using an image URL, helping cross-border sellers find visually similar supplier products for sourcing.\n\n## Core Concepts\n\n1688 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.\n\n## Data Fields\n\n| Field | Description |\n|-------|-------------|\n| offerId | Product ID on 1688 |\n| title | Product title |\n| imageUrl | Product main image |\n| price | Wholesale price (CNY) |\n| consignPrice | Dropship price (CNY) |\n| salesQuantity | Monthly sales volume |\n| estimatedSalesAmount | Estimated monthly revenue |\n| quantityBegin | Minimum order quantity |\n| repurchaseRate | Repurchase rate |\n| tradeScore | Product trade score |\n| compositeServiceScore | Composite service experience score |\n| sellerIdentities | Seller identity (超级工厂/实力商家/诚信通会员) |\n| offerIdentities | Product badge (严选) |\n| sendGoodsAddressText | Shipping origin |\n| deliveryTime | Delivery time (24/48 hours) |\n| isOnePsale | Supports dropshipping (是/否) |\n| isJxhy | Premium sourcing (是/否) |\n| hasPromotion | Has promotion (是/否) |\n| isPatentProduct | Patent product (是/否) |\n\n## Parameter Guide\n\n**Image Rules:**\n1. Only png, jpg, jpeg formats are supported. webp, gif, and other formats are NOT supported.\n2. Base64 string must be pure encoded content WITHOUT the `data:image/jpeg;base64,` prefix.\n3. Image source — one of imageUrl, imageBase64, or imageId must be provided (at least one required).\n\n| Parameter | Required | Default | Description |\n|-----------|----------|---------|-------------|\n| imageUrl | Conditional | - | Public image URL (max 1000 chars). Only png/jpg/jpeg formats supported |\n| imageBase64 | Conditional | - | Pure Base64 encoded image string, without `data:image/...;base64,` prefix. Only png/jpg/jpeg supported |\n| imageId | Conditional | - | 1688 image ID from previous search result (speeds up pagination) |\n| page | No | 1 | Page number, starting from 1 |\n| pageSize | No | 20 | Results per page (1-50) |\n| priceStart | No | - | Min price filter (CNY) |\n| priceEnd | No | - | Max price filter (CNY) |\n| filter | No | - | Filter conditions, comma-separated (see supported filters below) |\n| sort | No | {\"monthSold\":\"desc\"} | Sort as JSON: {field: direction} (see supported sort fields below) |\n| keyword | No | - | Keyword to further filter results |\n| productCollectionId | No | - | Product collection ID (see supported IDs below) |\n\n### Supported Filters\n\nMultiple filters can be combined with commas (e.g. `1688Selection,totalEpScoreLv1,qrr0`).\n\n| Filter Value | Description |\n|--------------|-------------|\n| 1688Selection | 1688严选 |\n| certifiedFactory | 认证工厂 |\n| totalEpScoreLv1 | 综合体验分5星 |\n| totalEpScoreLv2 | 综合体验分4星 |\n| totalEpScoreLv3 | 综合体验分3星 |\n| totalEpScoreLv4 | 综合体验分2星 |\n| qrr0 | 无品质退款 |\n| qrr1 | 品质退款率<1% |\n| qrr5 | 品质退款率<5% |\n| qrr10 | 品质退款率<10% |\n| shipInToday | 当日发货 |\n| shipIn24Hours | 24小时发货 |\n| shipIn48Hours | 48小时发货 |\n| noReason7DReturn | 7天无理由退货 |\n| isOnePsale | 一件代发 |\n| isOnePsaleFreePost | 一件代发包邮 |\n| new7 | 7天内新品 |\n| new30 | 30天内新品 |\n| isQqyx | 全球严选 |\n| JPFL | 日本专线 |\n| USFL | 美国专线 |\n| KRFL | 韩国专线 |\n| VNFL | 越南专线 |\n| SAFL | 沙特专线 |\n| RUFL | 俄罗斯专线 |\n| KZFL | 哈萨克斯坦专线 |\n| HKFL | 香港专线 |\n| MOFL | 澳门专线 |\n| TWFL | 台湾专线 |\n\n### Supported Sort Fields\n\n| Field | Direction | Description |\n|-------|-----------|-------------|\n| price | asc/desc | Price ascending/descending |\n| monthSold | asc/desc | Monthly sales ascending/descending |\n| rePurchaseRate | asc/desc | Repurchase rate ascending/descending |\n\nSort format example: `{\"price\":\"asc\"}` for price low to high.\n\n### Supported Product Collection IDs\n\n| ID | Usage |\n|----|-------|\n| 262105288 | 跨境货盘 |\n| 262105286 | 跨境货盘 |\n| 262105253 | 跨境货盘 |\n| 262105281 | 跨境货盘 |\n| 262105280 | 跨境货盘 |\n| 262105277 | 跨境货盘 |\n| 262105276 | 跨境货盘 |\n| 262105274 | 跨境货盘 |\n| 262105269 | 跨境货盘 |\n| 262185282 | 跨境货盘 |\n\n## 调用方式\n\n- **API 端点**：`POST /alibaba1688/imageSearch`（完整参数/响应/错误码见 `references/api.md`）\n- **Python 脚本**：`python scripts/alibaba1688_image_search.py '<JSON 参数>' [--inline]`\n- **成本约束**：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。\n\n**输出策略（脚本默认行为）**：\n- **始终**将完整响应写入 `<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-1688-search-by-image-<timestamp>.json`（`<cwd>` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`<session>` 取自环境变量 `SESSION_ID`，按用户任务自动聚合；**禁止写入 /tmp**，当前目录不可写则报错）\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段的长度 + 前 3 条样本）\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\n\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq`或`ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\n\n## Local Image Upload\n\nThis tool requires a **publicly accessible image URL**. If the user provides a local image file path, you must upload it first to obtain a public URL.\n\nRun the upload script:\n```bash\npython scripts/upload_image.py /path/to/local/image.png\n```\n\nThe script will return a public URL (valid for 24 hours) that can be used as the imageUrl parameter.\n\n## Usage Examples\n\n**1. Basic image search**\n```\n在1688搜索与图片相似的商品，图片地址为 https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg\n```\n\n**2. Search with filters**\n```\n在1688搜索与图片相似的商品，图片地址为 https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg，查询第1页，筛选1688严选，并按价格从高到低排序\n```\n\n**3. Search with sorting**\n```\n在1688搜索与图片相似的商品，图片地址为 https://example.com/product.jpg，按价格从高到低排序\n```\n\n**4. Paginated search**\n```\n在1688搜索与图片相似的商品，图片地址为 https://example.com/product.jpg，查询第2页，每页50条\n```\n\n**5. Price range filter**\n```\n在1688搜索与图片相似的商品，图片地址为 https://example.com/product.jpg，价格区间10-100元\n```\n\n## Display Rules\n\n1. **Present data clearly**: Show results in a structured table with key columns: product image, title, price, dropship price, monthly sales, minimum order quantity, repurchase rate, and seller identity\n2. **Image display**: When the response includes imageUrl for products, display them inline for visual comparison\n3. **Price display**: Always show price in CNY (¥) format\n4. **Seller badges**: Display seller identity badges (超级工厂/实力商家/诚信通会员) and product badges (严选) prominently\n5. **Result count**: Always inform the user of total results and current page/total pages\n6. **Pagination hint**: When more pages are available, suggest the user can request the next page\n7. **Filter/sort limitation**: If the user requests a sort or filter not in the supported list, do NOT attempt any workaround. Inform the user of the supported options\n8. **No secondary processing**: Results are real-time and not stored in a database, so secondary SQL/data processing is not available\n\n## Important Limitations\n\n1. **Data real-time nature**: Results are live searches, not stored in any database. Cannot use `_dataQuery_executeDynamicQuery` for secondary processing.\n2. **Logic constraint**: If the user requests sort or filter conditions not in the preset supported list, do NOT call any other tool or logic to compensate.\n3. **Image input**: One of imageUrl, imageBase64, or imageId is required. For page > 1, prefer passing imageId from the first page result to speed up queries.\n4. **Image format**: Only png, jpg, jpeg are supported. webp, gif, and other formats will be rejected.\n5. **Base64 format**: The imageBase64 value must be the raw Base64 string only — do NOT include the `data:image/jpeg;base64,` prefix.\n6. **Page size**: Maximum 50 results per page.\n\n## User Expression & Scenario Quick Reference\n\n**Applicable** -- Visual product sourcing scenarios on 1688:\n\n| User Says | Scenario |\n|-----------|----------|\n| \"1688以图搜图\" / \"用图片找1688货源\" | Basic image search |\n| \"帮我在1688找这个图片的同款\" | Find same-style products |\n| \"跨境找工厂，图片是...\" | Cross-border supplier sourcing |\n| \"这个Amazon产品在1688有没有货源\" | Reverse sourcing from Amazon image |\n| \"筛选1688严选的相似商品\" | Filtered image search |\n| \"按月销量排序找相似货源\" | Sorted image search |\n| \"查看第2页结果\" | Pagination |\n\n**Not applicable** -- Needs beyond 1688 image search:\n\n- Text/keyword-based 1688 search (use 店雷达-1688选品库)\n- 1688 product rankings/trending (use 店雷达-1688商品榜单)\n- Amazon image search (use 亚马逊前端-以图搜图)\n- Image generation or editing\n- Product review analysis\n- Price history or trend analysis\n\n**Boundary judgment**: When users say \"找货源\" or \"找同款\", if they provide an image URL and the intent is to find visually similar products on 1688, this skill applies. If they want keyword-based search or ranking data on 1688, use the 店雷达 tools instead.\n\n**Feedback:**\n\nAuto-detect and report feedback via the Feedback API when any of the following apply:\n1. The functionality or purpose described in this skill does not match actual behavior\n2. The skill's results do not match the user's intent\n3. The user expresses dissatisfaction or praise about this skill\n4. Anything you believe could be improved\n\nCall the feedback API as specified in `references/api.md`. Do not interrupt the user's flow.\n\n---\n*For more high-quality, professional cross-border e-commerce skills, visit [LinkFox Skills](https://skill.linkfox.com/).*\n\nFile v1.0.3:_meta.json\n\n{\n  \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n  \"slug\": \"linkfox-1688-search-by-image\",\n  \"version\": \"1.0.3\",\n  \"publishedAt\": 1783336005427\n}\n\nFile v1.0.3:references/api.md\n\n# 1688-以图搜图 API 参考\n\n## 调用规范\n\n- **请求地址**：`${LINKFOX_TOOL_GATEWAY}/alibaba1688/imageSearch`\n- **请求方式**：POST，Content-Type: application/json\n- **认证方式**：Header `Authorization: <api_key>`，api_key 优先从环境变量 `LINKFOX_AGENT_API_KEY` 读取，回退 `LINKFOXAGENT_API_KEY`（如未配置，提示用户前往 https://skill.linkfox.com/linkfoxskills/guide.htm 申请）\n- **User-Agent**：`LinkFox-Skill/1.0`\n- **超时**：60s\n\n## 请求参数\n\nPOST Body（JSON）：\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| imageUrl | string | 条件必填 | - | 图片URL地址，请确保图片URL有效且可公开访问。最大长度：1000。仅支持 png/jpg/jpeg 格式，不支持 webp/gif 等。imageUrl/imageBase64/imageId 三选一必填 |\n| imageBase64 | string | 条件必填 | - | 图片 Base64 编码字符串，为纯编码内容，不包含 `data:image/jpeg;base64,` 前缀。仅支持 png/jpg/jpeg 格式（imageUrl为空时使用） |\n| imageId | string | 条件必填 | - | 图片ID（1688图片ID），以图搜图查询结果中也会返回，建议当分页 page>1 查询时带 imageId，加快响应速度 |\n| page | int | 否 | 1 | 页码，从1开始 |\n| pageSize | int | 否 | 20 | 每页返回的商品数量，最大不超过50 |\n| priceStart | string | 否 | - | 价格筛选起始值（人民币），如 10 |\n| priceEnd | string | 否 | - | 价格筛选结束值（人民币），如 100 |\n| filter | string | 否 | - | 过滤条件，多个条件用逗号分隔。有效值见下方「支持的过滤条件」 |\n| sort | string | 否 | {\"monthSold\":\"desc\"} | 排序条件，JSON格式 {排序字段: 排序方式}。有效字段：price、rePurchaseRate、monthSold；方式：asc/desc |\n| keyword | string | 否 | - | 关键词，在结果中搜索 |\n| productCollectionId | string | 否 | - | 货盘ID，单选。有效值见下方「支持的货盘ID」 |\n\n### 支持的过滤条件\n\n多个条件用逗号分隔，如 `1688Selection,totalEpScoreLv1,qrr0`。\n\n| 值 | 说明 |\n|----|------|\n| 1688Selection | 1688严选 |\n| certifiedFactory | 认证工厂 |\n| totalEpScoreLv1 | 综合体验分5星 |\n| totalEpScoreLv2 | 综合体验分4星 |\n| totalEpScoreLv3 | 综合体验分3星 |\n| totalEpScoreLv4 | 综合体验分2星 |\n| qrr0 | 无品质退款 |\n| qrr1 | 品质退款率<1% |\n| qrr5 | 品质退款率<5% |\n| qrr10 | 品质退款率<10% |\n| shipInToday | 当日发货 |\n| shipIn24Hours | 24小时发货 |\n| shipIn48Hours | 48小时发货 |\n| noReason7DReturn | 7天无理由退货 |\n| isOnePsale | 一件代发 |\n| isOnePsaleFreePost | 一件代发包邮 |\n| new7 | 7天内新品 |\n| new30 | 30天内新品 |\n| isQqyx | 全球严选 |\n| JPFL | 日本专线 |\n| USFL | 美国专线 |\n| KRFL | 韩国专线 |\n| VNFL | 越南专线 |\n| SAFL | 沙特专线 |\n| RUFL | 俄罗斯专线 |\n| KZFL | 哈萨克斯坦专线 |\n| HKFL | 香港专线 |\n| MOFL | 澳门专线 |\n| TWFL | 台湾专线 |\n\n### 支持的排序字段\n\n| 字段 | 说明 |\n|------|------|\n| price | 价格 |\n| monthSold | 月销量 |\n| rePurchaseRate | 复购率 |\n\n排序方式：`asc`（升序）、`desc`（降序）。格式示例：`{\"price\":\"asc\"}`\n\n### 支持的货盘ID\n\n| ID | 说明 |\n|----|------|\n| 262105288 | 跨境货盘 |\n| 262105286 | 跨境货盘 |\n| 262105253 | 跨境货盘 |\n| 262105281 | 跨境货盘 |\n| 262105280 | 跨境货盘 |\n| 262105277 | 跨境货盘 |\n| 262105276 | 跨境货盘 |\n| 262105274 | 跨境货盘 |\n| 262105269 | 跨境货盘 |\n| 262185282 | 跨境货盘 |\n\n## 响应结构\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| imageId | string | 上传后的图片ID（分页查询时回传可加速） |\n| total | integer | 本页商品数量 |\n| totalPage | integer | 总页数 |\n| sourceType | string | 来源类型（固定值 \"1688\"） |\n| type | string | 渲染样式（固定值 \"productWorkbenches\"） |\n| columns | array | 渲染列定义 |\n| costToken | integer | 消耗 token |\n| products | array | 商品列表（详见下方商品字段） |\n\n### 商品字段\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| offerId | string | 商品ID |\n| asin | string | 商品编号（同 offerId） |\n| imageUrl | string | 商品图片 |\n| title | string | 商品标题 |\n| price | number | 批发价（元） |\n| consignPrice | number | 一件代发价（元） |\n| salesQuantity | integer | 月销售件数 |\n| estimatedSalesAmount | number | 预估销售额 |\n| asinUrl | string | 商品链接 |\n| isOnePsale | string | 是否一件代发（是/否） |\n| isJxhy | string | 是否精选货源（是/否） |\n| sellerIdentities | string | 商家身份（超级工厂/实力商家/诚信通会员） |\n| offerIdentities | string | 商品标（严选） |\n| repurchaseRate | string | 复购率 |\n| tradeScore | string | 商品交易评分 |\n| compositeServiceScore | string | 综合服务体验分 |\n| sendGoodsAddressText | string | 发货地 |\n| deliveryTime | string | 发货时间（24/48小时） |\n| quantityBegin | integer | 起批量 |\n| hasPromotion | string | 是否有营销活动（是/否） |\n| promotionType | string | 营销类型 |\n| isPatentProduct | string | 是否专利商品（是/否） |\n| isSelect | string | 跨境select货盘标识 |\n| currency | string | 币种（固定值 \"¥\"） |\n| sourceType | string | 来源类型（固定值 \"1688\"） |\n| sourceTool | string | 来源工具（固定值 \"1688以图搜图\"） |\n| dataType | string | 数据类型（固定值 \"monthlyData\"） |\n\n## 错误码\n\n正常情况下，接口的 HTTP 状态码均为 200，业务的成功与否通过响应体中的 errorCode 字段区分（errorCode = 200 表示成功，其他值表示业务错误）。当遇到未授权等情况时，HTTP 状态码为 401，且对应的 errorCode 也是 401。\n\n| errcode | 含义 | 处理建议 |\n|---------|------|----------|\n| 200 | 成功 | 正常解析业务字段 |\n| 401 | 认证失败 | 检查请求头 `Authorization` 是否正确携带 API Key；API Key 申请方式请参考上述[调用规范](#调用规范)下的认证方式 |\n| 其他非200值 | 业务异常 | 参考 `errmsg` 字段获取具体错误原因 |\n\n错误响应示例：\n\n```json\n{\n    \"errcode\": 401,\n    \"errmsg\": \"authorized error\"\n}\n```\n\n## curl 示例\n\n### 基础以图搜图\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/alibaba1688/imageSearch \\\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"User-Agent: LinkFox-Skill/1.0\" \\\n  -d '{\n    \"imageUrl\": \"https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg\",\n    \"page\": 1,\n    \"pageSize\": 20\n  }'\n```\n\n### 带筛选和排序\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/alibaba1688/imageSearch \\\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"User-Agent: LinkFox-Skill/1.0\" \\\n  -d '{\n    \"imageUrl\": \"https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg\",\n    \"page\": 1,\n    \"pageSize\": 20,\n    \"filter\": \"1688Selection,totalEpScoreLv1,qrr0\",\n    \"sort\": \"{\\\"price\\\":\\\"desc\\\"}\"\n  }'\n```\n\n### 分页查询（使用 imageId）\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/alibaba1688/imageSearch \\\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"User-Agent: LinkFox-Skill/1.0\" \\\n  -d '{\n    \"imageId\": \"abc123456\",\n    \"page\": 2,\n    \"pageSize\": 20\n  }'\n```\n\n### 价格区间筛选\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/alibaba1688/imageSearch \\\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"User-Agent: LinkFox-Skill/1.0\" \\\n  -d '{\n    \"imageUrl\": \"https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg\",\n    \"page\": 1,\n    \"pageSize\": 20,\n    \"priceStart\": \"10\",\n    \"priceEnd\": \"100\"\n  }'\n```\n\n---\n\n## Feedback API\n\n> This endpoint is **separate** from the tool API above. Do not mix the two base URLs.\n\n- **POST** `https://skill-api.linkfox.com/api/v1/public/feedback`\n- **Content-Type:** `application/json`\n\n```json\n{\n  \"skillName\": \"linkfox-1688-search-by-image\",\n  \"sentiment\": \"POSITIVE\",\n  \"category\": \"OTHER\",\n  \"content\": \"Results were accurate, user was satisfied.\"\n}\n```\n\n**Field rules:**\n- `skillName`: Use this skill's `name` from the YAML frontmatter (`linkfox-1688-search-by-image`)\n- `sentiment`: Choose ONE — `POSITIVE` (praise), `NEUTRAL` (suggestion without emotion), `NEGATIVE` (complaint or error)\n- `category`: Choose ONE — `BUG` (malfunction or wrong data), `COMPLAINT` (user dissatisfaction), `SUGGESTION` (improvement idea), `OTHER`\n- `content`: Include what the user said or intended, what actually happened, and why it is a problem or praise\n\nArchive v1.0.2: 5 files, 16291 bytes\n\nFiles: references/api.md (8757b), scripts/alibaba1688_image_search.py (12806b), scripts/upload_image.py (4755b), SKILL.md (11241b), _meta.json (147b)\n\nFile v1.0.2:SKILL.md\n\n---\nname: linkfox-1688-search-by-image\ndescription: 1688平台以图搜图，通过商品图片精准检索外观相似或同款的1688货源，返回标题、价格、起批量、月销量、复购率、交易评分等核心数据。当用户提到1688以图搜图、1688找货源、以图找同款、跨境找工厂、1688识图、图片找货源、找相似货源、image search 1688、find supplier by image时触发此技能。即使用户未明确提及\"以图搜图\"，只要用户提供了图片URL并希望在1688上查找匹配或相似的货源商品，也应触发此技能。\n---\n\n# 1688 Image-Based Product Search\n\nThis skill performs visual product searches on the 1688 platform using an image URL, helping cross-border sellers find visually similar supplier products for sourcing.\n\n## Core Concepts\n\n1688 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.\n\n## Data Fields\n\n| Field | Description |\n|-------|-------------|\n| offerId | Product ID on 1688 |\n| title | Product title |\n| imageUrl | Product main image |\n| price | Wholesale price (CNY) |\n| consignPrice | Dropship price (CNY) |\n| salesQuantity | Monthly sales volume |\n| estimatedSalesAmount | Estimated monthly revenue |\n| quantityBegin | Minimum order quantity |\n| repurchaseRate | Repurchase rate |\n| tradeScore | Product trade score |\n| compositeServiceScore | Composite service experience score |\n| sellerIdentities | Seller identity (超级工厂/实力商家/诚信通会员) |\n| offerIdentities | Product badge (严选) |\n| sendGoodsAddressText | Shipping origin |\n| deliveryTime | Delivery time (24/48 hours) |\n| isOnePsale | Supports dropshipping (是/否) |\n| isJxhy | Premium sourcing (是/否) |\n| hasPromotion | Has promotion (是/否) |\n| isPatentProduct | Patent product (是/否) |\n\n## Parameter Guide\n\n**Image Rules:**\n1. Only png, jpg, jpeg formats are supported. webp, gif, and other formats are NOT supported.\n2. Base64 string must be pure encoded content WITHOUT the `data:image/jpeg;base64,` prefix.\n3. Image source — one of imageUrl, imageBase64, or imageId must be provided (at least one required).\n\n| Parameter | Required | Default | Description |\n|-----------|----------|---------|-------------|\n| imageUrl | Conditional | - | Public image URL (max 1000 chars). Only png/jpg/jpeg formats supported |\n| imageBase64 | Conditional | - | Pure Base64 encoded image string, without `data:image/...;base64,` prefix. Only png/jpg/jpeg supported |\n| imageId | Conditional | - | 1688 image ID from previous search result (speeds up pagination) |\n| page | No | 1 | Page number, starting from 1 |\n| pageSize | No | 20 | Results per page (1-50) |\n| priceStart | No | - | Min price filter (CNY) |\n| priceEnd | No | - | Max price filter (CNY) |\n| filter | No | - | Filter conditions, comma-separated (see supported filters below) |\n| sort | No | {\"monthSold\":\"desc\"} | Sort as JSON: {field: direction} (see supported sort fields below) |\n| keyword | No | - | Keyword to further filter results |\n| productCollectionId | No | - | Product collection ID (see supported IDs below) |\n\n### Supported Filters\n\nMultiple filters can be combined with commas (e.g. `1688Selection,totalEpScoreLv1,qrr0`).\n\n| Filter Value | Description |\n|--------------|-------------|\n| 1688Selection | 1688严选 |\n| certifiedFactory | 认证工厂 |\n| totalEpScoreLv1 | 综合体验分5星 |\n| totalEpScoreLv2 | 综合体验分4星 |\n| totalEpScoreLv3 | 综合体验分3星 |\n| totalEpScoreLv4 | 综合体验分2星 |\n| qrr0 | 无品质退款 |\n| qrr1 | 品质退款率<1% |\n| qrr5 | 品质退款率<5% |\n| qrr10 | 品质退款率<10% |\n| shipInToday | 当日发货 |\n| shipIn24Hours | 24小时发货 |\n| shipIn48Hours | 48小时发货 |\n| noReason7DReturn | 7天无理由退货 |\n| isOnePsale | 一件代发 |\n| isOnePsaleFreePost | 一件代发包邮 |\n| new7 | 7天内新品 |\n| new30 | 30天内新品 |\n| isQqyx | 全球严选 |\n| JPFL | 日本专线 |\n| USFL | 美国专线 |\n| KRFL | 韩国专线 |\n| VNFL | 越南专线 |\n| SAFL | 沙特专线 |\n| RUFL | 俄罗斯专线 |\n| KZFL | 哈萨克斯坦专线 |\n| HKFL | 香港专线 |\n| MOFL | 澳门专线 |\n| TWFL | 台湾专线 |\n\n### Supported Sort Fields\n\n| Field | Direction | Description |\n|-------|-----------|-------------|\n| price | asc/desc | Price ascending/descending |\n| monthSold | asc/desc | Monthly sales ascending/descending |\n| rePurchaseRate | asc/desc | Repurchase rate ascending/descending |\n\nSort format example: `{\"price\":\"asc\"}` for price low to high.\n\n### Supported Product Collection IDs\n\n| ID | Usage |\n|----|-------|\n| 262105288 | 跨境货盘 |\n| 262105286 | 跨境货盘 |\n| 262105253 | 跨境货盘 |\n| 262105281 | 跨境货盘 |\n| 262105280 | 跨境货盘 |\n| 262105277 | 跨境货盘 |\n| 262105276 | 跨境货盘 |\n| 262105274 | 跨境货盘 |\n| 262105269 | 跨境货盘 |\n| 262185282 | 跨境货盘 |\n\n## 调用方式\n\n- **API 端点**：`POST /alibaba1688/imageSearch`（完整参数/响应/错误码见 `references/api.md`）\n- **Python 脚本**：`python scripts/alibaba1688_image_search.py '<JSON 参数>' [--inline]`\n- **成本约束**：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。\n\n**输出策略（脚本默认行为）**：\n- **始终**将完整响应写入 `<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-1688-search-by-image-<timestamp>.json`（`<cwd>` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`<session>` 取自环境变量 `SESSION_ID`，按用户任务自动聚合；**禁止写入 /tmp**，当前目录不可写则报错）\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段的长度 + 前 3 条样本）\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\n\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq`或`ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\n\n## Local Image Upload\n\nThis tool requires a **publicly accessible image URL**. If the user provides a local image file path, you must upload it first to obtain a public URL.\n\nRun the upload script:\n```bash\npython scripts/upload_image.py /path/to/local/image.png\n```\n\nThe script will return a public URL (valid for 24 hours) that can be used as the imageUrl parameter.\n\n## Usage Examples\n\n**1. Basic image search**\n```\n在1688搜索与图片相似的商品，图片地址为 https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg\n```\n\n**2. Search with filters**\n```\n在1688搜索与图片相似的商品，图片地址为 https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg，查询第1页，筛选1688严选，并按价格从高到低排序\n```\n\n**3. Search with sorting**\n```\n在1688搜索与图片相似的商品，图片地址为 https://example.com/product.jpg，按价格从高到低排序\n```\n\n**4. Paginated search**\n```\n在1688搜索与图片相似的商品，图片地址为 https://example.com/product.jpg，查询第2页，每页50条\n```\n\n**5. Price range filter**\n```\n在1688搜索与图片相似的商品，图片地址为 https://example.com/product.jpg，价格区间10-100元\n```\n\n## Display Rules\n\n1. **Present data clearly**: Show results in a structured table with key columns: product image, title, price, dropship price, monthly sales, minimum order quantity, repurchase rate, and seller identity\n2. **Image display**: When the response includes imageUrl for products, display them inline for visual comparison\n3. **Price display**: Always show price in CNY (¥) format\n4. **Seller badges**: Display seller identity badges (超级工厂/实力商家/诚信通会员) and product badges (严选) prominently\n5. **Result count**: Always inform the user of total results and current page/total pages\n6. **Pagination hint**: When more pages are available, suggest the user can request the next page\n7. **Filter/sort limitation**: If the user requests a sort or filter not in the supported list, do NOT attempt any workaround. Inform the user of the supported options\n8. **No secondary processing**: Results are real-time and not stored in a database, so secondary SQL/data processing is not available\n\n## Important Limitations\n\n1. **Data real-time nature**: Results are live searches, not stored in any database. Cannot use `_dataQuery_executeDynamicQuery` for secondary processing.\n2. **Logic constraint**: If the user requests sort or filter conditions not in the preset supported list, do NOT call any other tool or logic to compensate.\n3. **Image input**: One of imageUrl, imageBase64, or imageId is required. For page > 1, prefer passing imageId from the first page result to speed up queries.\n4. **Image format**: Only png, jpg, jpeg are supported. webp, gif, and other formats will be rejected.\n5. **Base64 format**: The imageBase64 value must be the raw Base64 string only — do NOT include the `data:image/jpeg;base64,` prefix.\n6. **Page size**: Maximum 50 results per page.\n\n## User Expression & Scenario Quick Reference\n\n**Applicable** -- Visual product sourcing scenarios on 1688:\n\n| User Says | Scenario |\n|-----------|----------|\n| \"1688以图搜图\" / \"用图片找1688货源\" | Basic image search |\n| \"帮我在1688找这个图片的同款\" | Find same-style products |\n| \"跨境找工厂，图片是...\" | Cross-border supplier sourcing |\n| \"这个Amazon产品在1688有没有货源\" | Reverse sourcing from Amazon image |\n| \"筛选1688严选的相似商品\" | Filtered image search |\n| \"按月销量排序找相似货源\" | Sorted image search |\n| \"查看第2页结果\" | Pagination |\n\n**Not applicable** -- Needs beyond 1688 image search:\n\n- Text/keyword-based 1688 search (use 店雷达-1688选品库)\n- 1688 product rankings/trending (use 店雷达-1688商品榜单)\n- Amazon image search (use 亚马逊前端-以图搜图)\n- Image generation or editing\n- Product review analysis\n- Price history or trend analysis\n\n**Boundary judgment**: When users say \"找货源\" or \"找同款\", if they provide an image URL and the intent is to find visually similar products on 1688, this skill applies. If they want keyword-based search or ranking data on 1688, use the 店雷达 tools instead.\n\n**Feedback:**\n\nAuto-detect and report feedback via the Feedback API when any of the following apply:\n1. The functionality or purpose described in this skill does not match actual behavior\n2. The skill's results do not match the user's intent\n3. The user expresses dissatisfaction or praise about this skill\n4. Anything you believe could be improved\n\nCall the feedback API as specified in `references/api.md`. Do not interrupt the user's flow.\n\n---\n*For more high-quality, professional cross-border e-commerce skills, visit [LinkFox Skills](https://skill.linkfox.com/).*\n\nFile v1.0.2:_meta.json\n\n{\n  \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n  \"slug\": \"linkfox-1688-search-by-image\",\n  \"version\": \"1.0.2\",\n  \"publishedAt\": 1783065970267\n}\n\nFile v1.0.2:references/api.md\n\n# 1688-以图搜图 API 参考\n\n## 调用规范\n\n- **请求地址**：`${LINKFOX_TOOL_GATEWAY}/alibaba1688/imageSearch`\n- **请求方式**：POST，Content-Type: application/json\n- **认证方式**：Header `Authorization: <api_key>`，api_key 优先从环境变量 `LINKFOX_AGENT_API_KEY` 读取，回退 `LINKFOXAGENT_API_KEY`（如未配置，提示用户前往 https://skill.linkfox.com/linkfoxskills/guide.htm 申请）\n- **User-Agent**：`LinkFox-Skill/1.0`\n- **超时**：60s\n\n## 请求参数\n\nPOST Body（JSON）：\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| imageUrl | string | 条件必填 | - | 图片URL地址，请确保图片URL有效且可公开访问。最大长度：1000。仅支持 png/jpg/jpeg 格式，不支持 webp/gif 等。imageUrl/imageBase64/imageId 三选一必填 |\n| imageBase64 | string | 条件必填 | - | 图片 Base64 编码字符串，为纯编码内容，不包含 `data:image/jpeg;base64,` 前缀。仅支持 png/jpg/jpeg 格式（imageUrl为空时使用） |\n| imageId | string | 条件必填 | - | 图片ID（1688图片ID），以图搜图查询结果中也会返回，建议当分页 page>1 查询时带 imageId，加快响应速度 |\n| page | int | 否 | 1 | 页码，从1开始 |\n| pageSize | int | 否 | 20 | 每页返回的商品数量，最大不超过50 |\n| priceStart | string | 否 | - | 价格筛选起始值（人民币），如 10 |\n| priceEnd | string | 否 | - | 价格筛选结束值（人民币），如 100 |\n| filter | string | 否 | - | 过滤条件，多个条件用逗号分隔。有效值见下方「支持的过滤条件」 |\n| sort | string | 否 | {\"monthSold\":\"desc\"} | 排序条件，JSON格式 {排序字段: 排序方式}。有效字段：price、rePurchaseRate、monthSold；方式：asc/desc |\n| keyword | string | 否 | - | 关键词，在结果中搜索 |\n| productCollectionId | string | 否 | - | 货盘ID，单选。有效值见下方「支持的货盘ID」 |\n\n### 支持的过滤条件\n\n多个条件用逗号分隔，如 `1688Selection,totalEpScoreLv1,qrr0`。\n\n| 值 | 说明 |\n|----|------|\n| 1688Selection | 1688严选 |\n| certifiedFactory | 认证工厂 |\n| totalEpScoreLv1 | 综合体验分5星 |\n| totalEpScoreLv2 | 综合体验分4星 |\n| totalEpScoreLv3 | 综合体验分3星 |\n| totalEpScoreLv4 | 综合体验分2星 |\n| qrr0 | 无品质退款 |\n| qrr1 | 品质退款率<1% |\n| qrr5 | 品质退款率<5% |\n| qrr10 | 品质退款率<10% |\n| shipInToday | 当日发货 |\n| shipIn24Hours | 24小时发货 |\n| shipIn48Hours | 48小时发货 |\n| noReason7DReturn | 7天无理由退货 |\n| isOnePsale | 一件代发 |\n| isOnePsaleFreePost | 一件代发包邮 |\n| new7 | 7天内新品 |\n| new30 | 30天内新品 |\n| isQqyx | 全球严选 |\n| JPFL | 日本专线 |\n| USFL | 美国专线 |\n| KRFL | 韩国专线 |\n| VNFL | 越南专线 |\n| SAFL | 沙特专线 |\n| RUFL | 俄罗斯专线 |\n| KZFL | 哈萨克斯坦专线 |\n| HKFL | 香港专线 |\n| MOFL | 澳门专线 |\n| TWFL | 台湾专线 |\n\n### 支持的排序字段\n\n| 字段 | 说明 |\n|------|------|\n| price | 价格 |\n| monthSold | 月销量 |\n| rePurchaseRate | 复购率 |\n\n排序方式：`asc`（升序）、`desc`（降序）。格式示例：`{\"price\":\"asc\"}`\n\n### 支持的货盘ID\n\n| ID | 说明 |\n|----|------|\n| 262105288 | 跨境货盘 |\n| 262105286 | 跨境货盘 |\n| 262105253 | 跨境货盘 |\n| 262105281 | 跨境货盘 |\n| 262105280 | 跨境货盘 |\n| 262105277 | 跨境货盘 |\n| 262105276 | 跨境货盘 |\n| 262105274 | 跨境货盘 |\n| 262105269 | 跨境货盘 |\n| 262185282 | 跨境货盘 |\n\n## 响应结构\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| imageId | string | 上传后的图片ID（分页查询时回传可加速） |\n| total | integer | 本页商品数量 |\n| totalPage | integer | 总页数 |\n| sourceType | string | 来源类型（固定值 \"1688\"） |\n| type | string | 渲染样式（固定值 \"productWorkbenches\"） |\n| columns | array | 渲染列定义 |\n| costToken | integer | 消耗 token |\n| products | array | 商品列表（详见下方商品字段） |\n\n### 商品字段\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| offerId | string | 商品ID |\n| asin | string | 商品编号（同 offerId） |\n| imageUrl | string | 商品图片 |\n| title | string | 商品标题 |\n| price | number | 批发价（元） |\n| consignPrice | number | 一件代发价（元） |\n| salesQuantity | integer | 月销售件数 |\n| estimatedSalesAmount | number | 预估销售额 |\n| asinUrl | string | 商品链接 |\n| isOnePsale | string | 是否一件代发（是/否） |\n| isJxhy | string | 是否精选货源（是/否） |\n| sellerIdentities | string | 商家身份（超级工厂/实力商家/诚信通会员） |\n| offerIdentities | string | 商品标（严选） |\n| repurchaseRate | string | 复购率 |\n| tradeScore | string | 商品交易评分 |\n| compositeServiceScore | string | 综合服务体验分 |\n| sendGoodsAddressText | string | 发货地 |\n| deliveryTime | string | 发货时间（24/48小时） |\n| quantityBegin | integer | 起批量 |\n| hasPromotion | string | 是否有营销活动（是/否） |\n| promotionType | string | 营销类型 |\n| isPatentProduct | string | 是否专利商品（是/否） |\n| isSelect | string | 跨境select货盘标识 |\n| currency | string | 币种（固定值 \"¥\"） |\n| sourceType | string | 来源类型（固定值 \"1688\"） |\n| sourceTool | string | 来源工具（固定值 \"1688以图搜图\"） |\n| dataType | string | 数据类型（固定值 \"monthlyData\"） |\n\n## 错误码\n\n正常情况下，接口的 HTTP 状态码均为 200，业务的成功与否通过响应体中的 errorCode 字段区分（errorCode = 200 表示成功，其他值表示业务错误）。当遇到未授权等情况时，HTTP 状态码为 401，且对应的 errorCode 也是 401。\n\n| errcode | 含义 | 处理建议 |\n|---------|------|----------|\n| 200 | 成功 | 正常解析业务字段 |\n| 401 | 认证失败 | 检查请求头 `Authorization` 是否正确携带 API Key；API Key 申请方式请参考上述[调用规范](#调用规范)下的认证方式 |\n| 其他非200值 | 业务异常 | 参考 `errmsg` 字段获取具体错误原因 |\n\n错误响应示例：\n\n```json\n{\n    \"errcode\": 401,\n    \"errmsg\": \"authorized error\"\n}\n```\n\n## curl 示例\n\n### 基础以图搜图\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/alibaba1688/imageSearch \\\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"User-Agent: LinkFox-Skill/1.0\" \\\n  -d '{\n    \"imageUrl\": \"https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg\",\n    \"page\": 1,\n    \"pageSize\": 20\n  }'\n```\n\n### 带筛选和排序\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/alibaba1688/imageSearch \\\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"User-Agent: LinkFox-Skill/1.0\" \\\n  -d '{\n    \"imageUrl\": \"https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg\",\n    \"page\": 1,\n    \"pageSize\": 20,\n    \"filter\": \"1688Selection,totalEpScoreLv1,qrr0\",\n    \"sort\": \"{\\\"price\\\":\\\"desc\\\"}\"\n  }'\n```\n\n### 分页查询（使用 imageId）\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/alibaba1688/imageSearch \\\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"User-Agent: LinkFox-Skill/1.0\" \\\n  -d '{\n    \"imageId\": \"abc123456\",\n    \"page\": 2,\n    \"pageSize\": 20\n  }'\n```\n\n### 价格区间筛选\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/alibaba1688/imageSearch \\\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"User-Agent: LinkFox-Skill/1.0\" \\\n  -d '{\n    \"imageUrl\": \"https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg\",\n    \"page\": 1,\n    \"pageSize\": 20,\n    \"priceStart\": \"10\",\n    \"priceEnd\": \"100\"\n  }'\n```\n\n---\n\n## Feedback API\n\n> This endpoint is **separate** from the tool API above. Do not mix the two base URLs.\n\n- **POST** `https://skill-api.linkfox.com/api/v1/public/feedback`\n- **Content-Type:** `application/json`\n\n```json\n{\n  \"skillName\": \"linkfox-1688-search-by-image\",\n  \"sentiment\": \"POSITIVE\",\n  \"category\": \"OTHER\",\n  \"content\": \"Results were accurate, user was satisfied.\"\n}\n```\n\n**Field rules:**\n- `skillName`: Use this skill's `name` from the YAML frontmatter (`linkfox-1688-search-by-image`)\n- `sentiment`: Choose ONE — `POSITIVE` (praise), `NEUTRAL` (suggestion without emotion), `NEGATIVE` (complaint or error)\n- `category`: Choose ONE — `BUG` (malfunction or wrong data), `COMPLAINT` (user dissatisfaction), `SUGGESTION` (improvement idea), `OTHER`\n- `content`: Include what the user said or intended, what actually happened, and why it is a problem or praise\n\nArchive v1.0.1: 5 files, 16255 bytes\n\nFiles: references/api.md (8758b), scripts/alibaba1688_image_search.py (12808b), scripts/upload_image.py (4756b), SKILL.md (11241b), _meta.json (147b)\n\nFile v1.0.1:SKILL.md\n\n---\nname: linkfox-1688-search-by-image\ndescription: 1688平台以图搜图，通过商品图片精准检索外观相似或同款的1688货源，返回标题、价格、起批量、月销量、复购率、交易评分等核心数据。当用户提到1688以图搜图、1688找货源、以图找同款、跨境找工厂、1688识图、图片找货源、找相似货源、image search 1688、find supplier by image时触发此技能。即使用户未明确提及\"以图搜图\"，只要用户提供了图片URL并希望在1688上查找匹配或相似的货源商品，也应触发此技能。\n---\n\n# 1688 Image-Based Product Search\n\nThis skill performs visual product searches on the 1688 platform using an image URL, helping cross-border sellers find visually similar supplier products for sourcing.\n\n## Core Concepts\n\n1688 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.\n\n## Data Fields\n\n| Field | Description |\n|-------|-------------|\n| offerId | Product ID on 1688 |\n| title | Product title |\n| imageUrl | Product main image |\n| price | Wholesale price (CNY) |\n| consignPrice | Dropship price (CNY) |\n| salesQuantity | Monthly sales volume |\n| estimatedSalesAmount | Estimated monthly revenue |\n| quantityBegin | Minimum order quantity |\n| repurchaseRate | Repurchase rate |\n| tradeScore | Product trade score |\n| compositeServiceScore | Composite service experience score |\n| sellerIdentities | Seller identity (超级工厂/实力商家/诚信通会员) |\n| offerIdentities | Product badge (严选) |\n| sendGoodsAddressText | Shipping origin |\n| deliveryTime | Delivery time (24/48 hours) |\n| isOnePsale | Supports dropshipping (是/否) |\n| isJxhy | Premium sourcing (是/否) |\n| hasPromotion | Has promotion (是/否) |\n| isPatentProduct | Patent product (是/否) |\n\n## Parameter Guide\n\n**Image Rules:**\n1. Only png, jpg, jpeg formats are supported. webp, gif, and other formats are NOT supported.\n2. Base64 string must be pure encoded content WITHOUT the `data:image/jpeg;base64,` prefix.\n3. Image source — one of imageUrl, imageBase64, or imageId must be provided (at least one required).\n\n| Parameter | Required | Default | Description |\n|-----------|----------|---------|-------------|\n| imageUrl | Conditional | - | Public image URL (max 1000 chars). Only png/jpg/jpeg formats supported |\n| imageBase64 | Conditional | - | Pure Base64 encoded image string, without `data:image/...;base64,` prefix. Only png/jpg/jpeg supported |\n| imageId | Conditional | - | 1688 image ID from previous search result (speeds up pagination) |\n| page | No | 1 | Page number, starting from 1 |\n| pageSize | No | 20 | Results per page (1-50) |\n| priceStart | No | - | Min price filter (CNY) |\n| priceEnd | No | - | Max price filter (CNY) |\n| filter | No | - | Filter conditions, comma-separated (see supported filters below) |\n| sort | No | {\"monthSold\":\"desc\"} | Sort as JSON: {field: direction} (see supported sort fields below) |\n| keyword | No | - | Keyword to further filter results |\n| productCollectionId | No | - | Product collection ID (see supported IDs below) |\n\n### Supported Filters\n\nMultiple filters can be combined with commas (e.g. `1688Selection,totalEpScoreLv1,qrr0`).\n\n| Filter Value | Description |\n|--------------|-------------|\n| 1688Selection | 1688严选 |\n| certifiedFactory | 认证工厂 |\n| totalEpScoreLv1 | 综合体验分5星 |\n| totalEpScoreLv2 | 综合体验分4星 |\n| totalEpScoreLv3 | 综合体验分3星 |\n| totalEpScoreLv4 | 综合体验分2星 |\n| qrr0 | 无品质退款 |\n| qrr1 | 品质退款率<1% |\n| qrr5 | 品质退款率<5% |\n| qrr10 | 品质退款率<10% |\n| shipInToday | 当日发货 |\n| shipIn24Hours | 24小时发货 |\n| shipIn48Hours | 48小时发货 |\n| noReason7DReturn | 7天无理由退货 |\n| isOnePsale | 一件代发 |\n| isOnePsaleFreePost | 一件代发包邮 |\n| new7 | 7天内新品 |\n| new30 | 30天内新品 |\n| isQqyx | 全球严选 |\n| JPFL | 日本专线 |\n| USFL | 美国专线 |\n| KRFL | 韩国专线 |\n| VNFL | 越南专线 |\n| SAFL | 沙特专线 |\n| RUFL | 俄罗斯专线 |\n| KZFL | 哈萨克斯坦专线 |\n| HKFL | 香港专线 |\n| MOFL | 澳门专线 |\n| TWFL | 台湾专线 |\n\n### Supported Sort Fields\n\n| Field | Direction | Description |\n|-------|-----------|-------------|\n| price | asc/desc | Price ascending/descending |\n| monthSold | asc/desc | Monthly sales ascending/descending |\n| rePurchaseRate | asc/desc | Repurchase rate ascending/descending |\n\nSort format example: `{\"price\":\"asc\"}` for price low to high.\n\n### Supported Product Collection IDs\n\n| ID | Usage |\n|----|-------|\n| 262105288 | 跨境货盘 |\n| 262105286 | 跨境货盘 |\n| 262105253 | 跨境货盘 |\n| 262105281 | 跨境货盘 |\n| 262105280 | 跨境货盘 |\n| 262105277 | 跨境货盘 |\n| 262105276 | 跨境货盘 |\n| 262105274 | 跨境货盘 |\n| 262105269 | 跨境货盘 |\n| 262185282 | 跨境货盘 |\n\n## 调用方式\n\n- **API 端点**：`POST /alibaba1688/imageSearch`（完整参数/响应/错误码见 `references/api.md`）\n- **Python 脚本**：`python scripts/alibaba1688_image_search.py '<JSON 参数>' [--inline]`\n- **成本约束**：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。\n\n**输出策略（脚本默认行为）**：\n- **始终**将完整响应写入 `<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-1688-search-by-image-<timestamp>.json`（`<cwd>` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`<session>` 取自环境变量 `SESSION_ID`，按用户任务自动聚合；**禁止写入 /tmp**，当前目录不可写则报错）\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段的长度 + 前 3 条样本）\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\n\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq`或`ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\n\n## Local Image Upload\n\nThis tool requires a **publicly accessible image URL**. If the user provides a local image file path, you must upload it first to obtain a public URL.\n\nRun the upload script:\n```bash\npython scripts/upload_image.py /path/to/local/image.png\n```\n\nThe script will return a public URL (valid for 24 hours) that can be used as the imageUrl parameter.\n\n## Usage Examples\n\n**1. Basic image search**\n```\n在1688搜索与图片相似的商品，图片地址为 https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg\n```\n\n**2. Search with filters**\n```\n在1688搜索与图片相似的商品，图片地址为 https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg，查询第1页，筛选1688严选，并按价格从高到低排序\n```\n\n**3. Search with sorting**\n```\n在1688搜索与图片相似的商品，图片地址为 https://example.com/product.jpg，按价格从高到低排序\n```\n\n**4. Paginated search**\n```\n在1688搜索与图片相似的商品，图片地址为 https://example.com/product.jpg，查询第2页，每页50条\n```\n\n**5. Price range filter**\n```\n在1688搜索与图片相似的商品，图片地址为 https://example.com/product.jpg，价格区间10-100元\n```\n\n## Display Rules\n\n1. **Present data clearly**: Show results in a structured table with key columns: product image, title, price, dropship price, monthly sales, minimum order quantity, repurchase rate, and seller identity\n2. **Image display**: When the response includes imageUrl for products, display them inline for visual comparison\n3. **Price display**: Always show price in CNY (¥) format\n4. **Seller badges**: Display seller identity badges (超级工厂/实力商家/诚信通会员) and product badges (严选) prominently\n5. **Result count**: Always inform the user of total results and current page/total pages\n6. **Pagination hint**: When more pages are available, suggest the user can request the next page\n7. **Filter/sort limitation**: If the user requests a sort or filter not in the supported list, do NOT attempt any workaround. Inform the user of the supported options\n8. **No secondary processing**: Results are real-time and not stored in a database, so secondary SQL/data processing is not available\n\n## Important Limitations\n\n1. **Data real-time nature**: Results are live searches, not stored in any database. Cannot use `_dataQuery_executeDynamicQuery` for secondary processing.\n2. **Logic constraint**: If the user requests sort or filter conditions not in the preset supported list, do NOT call any other tool or logic to compensate.\n3. **Image input**: One of imageUrl, imageBase64, or imageId is required. For page > 1, prefer passing imageId from the first page result to speed up queries.\n4. **Image format**: Only png, jpg, jpeg are supported. webp, gif, and other formats will be rejected.\n5. **Base64 format**: The imageBase64 value must be the raw Base64 string only — do NOT include the `data:image/jpeg;base64,` prefix.\n6. **Page size**: Maximum 50 results per page.\n\n## User Expression & Scenario Quick Reference\n\n**Applicable** -- Visual product sourcing scenarios on 1688:\n\n| User Says | Scenario |\n|-----------|----------|\n| \"1688以图搜图\" / \"用图片找1688货源\" | Basic image search |\n| \"帮我在1688找这个图片的同款\" | Find same-style products |\n| \"跨境找工厂，图片是...\" | Cross-border supplier sourcing |\n| \"这个Amazon产品在1688有没有货源\" | Reverse sourcing from Amazon image |\n| \"筛选1688严选的相似商品\" | Filtered image search |\n| \"按月销量排序找相似货源\" | Sorted image search |\n| \"查看第2页结果\" | Pagination |\n\n**Not applicable** -- Needs beyond 1688 image search:\n\n- Text/keyword-based 1688 search (use 店雷达-1688选品库)\n- 1688 product rankings/trending (use 店雷达-1688商品榜单)\n- Amazon image search (use 亚马逊前端-以图搜图)\n- Image generation or editing\n- Product review analysis\n- Price history or trend analysis\n\n**Boundary judgment**: When users say \"找货源\" or \"找同款\", if they provide an image URL and the intent is to find visually similar products on 1688, this skill applies. If they want keyword-based search or ranking data on 1688, use the 店雷达 tools instead.\n\n**Feedback:**\n\nAuto-detect and report feedback via the Feedback API when any of the following apply:\n1. The functionality or purpose described in this skill does not match actual behavior\n2. The skill's results do not match the user's intent\n3. The user expresses dissatisfaction or praise about this skill\n4. Anything you believe could be improved\n\nCall the feedback API as specified in `references/api.md`. Do not interrupt the user's flow.\n\n---\n*For more high-quality, professional cross-border e-commerce skills, visit [LinkFox Skills](https://skill.linkfox.com/).*\n\nFile v1.0.1:_meta.json\n\n{\n  \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n  \"slug\": \"linkfox-1688-search-by-image\",\n  \"version\": \"1.0.1\",\n  \"publishedAt\": 1783053152363\n}\n\nFile v1.0.1:references/api.md\n\n# 1688-以图搜图 API 参考\n\n## 调用规范\n\n- **请求地址**：`${LINKFOX_AGENT_API_URL}/alibaba1688/imageSearch`\n- **请求方式**：POST，Content-Type: application/json\n- **认证方式**：Header `Authorization: <api_key>`，api_key 优先从环境变量 `LINKFOX_AGENT_API_KEY` 读取，回退 `LINKFOXAGENT_API_KEY`（如未配置，提示用户前往 https://skill.linkfox.com/linkfoxskills/guide.htm 申请）\n- **User-Agent**：`LinkFox-Skill/1.0`\n- **超时**：60s\n\n## 请求参数\n\nPOST Body（JSON）：\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| imageUrl | string | 条件必填 | - | 图片URL地址，请确保图片URL有效且可公开访问。最大长度：1000。仅支持 png/jpg/jpeg 格式，不支持 webp/gif 等。imageUrl/imageBase64/imageId 三选一必填 |\n| imageBase64 | string | 条件必填 | - | 图片 Base64 编码字符串，为纯编码内容，不包含 `data:image/jpeg;base64,` 前缀。仅支持 png/jpg/jpeg 格式（imageUrl为空时使用） |\n| imageId | string | 条件必填 | - | 图片ID（1688图片ID），以图搜图查询结果中也会返回，建议当分页 page>1 查询时带 imageId，加快响应速度 |\n| page | int | 否 | 1 | 页码，从1开始 |\n| pageSize | int | 否 | 20 | 每页返回的商品数量，最大不超过50 |\n| priceStart | string | 否 | - | 价格筛选起始值（人民币），如 10 |\n| priceEnd | string | 否 | - | 价格筛选结束值（人民币），如 100 |\n| filter | string | 否 | - | 过滤条件，多个条件用逗号分隔。有效值见下方「支持的过滤条件」 |\n| sort | string | 否 | {\"monthSold\":\"desc\"} | 排序条件，JSON格式 {排序字段: 排序方式}。有效字段：price、rePurchaseRate、monthSold；方式：asc/desc |\n| keyword | string | 否 | - | 关键词，在结果中搜索 |\n| productCollectionId | string | 否 | - | 货盘ID，单选。有效值见下方「支持的货盘ID」 |\n\n### 支持的过滤条件\n\n多个条件用逗号分隔，如 `1688Selection,totalEpScoreLv1,qrr0`。\n\n| 值 | 说明 |\n|----|------|\n| 1688Selection | 1688严选 |\n| certifiedFactory | 认证工厂 |\n| totalEpScoreLv1 | 综合体验分5星 |\n| totalEpScoreLv2 | 综合体验分4星 |\n| totalEpScoreLv3 | 综合体验分3星 |\n| totalEpScoreLv4 | 综合体验分2星 |\n| qrr0 | 无品质退款 |\n| qrr1 | 品质退款率<1% |\n| qrr5 | 品质退款率<5% |\n| qrr10 | 品质退款率<10% |\n| shipInToday | 当日发货 |\n| shipIn24Hours | 24小时发货 |\n| shipIn48Hours | 48小时发货 |\n| noReason7DReturn | 7天无理由退货 |\n| isOnePsale | 一件代发 |\n| isOnePsaleFreePost | 一件代发包邮 |\n| new7 | 7天内新品 |\n| new30 | 30天内新品 |\n| isQqyx | 全球严选 |\n| JPFL | 日本专线 |\n| USFL | 美国专线 |\n| KRFL | 韩国专线 |\n| VNFL | 越南专线 |\n| SAFL | 沙特专线 |\n| RUFL | 俄罗斯专线 |\n| KZFL | 哈萨克斯坦专线 |\n| HKFL | 香港专线 |\n| MOFL | 澳门专线 |\n| TWFL | 台湾专线 |\n\n### 支持的排序字段\n\n| 字段 | 说明 |\n|------|------|\n| price | 价格 |\n| monthSold | 月销量 |\n| rePurchaseRate | 复购率 |\n\n排序方式：`asc`（升序）、`desc`（降序）。格式示例：`{\"price\":\"asc\"}`\n\n### 支持的货盘ID\n\n| ID | 说明 |\n|----|------|\n| 262105288 | 跨境货盘 |\n| 262105286 | 跨境货盘 |\n| 262105253 | 跨境货盘 |\n| 262105281 | 跨境货盘 |\n| 262105280 | 跨境货盘 |\n| 262105277 | 跨境货盘 |\n| 262105276 | 跨境货盘 |\n| 262105274 | 跨境货盘 |\n| 262105269 | 跨境货盘 |\n| 262185282 | 跨境货盘 |\n\n## 响应结构\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| imageId | string | 上传后的图片ID（分页查询时回传可加速） |\n| total | integer | 本页商品数量 |\n| totalPage | integer | 总页数 |\n| sourceType | string | 来源类型（固定值 \"1688\"） |\n| type | string | 渲染样式（固定值 \"productWorkbenches\"） |\n| columns | array | 渲染列定义 |\n| costToken | integer | 消耗 token |\n| products | array | 商品列表（详见下方商品字段） |\n\n### 商品字段\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| offerId | string | 商品ID |\n| asin | string | 商品编号（同 offerId） |\n| imageUrl | string | 商品图片 |\n| title | string | 商品标题 |\n| price | number | 批发价（元） |\n| consignPrice | number | 一件代发价（元） |\n| salesQuantity | integer | 月销售件数 |\n| estimatedSalesAmount | number | 预估销售额 |\n| asinUrl | string | 商品链接 |\n| isOnePsale | string | 是否一件代发（是/否） |\n| isJxhy | string | 是否精选货源（是/否） |\n| sellerIdentities | string | 商家身份（超级工厂/实力商家/诚信通会员） |\n| offerIdentities | string | 商品标（严选） |\n| repurchaseRate | string | 复购率 |\n| tradeScore | string | 商品交易评分 |\n| compositeServiceScore | string | 综合服务体验分 |\n| sendGoodsAddressText | string | 发货地 |\n| deliveryTime | string | 发货时间（24/48小时） |\n| quantityBegin | integer | 起批量 |\n| hasPromotion | string | 是否有营销活动（是/否） |\n| promotionType | string | 营销类型 |\n| isPatentProduct | string | 是否专利商品（是/否） |\n| isSelect | string | 跨境select货盘标识 |\n| currency | string | 币种（固定值 \"¥\"） |\n| sourceType | string | 来源类型（固定值 \"1688\"） |\n| sourceTool | string | 来源工具（固定值 \"1688以图搜图\"） |\n| dataType | string | 数据类型（固定值 \"monthlyData\"） |\n\n## 错误码\n\n正常情况下，接口的 HTTP 状态码均为 200，业务的成功与否通过响应体中的 errorCode 字段区分（errorCode = 200 表示成功，其他值表示业务错误）。当遇到未授权等情况时，HTTP 状态码为 401，且对应的 errorCode 也是 401。\n\n| errcode | 含义 | 处理建议 |\n|---------|------|----------|\n| 200 | 成功 | 正常解析业务字段 |\n| 401 | 认证失败 | 检查请求头 `Authorization` 是否正确携带 API Key；API Key 申请方式请参考上述[调用规范](#调用规范)下的认证方式 |\n| 其他非200值 | 业务异常 | 参考 `errmsg` 字段获取具体错误原因 |\n\n错误响应示例：\n\n```json\n{\n    \"errcode\": 401,\n    \"errmsg\": \"authorized error\"\n}\n```\n\n## curl 示例\n\n### 基础以图搜图\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/alibaba1688/imageSearch \\\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"User-Agent: LinkFox-Skill/1.0\" \\\n  -d '{\n    \"imageUrl\": \"https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg\",\n    \"page\": 1,\n    \"pageSize\": 20\n  }'\n```\n\n### 带筛选和排序\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/alibaba1688/imageSearch \\\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"User-Agent: LinkFox-Skill/1.0\" \\\n  -d '{\n    \"imageUrl\": \"https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg\",\n    \"page\": 1,\n    \"pageSize\": 20,\n    \"filter\": \"1688Selection,totalEpScoreLv1,qrr0\",\n    \"sort\": \"{\\\"price\\\":\\\"desc\\\"}\"\n  }'\n```\n\n### 分页查询（使用 imageId）\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/alibaba1688/imageSearch \\\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"User-Agent: LinkFox-Skill/1.0\" \\\n  -d '{\n    \"imageId\": \"abc123456\",\n    \"page\": 2,\n    \"pageSize\": 20\n  }'\n```\n\n### 价格区间筛选\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/alibaba1688/imageSearch \\\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"User-Agent: LinkFox-Skill/1.0\" \\\n  -d '{\n    \"imageUrl\": \"https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg\",\n    \"page\": 1,\n    \"pageSize\": 20,\n    \"priceStart\": \"10\",\n    \"priceEnd\": \"100\"\n  }'\n```\n\n---\n\n## Feedback API\n\n> This endpoint is **separate** from the tool API above. Do not mix the two base URLs.\n\n- **POST** `https://skill-api.linkfox.com/api/v1/public/feedback`\n- **Content-Type:** `application/json`\n\n```json\n{\n  \"skillName\": \"linkfox-1688-search-by-image\",\n  \"sentiment\": \"POSITIVE\",\n  \"category\": \"OTHER\",\n  \"content\": \"Results were accurate, user was satisfied.\"\n}\n```\n\n**Field rules:**\n- `skillName`: Use this skill's `name` from the YAML frontmatter (`linkfox-1688-search-by-image`)\n- `sentiment`: Choose ONE — `POSITIVE` (praise), `NEUTRAL` (suggestion without emotion), `NEGATIVE` (complaint or error)\n- `category`: Choose ONE — `BUG` (malfunction or wrong data), `COMPLAINT` (user dissatisfaction), `SUGGESTION` (improvement idea), `OTHER`\n- `content`: Include what the user said or intended, what actually happened, and why it is a problem or praise\n\nArchive v1.0.0: 7 files, 20008 bytes\n\nFiles: references/api.md (8572b), scripts/alibaba1688_image_search.py (2620b), scripts/response_io.py (18387b), scripts/upload_image.py (4629b), skill-card.md (2559b), SKILL.md (11112b), _meta.json (147b)\n\nFile v1.0.0:SKILL.md\n\n---\nname: linkfox-1688-search-by-image\ndescription: 1688平台以图搜图，通过商品图片精准检索外观相似或同款的1688货源，返回标题、价格、起批量、月销量、复购率、交易评分等核心数据。当用户提到1688以图搜图、1688找货源、以图找同款、跨境找工厂、1688识图、图片找货源、找相似货源、image search 1688、find supplier by image时触发此技能。即使用户未明确提及\"以图搜图\"，只要用户提供了图片URL并希望在1688上查找匹配或相似的货源商品，也应触发此技能。\n---\n\n# 1688 Image-Based Product Search\n\nThis skill performs visual product searches on the 1688 platform using an image URL, helping cross-border sellers find visually similar supplier products for sourcing.\n\n## Core Concepts\n\n1688 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.\n\n## Data Fields\n\n| Field | Description |\n|-------|-------------|\n| offerId | Product ID on 1688 |\n| title | Product title |\n| imageUrl | Product main image |\n| price | Wholesale price (CNY) |\n| consignPrice | Dropship price (CNY) |\n| salesQuantity | Monthly sales volume |\n| estimatedSalesAmount | Estimated monthly revenue |\n| quantityBegin | Minimum order quantity |\n| repurchaseRate | Repurchase rate |\n| tradeScore | Product trade score |\n| compositeServiceScore | Composite service experience score |\n| sellerIdentities | Seller identity (超级工厂/实力商家/诚信通会员) |\n| offerIdentities | Product badge (严选) |\n| sendGoodsAddressText | Shipping origin |\n| deliveryTime | Delivery time (24/48 hours) |\n| isOnePsale | Supports dropshipping (是/否) |\n| isJxhy | Premium sourcing (是/否) |\n| hasPromotion | Has promotion (是/否) |\n| isPatentProduct | Patent product (是/否) |\n\n## Parameter Guide\n\n| Parameter | Required | Default | Description |\n|-----------|----------|---------|-------------|\n| imageUrl | Conditional | - | Public image URL (max 1000 chars). One of imageUrl/imageBase64/imageId required |\n| imageBase64 | Conditional | - | Base64 encoded image (used when imageUrl is empty) |\n| imageId | Conditional | - | 1688 image ID from previous search result (speeds up pagination) |\n| page | No | 1 | Page number, starting from 1 |\n| pageSize | No | 20 | Results per page (1-50) |\n| priceStart | No | - | Min price filter (CNY) |\n| priceEnd | No | - | Max price filter (CNY) |\n| filter | No | - | Filter conditions, comma-separated (see supported filters below) |\n| sort | No | {\"monthSold\":\"desc\"} | Sort as JSON: {field: direction} (see supported sort fields below) |\n| keyword | No | - | Keyword to further filter results |\n| productCollectionId | No | - | Product collection ID (see supported IDs below) |\n\n### Supported Filters\n\nMultiple filters can be combined with commas (e.g. `1688Selection,totalEpScoreLv1,qrr0`).\n\n| Filter Value | Description |\n|--------------|-------------|\n| 1688Selection | 1688严选 |\n| certifiedFactory | 认证工厂 |\n| totalEpScoreLv1 | 综合体验分5星 |\n| totalEpScoreLv2 | 综合体验分4星 |\n| totalEpScoreLv3 | 综合体验分3星 |\n| totalEpScoreLv4 | 综合体验分2星 |\n| qrr0 | 无品质退款 |\n| qrr1 | 品质退款率<1% |\n| qrr5 | 品质退款率<5% |\n| qrr10 | 品质退款率<10% |\n| shipInToday | 当日发货 |\n| shipIn24Hours | 24小时发货 |\n| shipIn48Hours | 48小时发货 |\n| noReason7DReturn | 7天无理由退货 |\n| isOnePsale | 一件代发 |\n| isOnePsaleFreePost | 一件代发包邮 |\n| new7 | 7天内新品 |\n| new30 | 30天内新品 |\n| isQqyx | 全球严选 |\n| JPFL | 日本专线 |\n| USFL | 美国专线 |\n| KRFL | 韩国专线 |\n| VNFL | 越南专线 |\n| SAFL | 沙特专线 |\n| RUFL | 俄罗斯专线 |\n| KZFL | 哈萨克斯坦专线 |\n| HKFL | 香港专线 |\n| MOFL | 澳门专线 |\n| TWFL | 台湾专线 |\n\n### Supported Sort Fields\n\n| Field | Direction | Description |\n|-------|-----------|-------------|\n| price | asc/desc | Price ascending/descending |\n| monthSold | asc/desc | Monthly sales ascending/descending |\n| rePurchaseRate | asc/desc | Repurchase rate ascending/descending |\n\nSort format example: `{\"price\":\"asc\"}` for price low to high.\n\n### Supported Product Collection IDs\n\n| ID | Usage |\n|----|-------|\n| 262105288 | 跨境货盘 |\n| 262105286 | 跨境货盘 |\n| 262105253 | 跨境货盘 |\n| 262105281 | 跨境货盘 |\n| 262105280 | 跨境货盘 |\n| 262105277 | 跨境货盘 |\n| 262105276 | 跨境货盘 |\n| 262105274 | 跨境货盘 |\n| 262105269 | 跨境货盘 |\n| 262185282 | 跨境货盘 |\n\n## API Usage\n\nThis tool calls the LinkFox tool gateway API. See `references/api.md` for calling conventions, request parameters, and response structure. You can also execute `scripts/alibaba1688_image_search.py` directly to run queries.\n\n## Local Image Upload\n\nThis tool requires a **publicly accessible image URL**. If the user provides a local image file path, you must upload it first to obtain a public URL.\n\nRun the upload script:\n```bash\npython scripts/upload_image.py /path/to/local/image.png\n```\n\nThe script will return a public URL (valid for 24 hours) that can be used as the imageUrl parameter.\n\n## Usage Examples\n\n**1. Basic image search**\n```\n在1688搜索与图片相似的商品，图片地址为 https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg\n```\n\n**2. Search with filters**\n```\n在1688搜索与图片相似的商品，图片地址为 https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg，查询第1页，筛选1688严选，并按价格从高到低排序\n```\n\n**3. Search with sorting**\n```\n在1688搜索与图片相似的商品，图片地址为 https://example.com/product.jpg，按价格从高到低排序\n```\n\n**4. Paginated search**\n```\n在1688搜索与图片相似的商品，图片地址为 https://example.com/product.jpg，查询第2页，每页50条\n```\n\n**5. Price range filter**\n```\n在1688搜索与图片相似的商品，图片地址为 https://example.com/product.jpg，价格区间10-100元\n```\n\n## Display Rules\n\n1. **Present data clearly**: Show results in a structured table with key columns: product image, title, price, dropship price, monthly sales, minimum order quantity, repurchase rate, and seller identity\n2. **Image display**: When the response includes imageUrl for products, display them inline for visual comparison\n3. **Price display**: Always show price in CNY (¥) format\n4. **Seller badges**: Display seller identity badges (超级工厂/实力商家/诚信通会员) and product badges (严选) prominently\n5. **Result count**: Always inform the user of total results and current page/total pages\n6. **Pagination hint**: When more pages are available, suggest the user can request the next page\n7. **Filter/sort limitation**: If the user requests a sort or filter not in the supported list, do NOT attempt any workaround. Inform the user of the supported options\n8. **No secondary processing**: Results are real-time and not stored in a database, so secondary SQL/data processing is not available\n\n## Important Limitations\n\n1. **Data real-time nature**: Results are live searches, not stored in any database. Cannot use `_dataQuery_executeDynamicQuery` for secondary processing.\n2. **Logic constraint**: If the user requests sort or filter conditions not in the preset supported list, do NOT call any other tool or logic to compensate.\n3. **Image input**: One of imageUrl, imageBase64, or imageId is required. For page > 1, prefer passing imageId from the first page result to speed up queries.\n4. **Page size**: Maximum 50 results per page.\n\n## User Expression & Scenario Quick Reference\n\n**Applicable** -- Visual product sourcing scenarios on 1688:\n\n| User Says | Scenario |\n|-----------|----------|\n| \"1688以图搜图\" / \"用图片找1688货源\" | Basic image search |\n| \"帮我在1688找这个图片的同款\" | Find same-style products |\n| \"跨境找工厂，图片是...\" | Cross-border supplier sourcing |\n| \"这个Amazon产品在1688有没有货源\" | Reverse sourcing from Amazon image |\n| \"筛选1688严选的相似商品\" | Filtered image search |\n| \"按月销量排序找相似货源\" | Sorted image search |\n| \"查看第2页结果\" | Pagination |\n\n**Not applicable** -- Needs beyond 1688 image search:\n\n- Text/keyword-based 1688 search (use 店雷达-1688选品库)\n- 1688 product rankings/trending (use 店雷达-1688商品榜单)\n- Amazon image search (use 亚马逊前端-以图搜图)\n- Image generation or editing\n- Product review analysis\n- Price history or trend analysis\n\n**Boundary judgment**: When users say \"找货源\" or \"找同款\", if they provide an image URL and the intent is to find visually similar products on 1688, this skill applies. If they want keyword-based search or ranking data on 1688, use the 店雷达 tools instead.\n\n**Feedback:**\n\nAuto-detect and report feedback via the Feedback API when any of the following apply:\n1. The functionality or purpose described in this skill does not match actual behavior\n2. The skill's results do not match the user's intent\n3. The user expresses dissatisfaction or praise about this skill\n4. Anything you believe could be improved\n\nCall the feedback API as specified in `references/api.md`. Do not interrupt the user's flow.\n\n<!-- LF_LARGE_RESPONSE_BLOCK -->\n## Handling Large Responses\n\nTo avoid overflowing the agent context, persist the response to disk and extract only the fields you need:\n\n```\npython scripts/response_io.py run --script scripts/alibaba1688_image_search.py --out-dir <DIR> '<params>'\npython scripts/response_io.py read <file> --fields \"<paths>\"   # or --path \"<JMESPath>\"\n```\n\n> Pick `--out-dir` outside any git working tree (e.g. `/tmp/...` on Unix, `%TEMP%/...` on Windows). Persisted responses may contain PII, pricing, or auth-sensitive data — do not commit them. Files are not auto-deleted; clean up when the task is done.\n\n> This skill exposes multiple entry scripts: `alibaba1688_im","readmeExcerpt":"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","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"python scripts/upload_image.py /path/to/local/image.png"},{"language":"text","snippet":"在1688搜索与图片相似的商品，图片地址为 https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg"},{"language":"text","snippet":"在1688搜索与图片相似的商品，图片地址为 https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg，查询第1页，筛选1688严选，并按价格从高到低排序"},{"language":"text","snippet":"在1688搜索与图片相似的商品，图片地址为 https://example.com/product.jpg，按价格从高到低排序"},{"language":"text","snippet":"在1688搜索与图片相似的商品，图片地址为 https://example.com/product.jpg，查询第2页，每页50条"},{"language":"text","snippet":"在1688搜索与图片相似的商品，图片地址为 https://example.com/product.jpg，价格区间10-100元"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: linkfox-1688-search-by-image\ndescription: 1688平台以图搜图，通过商品图片精准检索外观相似或同款的1688货源，返回标题、价格、起批量、月销量、复购率、交易评分等核心数据。当用户提到1688以图搜图、1688找货源、以图找同款、跨境找工厂、1688识图、图片找货源、找相似货源、image search 1688、find supplier by image时触发此技能。即使用户未明确提及\"以图搜图\"，只要用户提供了图片URL并希望在1688上查找匹配或相似的货源商品，也应触发此技能。\n---\n\n# 1688 Image-Based Product Search\n\nThis skill performs visual product searches on the 1688 platform using an image URL, helping cross-border sellers find visually similar supplier products for sourcing.\n\n## Core Concepts\n\n1688 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.\n\n## Data Fields\n\n| Field | Description |\n|-------|-------------|\n| offerId | Product ID on 1688 |\n| title | Product title |\n| imageUrl | Product main image |\n| price | Wholesale price (CNY) |\n| consignPrice | Dropship price (CNY) |\n| salesQuantity | Monthly sales volume |\n| estimatedSalesAmount | Estimated monthly revenue |\n| quantityBegin | Minimum order quantity |\n| repurchaseRate | Repurchase rate |\n| tradeScore | Product trade score |\n| compositeServiceScore | Composite service experience score |\n| sellerIdentities | Seller identity (超级工厂/实力商家/诚信通会员) |\n| offerIdentities | Product badge (严选) |\n| sendGoodsAddressText | Shipping origin |\n| deliveryTime | Delivery time (24/48 hours) |\n| isOnePsale | Supports dropshipping (是/否) |\n| isJxhy | Premium sourcing (是/否) |\n| hasPromotion | Has promotion (是/否) |\n| isPatentProduct | Patent product (是/否) |\n\n## Parameter Guide\n\n**Image Rules:**\n1. Only png, jpg, jpeg formats are supported. webp, gif, and other formats are NOT supported.\n2. Base64 string must be pure encoded content WITHOUT the `data:image/jpeg;base64,` prefix.\n3. Image source — one of imageUrl, imageBase64, or imageId must be provided (at least one required).\n\n| Parameter | Required | Default | Description |\n|-----------|----------|---------|-------------|\n| imageUrl | Conditional | - | Public image URL (max 1000 chars). Only png/jpg/jpeg formats supported |\n| imageBase64 | Conditional | - | Pure Base64 encoded image string, without `data:image/...;base64,` prefix. Only png/jpg/jpeg supported |\n| imageId | Conditional | - | 1688 image ID from previous search result (speeds up pagination) |\n| page | No | 1 | Page number, starting from 1 |\n| pageSize | No | 20 | Results per page (1-50) |\n| priceStart | No | - | Min price filter (CNY) |\n| priceEnd | No | - | Max price filter (CNY) |\n| filter | No | - | Filter conditions, comma-separated (see supported filters below) |\n| sort | No | {\"monthSold\":\"desc\"} | Sort as JSON: {field: direction} (see supported sort fields below) |\n| keyword | No | - | Keyword to further filter results |\n| productCollectionId | No | - | Product collection ID (see supported IDs below) |\n\n### Supported Filters\n\nMultiple filters can be combined with commas (e.g. `"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n  \"slug\": \"linkfox-1688-search-by-image\",\n  \"version\": \"1.0.7\",\n  \"publishedAt\": 1789361546162\n}"},{"path":"references/api.md","content":"# 1688-以图搜图 API 参考\n\n## 调用规范\n\n- **请求地址**：`${LINKFOX_TOOL_GATEWAY}/alibaba1688/imageSearch`\n- **请求方式**：POST，Content-Type: application/json\n- **认证方式**：Header `Authorization: <api_key>`，api_key 优先从环境变量 `LINKFOX_AGENT_API_KEY` 读取，回退 `LINKFOXAGENT_API_KEY`（如未配置 按 SKILL.md 的 **## 解决认证和算力问题** 处理）\n- **User-Agent**：`LinkFox-Skill/1.0`\n- **超时**：150s\n\n## 请求参数\n\nPOST Body（JSON）：\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| imageUrl | string | 条件必填 | - | 图片URL地址，请确保图片URL有效且可公开访问。最大长度：1000。仅支持 png/jpg/jpeg 格式，不支持 webp/gif 等。imageUrl/imageBase64/imageId 三选一必填 |\n| imageBase64 | string | 条件必填 | - | 图片 Base64 编码字符串，为纯编码内容，不包含 `data:image/jpeg;base64,` 前缀。仅支持 png/jpg/jpeg 格式（imageUrl为空时使用） |\n| imageId | string | 条件必填 | - | 图片ID（1688图片ID），以图搜图查询结果中也会返回，建议当分页 page>1 查询时带 imageId，加快响应速度 |\n| page | int | 否 | 1 | 页码，从1开始 |\n| pageSize | int | 否 | 20 | 每页返回的商品数量，最大不超过50 |\n| priceStart | string | 否 | - | 价格筛选起始值（人民币），如 10 |\n| priceEnd | string | 否 | - | 价格筛选结束值（人民币），如 100 |\n| filter | string | 否 | - | 过滤条件，多个条件用逗号分隔。有效值见下方「支持的过滤条件」 |\n| sort | string | 否 | {\"monthSold\":\"desc\"} | 排序条件，JSON格式 {排序字段: 排序方式}。有效字段：price、rePurchaseRate、monthSold；方式：asc/desc |\n| keyword | string | 否 | - | 关键词，在结果中搜索 |\n| productCollectionId | string | 否 | - | 货盘ID，单选。有效值见下方「支持的货盘ID」 |\n\n### 支持的过滤条件\n\n多个条件用逗号分隔，如 `1688Selection,totalEpScoreLv1,qrr0`。\n\n| 值 | 说明 |\n|----|------|\n| 1688Selection | 1688严选 |\n| certifiedFactory | 认证工厂 |\n| totalEpScoreLv1 | 综合体验分5星 |\n| totalEpScoreLv2 | 综合体验分4星 |\n| totalEpScoreLv3 | 综合体验分3星 |\n| totalEpScoreLv4 | 综合体验分2星 |\n| qrr0 | 无品质退款 |\n| qrr1 | 品质退款率<1% |\n| qrr5 | 品质退款率<5% |\n| qrr10 | 品质退款率<10% |\n| shipInToday | 当日发货 |\n| shipIn24Hours | 24小时发货 |\n| shipIn48Hours | 48小时发货 |\n| noReason7DReturn | 7天无理由退货 |\n| isOnePsale | 一件代发 |\n| isOnePsaleFreePost | 一件代发包邮 |\n| new7 | 7天内新品 |\n| new30 | 30天内新品 |\n| isQqyx | 全球严选 |\n| JPFL | 日本专线 |\n| USFL | 美国专线 |\n| KRFL | 韩国专线 |\n| VNFL | 越南专线 |\n| SAFL | 沙特专线 |\n| RUFL | 俄罗斯专线 |\n| KZFL | 哈萨克斯坦专线 |\n| HKFL | 香港专线 |\n| MOFL | 澳门专线 |\n| TWFL | 台湾专线 |\n\n### 支持的排序字段\n\n| 字段 | 说明 |\n|------|------|\n| price | 价格 |\n| monthSold | 月销量 |\n| rePurchaseRate | 复购率 |\n\n排序方式：`asc`（升序）、`desc`（降序）。格式示例：`{\"price\":\"asc\"}`\n\n### 支持的货盘ID\n\n| ID | 说明 |\n|----|------|\n| 262105288 | 跨境货盘 |\n| 262105286 | 跨境货盘 |\n| 262105253 | 跨境货盘 |\n| 262105281 | 跨境货盘 |\n| 262105280 | 跨境货盘 |\n| 262105277 | 跨境货盘 |\n| 262105276 | 跨境货盘 |\n| 262105274 | 跨境货盘 |\n| 262105269 | 跨境货盘 |\n| 262185282 | 跨境货盘 |\n\n## 响应结构\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| imageId | string | 上传后的图片ID（分页查询时回传可加速） |\n| total | integer | 本页商品数量 |\n| totalPage | integer | 总页数 |\n| sourceType | string | 来源类型（固定值 \"1688\"） |\n| type | string | 渲染样式（固定值 \"productWorkbenches\"） |\n| columns | array | 渲染列定义 |\n| costToken | integer | 消耗 token |\n| products | array | 商品列表（详见下方商品字段） |\n\n### 商品字段\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| offerId | string | 商品ID |\n| asin | string | 商品编号（同 offerId） |\n| imageUrl | string | 商品图片 |\n| title | string | 商品标题 |\n| price | number | 批发价（元） |\n| consignPrice | number | 一件代发价（元） |\n| salesQuantity "},{"path":"references/onboarding.md","content":"# 解决认证和算力问题\n\n调用本 skill 时若网关返回 **auth** 或 **billing** 错误，走本 skill 自带的 `scripts/onboarding.py` 完成引导。\n\n**auth 场景**：`errcode=401` 或消息含 `authorized error`/`鉴权失败`/`未授权`/`unauthorized`；或 `LINKFOX_AGENT_API_KEY` 与 `LINKFOXAGENT_API_KEY` 均为空。\n1. 若已配置 key → 先让用户重启会话（最常见误判），仍失败让用户重新取 key 或换手机号重注册\n2. 未配置 → 询问：自助去 https://agent.linkfox.com/ 取 key，或提供手机号让脚本注册\n3. 手机号路径：\n   - `python scripts/onboarding.py send-code <phone>` → 展示 JSON 里的 phone/agreements\n   - 收到验证码后：`python scripts/onboarding.py login <phone> <code>`\n   - 拿到 `api_key` 后把下面三平台配置转发给用户，提示重启会话生效：\n     - Windows PowerShell（永久）：`setx LINKFOX_AGENT_API_KEY \"<key>\"`\n     - macOS zsh：`echo 'export LINKFOX_AGENT_API_KEY=\"<key>\"' >> ~/.zshrc && source ~/.zshrc`\n     - Linux bash：`echo 'export LINKFOX_AGENT_API_KEY=\"<key>\"' >> ~/.bashrc && source ~/.bashrc`\n     - 变量名 `LINKFOX_AGENT_API_KEY`（主推）或 `LINKFOXAGENT_API_KEY`（老规范）任一即可\n\n**billing 场景**：`errcode=402` 或消息含 `算力/余额/quota/insufficient/充值/套餐到期`。\n- `python scripts/onboarding.py list-plans` → 有 AskUserQuestion 就弹菜单，否则输出编号清单让用户选\n- 校验 `plan_id` ∈ 清单、支付方式 ∈ 该套餐 `available_methods`（通常 `wechat/alipay`）\n- `python scripts/onboarding.py order <plan_id> <method>` → 展示优先级 PNG > `pay_url` > `ascii_qr`（标注兜底）\n- 已付款可选调 `python scripts/onboarding.py query <order_id>`，不主动轮询\n\n排除 `errcode=403`（无权限，不归入这两类）。所有子命令输出 stdout JSON，`error` 字段已含阶段前缀，透传给用户即可。完整用法：`python scripts/onboarding.py --help`。"},{"path":"skill-card.md","content":"## Description:\n\nSearches 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.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[linkfox-ai](https://clawhub.ai/user/linkfox-ai)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal 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.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill uses LinkFox credentials for authenticated API calls and bundled account onboarding flows.\n\nMitigation: 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.\n\nRisk: Local image inputs may be uploaded to a public URL for search.\n\nMitigation: Use only images that are acceptable to expose publicly for the upload validity window, and avoid confidential product images unless disclosure is approved.\n\nRisk: Full search responses are saved locally and may include supplier, product, pricing, and query context.\n\nMitigation: Review the LinkFox session output directory after use and remove retained JSON files when they are no longer needed.\n\nRisk: Searches consume LinkFox compute credits and billing flows may be triggered for insufficient balance.\n\nMitigation: Confirm additional searches, pagination, and recharge actions with the user before proceeding.\n\nRisk: Custom LINKFOX_* endpoint environment variables can redirect traffic to alternate destinations.\n\nMitigation: Leave default endpoints in place unless the destination is explicitly trusted and reviewed.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/linkfox-ai/skills/linkfox-1688-search-by-image)\n- [1688-以图搜图 API reference](artifact/references/api.md)\n- [Authentication and billing onboarding](artifact/references/onboarding.md)\n- [LinkFox Skills](https://skill.linkfox.com/)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, JSON, shell commands, configuration, guidance]\n\n**Output Format:** [Markdown tables or JSON summaries, with complete API responses saved as JSON files.]\n\n**Output Parameters:** [1D]\n\n**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.]\n\n## Skill Version(s):\n\n1.0.7 (source: server release evidence)\n\n## Ethical Considerations:\n\nUsers 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"}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"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","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":1431,"uniquenessScore":51,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-11T04:31:00.889Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-11T04:31:00.889Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-11T07:42:53.980Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"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!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"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","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}