agentCLAWHUBUnverified

极鲸云 Shein 商品搜索&分析

搜索和分析 SHEIN 商品,评估销量、价格、趋势与同款竞争 Skill: 极鲸云 Shein 商品搜索&分析 Owner: geekbi Summary: 搜索和分析 SHEIN 商品,评估销量、价格、趋势与同款竞争 Tags: latest:0.1.0 Version history: v0.1.0 | 2026-08-13T06:53:58.252Z | auto - Initial release of geekbi-shein-product-search-skill. - Enables SHEIN product search and analysis using Geekbi Cloud, supporting filtering by keyword, category ID, site, fulfillment mode, sales, price, and more. - Provides workflows and business rules for produc

OpenClaw

Rank

62

Safety

84

Downloads

1.6k

Updated

Oct 10, 2026

Version

0.1.0

Source

CLAWHUB

About

What it does, and when to use it.

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

Avoid when

  • Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor
Clawhubvendor · observed Oct 10, 2026
Protocol compatibility
OpenClawcompatibility · observed Oct 10, 2026
Adoption signal
1.6K downloadsadoption · observed Oct 10, 2026
Latest release
0.1.0release · observed Aug 13, 2026
Handshake status
UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s174eqt3xz844hgj4g79d0an318c07m7:geekbi-shein-product-search-skill
  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-geekbi-geekbi-shein-product-search-skill/snapshot"

Documentation

CLAWHUB

14,239 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: geekbi-shein-product-search-skill
description: 通过极鲸云搜索和分析 SHEIN 商品数据,按关键词、可信类目 ID、站点、托管模式、销量、销售额、价格、供货价、同款数、评分、上架时间等条件筛选商品,并完成热销榜、新品榜、低竞争商品、候选商品对比、价格带、销量趋势、竞争强度和选品机会判断。用户提到 SHEIN 商品搜索、找品、选品、爆款、新品、蓝海商品、低竞争商品、商品榜单、商品销量、商品价格、供货价、全托管、半托管、跟卖数、同款竞争、商品表现或候选商品比较时使用。只依据极鲸云真实返回的商品数据形成结论。
---

# 极鲸云 SHEIN 商品搜索

## 遵守原则

- 只使用极鲸云返回的真实数据,明确区分接口事实、可复算指标和经营判断。
- 直接运行查询脚本并复用极鲸云 SHEIN Skills 的统一登录态;已有登录态可用时不得主动重新登录。仅在服务端明确要求操作时,按 [查询暂停与恢复流程](references/查询暂停与恢复流程.md) 暂停并等待。
- 默认使用简体中文和绝对日期;记录站点、币种、时间口径、筛选条件、分页范围、样本量和数据更新时间。
- 对缺失值、异常值、估算值和未完成分页作显式说明,不用不完整数据支撑强结论。
- 面向用户使用中文业务名称,不展示脚本命令、英文参数或原始 JSON;仅在用户明确要求开发对接、故障排查或原始响应时展示必要技术信息。
- 使用服务端原样返回的 `linkUrl`。每次展示商品时都将标题写成可点击的 Markdown 链接,不自行拼接或猜测链接。

## 执行工作流

1. 明确用户的决策问题、目标站点、时间范围、商品意图、托管模式、价格带和其他硬性条件。不会显著改变结论时采用合理默认值并说明。
2. 读取 [SHEIN 商品搜索](references/SHEIN商品搜索.md) 和 [SHEIN 商品搜索接口](references/SHEIN商品搜索接口.md)。只有用户要求热销、新品、蓝海、新店、大卖或其他榜单时,再读取 [SHEIN 商品榜单查询预设](references/SHEIN商品榜单预设.md)。
3. 未指定站点时使用默认入口 `1`(名称“全部”,当前映射 `us`,不是跨国家聚合);用户明确指定美国站时使用 `2`。用户指定其他国家、地区、站点 UID 或域名时,运行 `python3 scripts/shein_site_list.py --country "国家或地区名"`;只接受唯一精确匹配,不猜测站点。
4. 生成全新的最小必要查询条件。仅在用户提供或上下文已有可信类目 ID 时使用类目筛选;没有可信类目 ID 时直接使用简洁关键词,不依赖其他 Skill 获取类目 ID,也不得根据类目名称猜测 ID。仅在用户明确要求类目内搜索特定商品时组合关键词和类目条件。
5. 运行 `python3 scripts/shein_goods_search.py`。认证模块自动读取统一登录态,不额外执行登录操作。
6. 检查响应、分页、关键字段、时间口径和可比性。服务端要求暂停时读取 [查询暂停与恢复流程](references/查询暂停与恢复流程.md),恢复后使用原条件重跑。
7. 按用户问题完成排序、筛选和必要计算。请求完整分布时逐页查询;只允许访问前 10000 条,命中超过 10000 时应缩小筛选范围。只读取部分页面时明确标为样本,不将当前页外推为全市场。
8. 交付结论、数据口径、关键证据、机会与风险及下一步动作。用户只要搜索结果或链接时保持简洁。

## 保持业务口径

- 将 `sold/sales` 解释为最近销量/销售额,将 `totalSold/totalSales` 解释为累计总量;未确认固定窗口时不把最近口径硬写成 90 天。
- 将日、周、月变化率按小数比例解释:`0.25` 表示增长 25%,`-0.1` 表示下降 10%。
- 将商品价格和销售额按当前 SHEIN 站点币种解释,将供货价按人民币解释;计算利润前先统一币种并说明汇率口径。
- 将托管模式按 `1=全托管`、`2=半托管` 解释;未限定时不擅自选择。
- 将 `similarNum` 面向用户统一称为“同款数(跟卖数)”:不超过 10 为优选区间,11 至 20 为中等竞争,超过 20 为高竞争;结合销量、增长、价格、供货价、评分和上架时间综合判断。
- 将单次商品搜索视为当前条件下的商品样本。统一站点、币种、时间窗和筛选边界后再比较;口径不一致时停止直接排名。

## 检查交付结果

默认按以下顺序输出:

1. 一句话结论。
2. 数据口径:站点、时间、条件、分页范围、样本量和更新时间。
3. 关键发现:仅展示影响决策的销量、增长、价格、供货价、同款数(跟卖数)、评分或时间指标。
4. 机会与风险:说明证据、限制和置信度。
5. 行动建议:给出优先级、验证动作和进入门槛。

发送答复前逐项检查:服务端返回非空 `linkUrl` 的每个已展示商品,都必须以 `[商品标题](<linkUrl>)` 形式出现。

README.md

# 极鲸云 SHEIN 商品搜索 Skill

通过极鲸云提供的真实 SHEIN 商品数据,为跨境卖家完成商品搜索、候选筛选和选品判断。该 Skill 可以按关键词、可信类目、站点、托管模式、销量、销售额、价格、供货价、同款数(跟卖数)、评分和上架时间等条件查找商品,帮助卖家发现热销款、新品和低竞争机会,并评估市场表现、价格空间与同行竞争压力。

## 主要能力

| 能力 | 可以解决的问题 |
| --- | --- |
| SHEIN 商品搜索 | 按关键词、可信类目 ID、站点、托管模式和经营条件查找目标商品,快速形成可验证的候选商品池 |
| 热销与新品发现 | 查询热销商品、日销排行和近期上架新品,识别正在起量或值得持续观察的商品 |
| 商品表现分析 | 比较最近与累计销量、销售额、增长率、评分、评论数量和上架时间,判断商品热度与生命周期 |
| 价格与供应空间评估 | 对比站点售价与人民币供货价,了解主流价格带并筛选具备进一步利润验证价值的候选 |
| 同款竞争判断 | 结合同款数(跟卖数)、销量、增长和价格评估同质化竞争与核价压力,发现相对低竞争机会 |

## 适用场景

本项目适合以下任务:

- SHEIN 跨境电商选品和候选商品筛选。
- 按关键词查找美国站或其他 SHEIN 站点的目标商品。
- 热销商品、日销排行和近期新品研究。
- 低同款、低竞争商品和潜力商品发现。
- 商品销量、销售额、价格、供货价和增长表现比较。
- 全托管、半托管商品及其市场表现比较。
- 为采购、测款和是否进入提供数据依据与验证建议。

## 安装 / 更新

请直接将下面这段话发送给支持 Skill 的 AI 助手,即可完成安装或更新到最新版本:

```text
安装这个Skill: https://github.com/geekbi/geekbi-shein-product-search-skill
```

## 开始使用

安装后直接用中文描述目标即可,例如:

```text
帮我找 SHEIN 美国站最近卖得最好的大码女装,并分析价格、销量和同款竞争。
```

```text
查找 SHEIN 德国站最近3个月上架、销量增长较快的宠物用品新品。
```

```text
帮我筛选 SHEIN 美国站售价20至40美元、供货价不超过80元、同款数不超过10的收纳商品。
```

```text
对比 SHEIN 美国站全托管和半托管无线充电器中销量最高的商品,判断哪些值得继续验证。
```

_meta.json

{
  "ownerId": "kn7aztmefa4fv3mdrqs9vagx7h8c14z2",
  "slug": "geekbi-shein-product-search-skill",
  "version": "0.1.0",
  "publishedAt": 1786604038252
}

references/SHEIN商品搜索.md

# SHEIN 商品搜索方法

## 适用问题

- 热销、日销、新品、低同款竞争、新店热销与大卖新品。
- 指定关键词、类目、价格带、托管模式、评分、评论量或上架时间找商品。
- 对比候选商品的销量、销售额、增长、价格、供货价与店铺实力。

需要榜单时读取 [商品榜单预设](SHEIN商品榜单预设.md),调用方式和完整字段见 [商品搜索接口](SHEIN商品搜索接口.md)。

## 查询步骤

1. 固定站点;未指定用默认入口 `1`(名称“全部”,当前映射 `us`,不是跨站聚合),明确美国用 `2`,其他站点实时解析。
2. 关键词和类目通常二选一。类目 ID 必须来自用户或类目搜索,不能按名称猜测。
3. 从全新参数对象加入硬条件,再选择与问题一致的单一排序字段。
4. 首次通常取 20–50 条;`total` 是精确命中数。需要完整分布时继续分页,最大每页 200、最多访问前 10000 条;命中超过 10000 时缩小筛选范围,不能把已取样本称为全量。
5. 先检查数据更新时间、缺失值与样本边界,再比较候选。

## 指标解释

- `sold/sales`:最近销量/销售额;`totalSold/totalSales`:累计总量。不得互换。
- 日、周、月指标用于近期表现;对应变化率是小数比例,`0.2` 表示增长 20%。
- `minPrice/maxPrice` 使用站点本地币种;供货价字段使用人民币。利润测算前统一币种,并另计平台费、物流、退货和广告成本。
- `similarNum` 对外称为“同款数(跟卖数)”,表示销售同一款商品的同行数量;数值越高通常代表核价和同质化竞争更强。
- `goodsScore/reviewNum` 分别反映评分与反馈规模;高销量低评分、低评论量高评分都需谨慎。
- `mallSold` 是关联店铺近 3 个月销量信号,不等于该商品销量。
- 托管模式只按 `1=全托管`、`2=半托管` 解释。
- 上架时间可能为空;筛选时服务端可回退采集创建时间,回答中不要把采集时间写成确定上架日。

## 选品判断

至少同时检查需求、趋势、竞争、价格空间、评价与店铺结构:

- 需求:最近销量、累计销量和销售额是否有足够绝对量。
- 趋势:日、周、月指标是否一致,增长是否由低基数造成。
- 竞争:同款数(跟卖数)、商品数量与头部集中是否过高。
- 经济性:售价与供货价价差是否足以覆盖全部成本。
- 质量:评分、评论量与评论痛点是否存在系统性风险。
- 可复制性:头部表现是否只来自单一大店或超长经营历史。

结果只证明命中当前筛选,不自动证明“爆品”或“蓝海”。

references/SHEIN商品搜索接口.md

# SHEIN 商品搜索接口

## 调用

```bash
python3 scripts/shein_goods_search.py \
  --param siteId=1 \
  --param keyword=dress \
  --param soldMin=100 \
  --param sort=daySold \
  --param order=desc \
  --param page=1 \
  --param size=20
```

每个查询条件单独使用一个 `--param 名称=值`。`catIds` 可重复传入;脚本保持多值。默认服务地址为 `https://openapi.geekbi.com`,仅开发测试时传 `--base-url`。

## 站点解析

- 未指定:传 `siteId=1`(名称“全部”,当前映射 `us`,不是跨站聚合)。
- 明确美国:传 `siteId=2`。
- 其他国家、地区、站点 UID 或域名:先运行:

```bash
python3 scripts/shein_site_list.py --country 德国
```

只在唯一命中后使用返回的 `siteId`;多义时请用户确认。

## 参数

基础条件:

| 参数 | 含义 |
| --- | --- |
| `keyword` | 商品名称、商品 ID、SPU、货号或店铺 ID 的混合查询,最长 300 字符 |
| `blockKeyword` | 排除商品名称中的词,最长 300 字符 |
| `matchMode` | `1` 严格 AND 匹配;`2` 75% 模糊匹配,默认 2 |
| `catIds` | 类目 ID,可重复;多个 ID 为 OR |
| `siteId` | 极鲸云 SHEIN 站点 ID |
| `hostingMode` | `1` 全托管;`2` 半托管;`0` 或不传为不限 |
| `page` / `size` | 页码默认 1;每页默认 20、最大 200;`page × size` 不得超过 10000 |
| `sort` / `order` | 排序字段;方向只允许 `asc` 或 `desc` |

数值范围均使用 `<指标>Min` / `<指标>Max`:

- 销量:`sold`、`totalSold`、`daySold`、`weekSold`、`monthSold`。
- 销量变化率:`daySoldRate`、`weekSoldRate`、`monthSoldRate`。
- 销售额:`sales`、`totalSales`、`daySales`、`weekSales`、`monthSales`。
- 销售额变化率:`daySalesRate`、`weekSalesRate`、`monthSalesRate`。
- 店铺与竞争:`mallSold`、`similarNum`。
- 价格与质量:`price`(过滤最低售价)、`supplyPrice`、`goodsScore`、`reviewNum`。

时间范围使用 ISO 8601:`onSaleTimeMin/Max`、`mallOpenTimeMin/Max`。最小值不得大于最大值。变化率传小数,如 `0.2` 表示 20%。

可排序字段:

```text
sold,totalSold,daySold,weekSold,monthSold,
daySoldRate,weekSoldRate,monthSoldRate,totalSoldRate,
sales,totalSales,daySales,weekSales,monthSales,
daySalesRate,weekSalesRate,monthSalesRate,totalSalesRate,
minPrice,maxPrice,supplyPrice,minSupplyPrice,medianSupplyPrice,maxSupplyPrice,
goodsScore,reviewNum,similarNum,similarNumUpdateTime,onSaleTime,
mallSold,mallOpenTime,createTime,updateTime
```

接口不接受 `siteUID`、商品状态、图片字段或精确同款数;同款数(跟卖数)仅用 Min/Max。

## 同款数(跟卖数)评估口径

- `similarNum` 对外统一称为“同款数(跟卖数)”,表示销售同一款商品的同行数量。
- 数值越大,同行越多、同质化竞争越强,通常核价通过概率也越低。
- 非工厂型卖家优先选择同款数不超过 10 的商品;超过 20 的候选默认降级或剔除,除非存在明确的价格、渠道、产品差异化或运营优势。
- 将同款数作为重要竞争指标,但同时结合销量及增长、供货价、商品价格、评价、上架时间和卖家自身能力综合判断。

## 响应

成功结构为 `code=0`,`data` 至少包含精确命中数 `total`、`list`、`site`。列表只允许分页访问前 10000 条;`total>10000` 时缩小筛选范围再做完整分布分析。每个商品公开:

- 标识:`id`、`goodsId`、`goodsSn`、`spuId`、`mallId`、`siteId`、`siteUID`、`linkUrl`。
- 基础:`hostingMode`、`thumbnail`、`goodsName`、`catId`、`catIds`、`catItems`。
- 竞争:`similarNum`、`similarNumUpdateTime`。
- 销量:`sold`、`daySold`、`weekSold`、`monthSold`、`totalSold` 及全部对应 Rate。
- 销售额:`sales`、`daySales`、`weekSales`、`monthSales`、`totalSales` 及全部对应 Rate。
- 价格:`minPrice`、`maxPrice`、`supplyPrice`、`minSupplyPrice`、`medianSupplyPrice`、`maxSupplyPrice`。
- 质量与店铺:`goodsScore`、`reviewNum`、`mallOpenTime`、`mallSold`。
- 时间:`onSaleTime`、`createTime`、`updateTime`。

`site` 包含站点名、域名、语言、货币符号、符号位置、汇率和千分位信息。接口不返回收藏等用户私有字段。

## 退出状态

- `0`:查询成功并输出 JSON。
- `2`:需要用户完成登录、额度或开通动作,按暂停流程处理。
- `1`:参数、网络或接口错误,错误 JSON 写入标准错误。
Github ReposUpdated 15h agoRank 70

AionUi

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

MCPOPENCLAW
Github ReposUpdated 6mo agoRank 70

activepieces

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

OPENCLAW
Github ReposUpdated 6mo agoRank 70

cherry-studio

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

MCPOPENCLAW
Github ReposUpdated 7mo agoRank 70

CopilotKit

The Frontend for Agents & Generative UI. React + Angular

OPENCLAW

Machine-readable data

The same record, as JSON, for agents and crawlers.

{
  "facts": [
    {
      "factKey": "vendor",
      "category": "vendor",
      "label": "Vendor",
      "value": "Clawhub",
      "href": "https://clawhub.ai/geekbi/skills/geekbi-shein-product-search-skill",
      "sourceUrl": "https://clawhub.ai/geekbi/skills/geekbi-shein-product-search-skill",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-10-10T06:05:27.613Z",
      "isPublic": true
    },
    {
      "factKey": "protocols",
      "category": "compatibility",
      "label": "Protocol compatibility",
      "value": "OpenClaw",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-geekbi-geekbi-shein-product-search-skill/contract",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-geekbi-geekbi-shein-product-search-skill/contract",
      "sourceType": "contract",
      "confidence": "medium",
      "observedAt": "2026-10-10T06:05:27.613Z",
      "isPublic": true
    },
    {
      "factKey": "traction",
      "category": "adoption",
      "label": "Adoption signal",
      "value": "1.6K downloads",
      "href": "https://clawhub.ai/geekbi/geekbi-shein-product-search-skill",
      "sourceUrl": "https://clawhub.ai/geekbi/geekbi-shein-product-search-skill",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-10-10T06:05:27.613Z",
      "isPublic": true
    },
    {
      "factKey": "latest_release",
      "category": "release",
      "label": "Latest release",
      "value": "0.1.0",
      "href": "https://clawhub.ai/geekbi/geekbi-shein-product-search-skill",
      "sourceUrl": "https://clawhub.ai/geekbi/geekbi-shein-product-search-skill",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-08-13T06:53:58.252Z",
      "isPublic": true
    },
    {
      "factKey": "handshake_status",
      "category": "security",
      "label": "Handshake status",
      "value": "UNKNOWN",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-geekbi-geekbi-shein-product-search-skill/trust",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-geekbi-geekbi-shein-product-search-skill/trust",
      "sourceType": "trust",
      "confidence": "medium",
      "observedAt": null,
      "isPublic": true
    }
  ],
  "events": [
    {
      "eventType": "release",
      "title": "Release 0.1.0",
      "description": "- Initial release of geekbi-shein-product-search-skill. - Enables SHEIN product search and analysis using Geekbi Cloud, supporting filtering by keyword, category ID, site, fulfillment mode, sales, price, and more. - Provides workflows and business rules for product list, bestseller, new arrivals, low-competition, and product comparison scenarios. - Delivers conclusions, key findings, opportunities, risks, and clear action steps, all strictly based on returned real-time data. - Ensures user responses are concise, accurate, and formatted for decision-making, with clickable product links and explicit explanations of data scope and limitations.",
      "href": "https://clawhub.ai/geekbi/geekbi-shein-product-search-skill",
      "sourceUrl": "https://clawhub.ai/geekbi/geekbi-shein-product-search-skill",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-08-13T06:53:58.252Z",
      "isPublic": true
    }
  ]
}

Record generated Oct 10, 2026.

Sponsored

Ads related to 极鲸云 Shein 商品搜索&分析 and adjacent AI workflows.