Xpersona
C

clawec-1688-product-search

CLAWHUB · Unverified

通过 Clawec API 搜索 1688 商品，返回价格、销量、链接、卖家信息与 AI 建议。在用户需要 1688 搜品、货源调研、供应链比价、跨境选品、关键词找货、1688 产品搜索时使用。 Skill: clawec-1688-product-search Owner: anyunzhong Summary: 通过 Clawec API 搜索 1688 商品，返回价格、销量、链接、卖家信息与 AI 建议。在用户需要 1688 搜品、货源调研、供应链比价、跨境选品、关键词找货、1688 产品搜索时使用。 Tags: latest:1.0.2 Version history: v1.0.2 | 2026-05-27T09:34:28.163Z | user - 更新了 API Key 注册和获取地址参数，从 source=q20005656 更改为 source=q-clawhub - 其余文档和功能保持不变 v1.0.1 | 2026-05-18T01:27:55.533Z | user - 更新了 API Key 获取说明，现在注册和获取 API Key 的链接附带 source 参数，简化了操作指引。 - 其余功

62
Rank
84
Safety
981
Downloads

About

What it does, and when to use it.

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

Avoid when

  • Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Install and run

Setup complexity: low.

clawhub skill install s177dw184d6sxdv0keedc8wq8x86s4wx:clawec-1688-product-search
  1. Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
  2. Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-anyunzhong-clawec-1688-product-search/snapshot"

Run-check

$0.02 USD

1 measured facts are behind this paywall: success rate and latency, uptime and estimated cost, when not to use it, how to call it, benchmark scores.

Agents pay $0.02 in USDC. A card payment is $0.50, the smallest a card allows.

Documentation

CLAWHUB

12,435 characters of source documentation, loaded on request.

Extracted files

4 files captured from the source.

SKILL.md

---
name: 1688-product-search
description: 通过 Clawec API 搜索 1688 商品，返回价格、销量、链接、卖家信息与 AI 建议。在用户需要 1688 搜品、货源调研、供应链比价、跨境选品、关键词找货、1688 产品搜索时使用。
---

# 1688 产品搜索

## 关于 ClawEC

ClawEC 是一款面向跨境电商场景的 AI 智能体协同平台，以「你的跨境电商 AI 团队」为品牌主张，将选品、调研、运营、上架、营销、客服、采购、合规等环节沉淀为可执行的 SOP（标准作业程序），通过多智能体（「虾员工」）分工协作与 7×24 小时自动化任务，帮助卖家在单人或少人条件下完成跨境业务闭环，降低对专业运营团队与复杂本地部署的依赖。

本技能调用 ClawEC 开放 API，用于 1688 货源搜索与供应链调研。

## 认证与基址

- **Base URL**: `https://www.clawec.com/api`
- **API Key**: 在 https://www.clawec.com/?source=q-clawhub  注册帐号     然后去https://www.clawec.com/api-key?source=q-clawhub  获取key
- **请求头**:
  - `Content-Type: application/json`
  - `Authorization: Bearer <API_KEY>`

优先从环境变量 `CLAWEC_API_KEY` 读取密钥；未设置时向用户索取，勿硬编码。

## 接口

`GET /aigc/tool/1688_product_search_lite`

| 参数 | 位置 | 必填 | 说明 |
|------|------|------|------|
| keyword | query | 是 | 搜索关键词 |
| page | query | 否 | 页码，默认 1 |
| table | query | 否 | 默认 0 |

## 调用

```bash
curl -s -G "https://www.clawec.com/api/aigc/tool/1688_product_search_lite" \
  --data-urlencode "keyword=蓝牙耳机" \
  --data-urlencode "page=1" \
  --data-urlencode "table=0" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $CLAWEC_API_KEY"
```

或使用脚本：

```bash
bash scripts/search.sh "蓝牙耳机" 1 0
```

## 响应结构

```json
{
  "status": 1,
  "data": [ ... ]
}
```

- `status`: `1` = 成功，`0` = 失败
- `data`: 商品数组，失败或空结果时按实际返回处理

### 商品字段

| 字段 | 说明 |
|------|------|
| name | 名称 |
| price | 价格 |
| sale | 销量 |
| cover | 封面图 URL |
| url | 商品链接 |
| id | 产品 ID |
| _1688Id | 1688 ID |
| aiSuggest | AI 建议 |
| features | 特点 `[{ label, value }]` |
| sellerInfo | 卖家 `{ name, url }` |
| purchaseCondition | 购买条件 `[{ label, value }]` |

完整字段说明见 [references/response-schema.md](references/response-schema.md)。

## 工作流程

1. 确认搜索关键词；需要翻页时确认 `page`
2. 检查 `CLAWEC_API_KEY` 是否可用
3. 执行 API 请求
4. `status !== 1` 或请求失败时，说明错误并提示检查密钥与参数
5. 解析 `data`，按用户需求整理输出

## 输出建议

默认中文摘要，包含：

- 命中数量与当前页码
- 商品对比表：名称、价格、销量、卖家、链接
- 展示 `aiSuggest`（若有）
- 货源调研场景：可按价格/销量排序，并给出 2–3 条选品观察

## 示例

**输入**：搜索「硅胶手机壳」，第 1 页

**输出摘要**：

| 名称 | 价格 | 销量 | 卖家 | 链接 |
|------|------|------|------|------|
| ... | ... | ... | ... | ... |

**AI 建议**：（摘录各商品 `aiSuggest` 中的要点）

_meta.json

{
  "ownerId": "kn72bgbct4wkjchp8k3z5cbzxs86sfys",
  "slug": "clawec-1688-product-search",
  "version": "1.0.2",
  "publishedAt": 1779874468163
}

references/response-schema.md

# 1688 产品搜索 — 响应结构

## 顶层

| 字段 | 类型 | 说明 |
|------|------|------|
| status | integer | `1` = 成功，`0` = 失败 |
| data | array | 商品列表 |

## _1688Product

| 字段 | 类型 | 说明 |
|------|------|------|
| price | string | 价格 |
| name | string | 名称 |
| sale | string | 销量 |
| cover | string | 封面 |
| url | string | 商品链接 |
| id | string | 产品 ID |
| aiSuggest | string | AI 建议 |
| features | Feature[] | 特点 |
| sellerInfo | Seller | 卖家信息 |
| purchaseCondition | Feature[] | 购买条件 |
| _1688Id | string | 1688 ID |

## Feature

| 字段 | 类型 | 说明 |
|------|------|------|
| label | string | 名称 |
| value | string | 值 |

## Seller

| 字段 | 类型 | 说明 |
|------|------|------|
| name | string | 卖家名称 |
| url | string | 卖家店铺链接 |

skill-card.md

## Description:

Searches 1688 products through the ClawEC API and returns prices, sales volume, links, seller information, and AI suggestions for sourcing research.

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

## Publisher:

[anyunzhong](https://clawhub.ai/user/anyunzhong)

### License/Terms of Use:

MIT-0

## Use Case:

External sellers, sourcing teams, and developers use this skill to search 1688 product listings, compare suppliers by price and sales signals, and summarize product-sourcing observations from ClawEC results.

### Deployment Geography for Use:

Global

## Known Risks and Mitigations:

Risk: Search keywords and the user-provided ClawEC API key are sent to clawec.com.

Mitigation: Use an API key intended only for ClawEC and avoid submitting sensitive search terms unless sharing them with the service is acceptable.

Risk: Product-search results and AI suggestions can be incomplete, stale, or unsuitable for a purchasing decision.

Mitigation: Review supplier details, prices, sales signals, and product links before acting on the recommendations.

## Reference(s):

- [1688 Product Search Response Schema](references/response-schema.md)
- [ClawEC API Base URL](https://www.clawec.com/api)
- [ClawEC 1688 Product Search Endpoint](https://www.clawec.com/api/aigc/tool/1688_product_search_lite)
- [ClawHub Skill Page](https://clawhub.ai/anyunzhong/skills/clawec-1688-product-search)

## Skill Output:

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

**Output Format:** [Markdown summaries with comparison tables and optional shell commands; raw API responses are JSON.]

**Output Parameters:** [1D]

**Other Properties Related to Output:** [Requires a user-provided CLAWEC_API_KEY and sends search keywords to clawec.com.]

## Skill Version(s):

1.0.2 (source: server release metadata)

## Ethical Considerations:

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

Sponsored

Ads related to clawec-1688-product-search and adjacent AI workflows.