{"id":"32850824-de55-45cb-a95f-c704b9892c7a","entityType":"agent","slug":"clawhub-geekbi-geekbi-shein-product-search-skill","name":"极鲸云 Shein 商品搜索&分析","canonicalUrl":"https://www.xpersona.co/agent/clawhub-geekbi-geekbi-shein-product-search-skill","canonicalPath":"/agent/clawhub-geekbi-geekbi-shein-product-search-skill","generatedAt":"2026-10-10T11:01:22.884Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-10T06:05:27.613Z","emptyReason":null},"description":"搜索和分析 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","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.6K downloads reported by the source. Last updated 10/10/2026.","installCommand":"clawhub skill install s174eqt3xz844hgj4g79d0an318c07m7:geekbi-shein-product-search-skill","sourceUrl":"https://clawhub.ai/geekbi/geekbi-shein-product-search-skill","homepage":"https://clawhub.ai/geekbi/skills/geekbi-shein-product-search-skill","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/geekbi/geekbi-shein-product-search-skill","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/geekbi/skills/geekbi-shein-product-search-skill","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":64,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"搜索和分析 SHEIN 商品，评估销量、价格、趋势与同款竞争 Skill: 极鲸云 Shein 商品搜索&分析 Owner: geekbi Summary: 搜索和分析 SHEIN 商品，评估销量、价格、趋势与同款竞争 Tags: latest:0.1.0 Version history: v0.1.0 | 2026-"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-10T06:05:27.613Z","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-10T06:05:27.613Z","emptyReason":null},"stars":null,"forks":null,"downloads":1631,"packageName":null,"latestVersion":"0.1.0","tractionLabel":"1.6K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T06:05:27.613Z","emptyReason":null},"lastUpdatedAt":"2026-10-10T06:05:27.613Z","lastCrawledAt":"2026-10-10T06:05:27.613Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-11T06:05:27.613Z","lastVerifiedAt":null,"highlights":[{"version":"0.1.0","createdAt":"2026-08-13T06:53:58.252Z","changelog":"- 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.","fileCount":18,"zipByteSize":25140}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s174eqt3xz844hgj4g79d0an318c07m7:geekbi-shein-product-search-skill","setupComplexity":"low","setupSteps":["Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.","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-geekbi-geekbi-shein-product-search-skill/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-geekbi-geekbi-shein-product-search-skill/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-geekbi-geekbi-shein-product-search-skill/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-geekbi-geekbi-shein-product-search-skill/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-geekbi-geekbi-shein-product-search-skill/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-geekbi-geekbi-shein-product-search-skill/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-10T11:01:22.883Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-geekbi-geekbi-shein-product-search-skill/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-geekbi-geekbi-shein-product-search-skill/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-geekbi-geekbi-shein-product-search-skill/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-geekbi-geekbi-shein-product-search-skill/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-10T06:05:27.613Z","emptyReason":null},"readme":"Skill: 极鲸云 Shein 商品搜索&分析\n\nOwner: geekbi\n\nSummary: 搜索和分析 SHEIN 商品，评估销量、价格、趋势与同款竞争\n\nTags: latest:0.1.0\n\nVersion history:\n\nv0.1.0 | 2026-08-13T06:53:58.252Z | auto\n\n- Initial release of geekbi-shein-product-search-skill.\n- Enables SHEIN product search and analysis using Geekbi Cloud, supporting filtering by keyword, category ID, site, fulfillment mode, sales, price, and more.\n- Provides workflows and business rules for product list, bestseller, new arrivals, low-competition, and product comparison scenarios.\n- Delivers conclusions, key findings, opportunities, risks, and clear action steps, all strictly based on returned real-time data.\n- Ensures user responses are concise, accurate, and formatted for decision-making, with clickable product links and explicit explanations of data scope and limitations.\n\nArchive index:\n\nArchive v0.1.0: 18 files, 25140 bytes\n\nFiles: .gitignore (32b), agents (0b), agents/openai.yaml (258b), README.md (2518b), references (0b), references/SHEIN商品搜索.md (2758b), references/SHEIN商品搜索接口.md (4538b), references/SHEIN商品榜单预设.md (2793b), references/查询暂停与恢复流程.md (1588b), requirements.txt (23b), scripts (0b), scripts/geekbi_auth.py (23978b), scripts/shein_goods_search.py (4765b), scripts/shein_search_common.py (5306b), scripts/shein_site_list.py (3486b), skill-card.md (2962b), SKILL.md (5181b), _meta.json (152b)\n\nFile v0.1.0:SKILL.md\n\n---\nname: geekbi-shein-product-search-skill\ndescription: 通过极鲸云搜索和分析 SHEIN 商品数据，按关键词、可信类目 ID、站点、托管模式、销量、销售额、价格、供货价、同款数、评分、上架时间等条件筛选商品，并完成热销榜、新品榜、低竞争商品、候选商品对比、价格带、销量趋势、竞争强度和选品机会判断。用户提到 SHEIN 商品搜索、找品、选品、爆款、新品、蓝海商品、低竞争商品、商品榜单、商品销量、商品价格、供货价、全托管、半托管、跟卖数、同款竞争、商品表现或候选商品比较时使用。只依据极鲸云真实返回的商品数据形成结论。\n---\n\n# 极鲸云 SHEIN 商品搜索\n\n## 遵守原则\n\n- 只使用极鲸云返回的真实数据，明确区分接口事实、可复算指标和经营判断。\n- 直接运行查询脚本并复用极鲸云 SHEIN Skills 的统一登录态；已有登录态可用时不得主动重新登录。仅在服务端明确要求操作时，按 [查询暂停与恢复流程](references/查询暂停与恢复流程.md) 暂停并等待。\n- 默认使用简体中文和绝对日期；记录站点、币种、时间口径、筛选条件、分页范围、样本量和数据更新时间。\n- 对缺失值、异常值、估算值和未完成分页作显式说明，不用不完整数据支撑强结论。\n- 面向用户使用中文业务名称，不展示脚本命令、英文参数或原始 JSON；仅在用户明确要求开发对接、故障排查或原始响应时展示必要技术信息。\n- 使用服务端原样返回的 `linkUrl`。每次展示商品时都将标题写成可点击的 Markdown 链接，不自行拼接或猜测链接。\n\n## 执行工作流\n\n1. 明确用户的决策问题、目标站点、时间范围、商品意图、托管模式、价格带和其他硬性条件。不会显著改变结论时采用合理默认值并说明。\n2. 读取 [SHEIN 商品搜索](references/SHEIN商品搜索.md) 和 [SHEIN 商品搜索接口](references/SHEIN商品搜索接口.md)。只有用户要求热销、新品、蓝海、新店、大卖或其他榜单时，再读取 [SHEIN 商品榜单查询预设](references/SHEIN商品榜单预设.md)。\n3. 未指定站点时使用默认入口 `1`（名称“全部”，当前映射 `us`，不是跨国家聚合）；用户明确指定美国站时使用 `2`。用户指定其他国家、地区、站点 UID 或域名时，运行 `python3 scripts/shein_site_list.py --country \"国家或地区名\"`；只接受唯一精确匹配，不猜测站点。\n4. 生成全新的最小必要查询条件。仅在用户提供或上下文已有可信类目 ID 时使用类目筛选；没有可信类目 ID 时直接使用简洁关键词，不依赖其他 Skill 获取类目 ID，也不得根据类目名称猜测 ID。仅在用户明确要求类目内搜索特定商品时组合关键词和类目条件。\n5. 运行 `python3 scripts/shein_goods_search.py`。认证模块自动读取统一登录态，不额外执行登录操作。\n6. 检查响应、分页、关键字段、时间口径和可比性。服务端要求暂停时读取 [查询暂停与恢复流程](references/查询暂停与恢复流程.md)，恢复后使用原条件重跑。\n7. 按用户问题完成排序、筛选和必要计算。请求完整分布时逐页查询；只允许访问前 10000 条，命中超过 10000 时应缩小筛选范围。只读取部分页面时明确标为样本，不将当前页外推为全市场。\n8. 交付结论、数据口径、关键证据、机会与风险及下一步动作。用户只要搜索结果或链接时保持简洁。\n\n## 保持业务口径\n\n- 将 `sold/sales` 解释为最近销量/销售额，将 `totalSold/totalSales` 解释为累计总量；未确认固定窗口时不把最近口径硬写成 90 天。\n- 将日、周、月变化率按小数比例解释：`0.25` 表示增长 25%，`-0.1` 表示下降 10%。\n- 将商品价格和销售额按当前 SHEIN 站点币种解释，将供货价按人民币解释；计算利润前先统一币种并说明汇率口径。\n- 将托管模式按 `1=全托管`、`2=半托管` 解释；未限定时不擅自选择。\n- 将 `similarNum` 面向用户统一称为“同款数（跟卖数）”：不超过 10 为优选区间，11 至 20 为中等竞争，超过 20 为高竞争；结合销量、增长、价格、供货价、评分和上架时间综合判断。\n- 将单次商品搜索视为当前条件下的商品样本。统一站点、币种、时间窗和筛选边界后再比较；口径不一致时停止直接排名。\n\n## 检查交付结果\n\n默认按以下顺序输出：\n\n1. 一句话结论。\n2. 数据口径：站点、时间、条件、分页范围、样本量和更新时间。\n3. 关键发现：仅展示影响决策的销量、增长、价格、供货价、同款数（跟卖数）、评分或时间指标。\n4. 机会与风险：说明证据、限制和置信度。\n5. 行动建议：给出优先级、验证动作和进入门槛。\n\n发送答复前逐项检查：服务端返回非空 `linkUrl` 的每个已展示商品，都必须以 `[商品标题](<linkUrl>)` 形式出现。\n\nFile v0.1.0:README.md\n\n# 极鲸云 SHEIN 商品搜索 Skill\n\n通过极鲸云提供的真实 SHEIN 商品数据，为跨境卖家完成商品搜索、候选筛选和选品判断。该 Skill 可以按关键词、可信类目、站点、托管模式、销量、销售额、价格、供货价、同款数（跟卖数）、评分和上架时间等条件查找商品，帮助卖家发现热销款、新品和低竞争机会，并评估市场表现、价格空间与同行竞争压力。\n\n## 主要能力\n\n| 能力 | 可以解决的问题 |\n| --- | --- |\n| SHEIN 商品搜索 | 按关键词、可信类目 ID、站点、托管模式和经营条件查找目标商品，快速形成可验证的候选商品池 |\n| 热销与新品发现 | 查询热销商品、日销排行和近期上架新品，识别正在起量或值得持续观察的商品 |\n| 商品表现分析 | 比较最近与累计销量、销售额、增长率、评分、评论数量和上架时间，判断商品热度与生命周期 |\n| 价格与供应空间评估 | 对比站点售价与人民币供货价，了解主流价格带并筛选具备进一步利润验证价值的候选 |\n| 同款竞争判断 | 结合同款数（跟卖数）、销量、增长和价格评估同质化竞争与核价压力，发现相对低竞争机会 |\n\n## 适用场景\n\n本项目适合以下任务：\n\n- SHEIN 跨境电商选品和候选商品筛选。\n- 按关键词查找美国站或其他 SHEIN 站点的目标商品。\n- 热销商品、日销排行和近期新品研究。\n- 低同款、低竞争商品和潜力商品发现。\n- 商品销量、销售额、价格、供货价和增长表现比较。\n- 全托管、半托管商品及其市场表现比较。\n- 为采购、测款和是否进入提供数据依据与验证建议。\n\n## 安装 / 更新\n\n请直接将下面这段话发送给支持 Skill 的 AI 助手，即可完成安装或更新到最新版本：\n\n```text\n安装这个Skill: https://github.com/geekbi/geekbi-shein-product-search-skill\n```\n\n## 开始使用\n\n安装后直接用中文描述目标即可，例如：\n\n```text\n帮我找 SHEIN 美国站最近卖得最好的大码女装，并分析价格、销量和同款竞争。\n```\n\n```text\n查找 SHEIN 德国站最近3个月上架、销量增长较快的宠物用品新品。\n```\n\n```text\n帮我筛选 SHEIN 美国站售价20至40美元、供货价不超过80元、同款数不超过10的收纳商品。\n```\n\n```text\n对比 SHEIN 美国站全托管和半托管无线充电器中销量最高的商品，判断哪些值得继续验证。\n```\n\nFile v0.1.0:_meta.json\n\n{\n  \"ownerId\": \"kn7aztmefa4fv3mdrqs9vagx7h8c14z2\",\n  \"slug\": \"geekbi-shein-product-search-skill\",\n  \"version\": \"0.1.0\",\n  \"publishedAt\": 1786604038252\n}\n\nFile v0.1.0:references/SHEIN商品搜索.md\n\n# SHEIN 商品搜索方法\n\n## 适用问题\n\n- 热销、日销、新品、低同款竞争、新店热销与大卖新品。\n- 指定关键词、类目、价格带、托管模式、评分、评论量或上架时间找商品。\n- 对比候选商品的销量、销售额、增长、价格、供货价与店铺实力。\n\n需要榜单时读取 [商品榜单预设](SHEIN商品榜单预设.md)，调用方式和完整字段见 [商品搜索接口](SHEIN商品搜索接口.md)。\n\n## 查询步骤\n\n1. 固定站点；未指定用默认入口 `1`（名称“全部”，当前映射 `us`，不是跨站聚合），明确美国用 `2`，其他站点实时解析。\n2. 关键词和类目通常二选一。类目 ID 必须来自用户或类目搜索，不能按名称猜测。\n3. 从全新参数对象加入硬条件，再选择与问题一致的单一排序字段。\n4. 首次通常取 20–50 条；`total` 是精确命中数。需要完整分布时继续分页，最大每页 200、最多访问前 10000 条；命中超过 10000 时缩小筛选范围，不能把已取样本称为全量。\n5. 先检查数据更新时间、缺失值与样本边界，再比较候选。\n\n## 指标解释\n\n- `sold/sales`：最近销量/销售额；`totalSold/totalSales`：累计总量。不得互换。\n- 日、周、月指标用于近期表现；对应变化率是小数比例，`0.2` 表示增长 20%。\n- `minPrice/maxPrice` 使用站点本地币种；供货价字段使用人民币。利润测算前统一币种，并另计平台费、物流、退货和广告成本。\n- `similarNum` 对外称为“同款数（跟卖数）”，表示销售同一款商品的同行数量；数值越高通常代表核价和同质化竞争更强。\n- `goodsScore/reviewNum` 分别反映评分与反馈规模；高销量低评分、低评论量高评分都需谨慎。\n- `mallSold` 是关联店铺近 3 个月销量信号，不等于该商品销量。\n- 托管模式只按 `1=全托管`、`2=半托管` 解释。\n- 上架时间可能为空；筛选时服务端可回退采集创建时间，回答中不要把采集时间写成确定上架日。\n\n## 选品判断\n\n至少同时检查需求、趋势、竞争、价格空间、评价与店铺结构：\n\n- 需求：最近销量、累计销量和销售额是否有足够绝对量。\n- 趋势：日、周、月指标是否一致，增长是否由低基数造成。\n- 竞争：同款数（跟卖数）、商品数量与头部集中是否过高。\n- 经济性：售价与供货价价差是否足以覆盖全部成本。\n- 质量：评分、评论量与评论痛点是否存在系统性风险。\n- 可复制性：头部表现是否只来自单一大店或超长经营历史。\n\n结果只证明命中当前筛选，不自动证明“爆品”或“蓝海”。\n\nFile v0.1.0:references/SHEIN商品搜索接口.md\n\n# SHEIN 商品搜索接口\n\n## 调用\n\n```bash\npython3 scripts/shein_goods_search.py \\\n  --param siteId=1 \\\n  --param keyword=dress \\\n  --param soldMin=100 \\\n  --param sort=daySold \\\n  --param order=desc \\\n  --param page=1 \\\n  --param size=20\n```\n\n每个查询条件单独使用一个 `--param 名称=值`。`catIds` 可重复传入；脚本保持多值。默认服务地址为 `https://openapi.geekbi.com`，仅开发测试时传 `--base-url`。\n\n## 站点解析\n\n- 未指定：传 `siteId=1`（名称“全部”，当前映射 `us`，不是跨站聚合）。\n- 明确美国：传 `siteId=2`。\n- 其他国家、地区、站点 UID 或域名：先运行：\n\n```bash\npython3 scripts/shein_site_list.py --country 德国\n```\n\n只在唯一命中后使用返回的 `siteId`；多义时请用户确认。\n\n## 参数\n\n基础条件：\n\n| 参数 | 含义 |\n| --- | --- |\n| `keyword` | 商品名称、商品 ID、SPU、货号或店铺 ID 的混合查询，最长 300 字符 |\n| `blockKeyword` | 排除商品名称中的词，最长 300 字符 |\n| `matchMode` | `1` 严格 AND 匹配；`2` 75% 模糊匹配，默认 2 |\n| `catIds` | 类目 ID，可重复；多个 ID 为 OR |\n| `siteId` | 极鲸云 SHEIN 站点 ID |\n| `hostingMode` | `1` 全托管；`2` 半托管；`0` 或不传为不限 |\n| `page` / `size` | 页码默认 1；每页默认 20、最大 200；`page × size` 不得超过 10000 |\n| `sort` / `order` | 排序字段；方向只允许 `asc` 或 `desc` |\n\n数值范围均使用 `<指标>Min` / `<指标>Max`：\n\n- 销量：`sold`、`totalSold`、`daySold`、`weekSold`、`monthSold`。\n- 销量变化率：`daySoldRate`、`weekSoldRate`、`monthSoldRate`。\n- 销售额：`sales`、`totalSales`、`daySales`、`weekSales`、`monthSales`。\n- 销售额变化率：`daySalesRate`、`weekSalesRate`、`monthSalesRate`。\n- 店铺与竞争：`mallSold`、`similarNum`。\n- 价格与质量：`price`（过滤最低售价）、`supplyPrice`、`goodsScore`、`reviewNum`。\n\n时间范围使用 ISO 8601：`onSaleTimeMin/Max`、`mallOpenTimeMin/Max`。最小值不得大于最大值。变化率传小数，如 `0.2` 表示 20%。\n\n可排序字段：\n\n```text\nsold,totalSold,daySold,weekSold,monthSold,\ndaySoldRate,weekSoldRate,monthSoldRate,totalSoldRate,\nsales,totalSales,daySales,weekSales,monthSales,\ndaySalesRate,weekSalesRate,monthSalesRate,totalSalesRate,\nminPrice,maxPrice,supplyPrice,minSupplyPrice,medianSupplyPrice,maxSupplyPrice,\ngoodsScore,reviewNum,similarNum,similarNumUpdateTime,onSaleTime,\nmallSold,mallOpenTime,createTime,updateTime\n```\n\n接口不接受 `siteUID`、商品状态、图片字段或精确同款数；同款数（跟卖数）仅用 Min/Max。\n\n## 同款数（跟卖数）评估口径\n\n- `similarNum` 对外统一称为“同款数（跟卖数）”，表示销售同一款商品的同行数量。\n- 数值越大，同行越多、同质化竞争越强，通常核价通过概率也越低。\n- 非工厂型卖家优先选择同款数不超过 10 的商品；超过 20 的候选默认降级或剔除，除非存在明确的价格、渠道、产品差异化或运营优势。\n- 将同款数作为重要竞争指标，但同时结合销量及增长、供货价、商品价格、评价、上架时间和卖家自身能力综合判断。\n\n## 响应\n\n成功结构为 `code=0`，`data` 至少包含精确命中数 `total`、`list`、`site`。列表只允许分页访问前 10000 条；`total>10000` 时缩小筛选范围再做完整分布分析。每个商品公开：\n\n- 标识：`id`、`goodsId`、`goodsSn`、`spuId`、`mallId`、`siteId`、`siteUID`、`linkUrl`。\n- 基础：`hostingMode`、`thumbnail`、`goodsName`、`catId`、`catIds`、`catItems`。\n- 竞争：`similarNum`、`similarNumUpdateTime`。\n- 销量：`sold`、`daySold`、`weekSold`、`monthSold`、`totalSold` 及全部对应 Rate。\n- 销售额：`sales`、`daySales`、`weekSales`、`monthSales`、`totalSales` 及全部对应 Rate。\n- 价格：`minPrice`、`maxPrice`、`supplyPrice`、`minSupplyPrice`、`medianSupplyPrice`、`maxSupplyPrice`。\n- 质量与店铺：`goodsScore`、`reviewNum`、`mallOpenTime`、`mallSold`。\n- 时间：`onSaleTime`、`createTime`、`updateTime`。\n\n`site` 包含站点名、域名、语言、货币符号、符号位置、汇率和千分位信息。接口不返回收藏等用户私有字段。\n\n## 退出状态\n\n- `0`：查询成功并输出 JSON。\n- `2`：需要用户完成登录、额度或开通动作，按暂停流程处理。\n- `1`：参数、网络或接口错误，错误 JSON 写入标准错误。\n\nFile v0.1.0:references/SHEIN商品榜单预设.md\n\n# SHEIN 商品榜单查询预设\n\n根据用户榜单或选品意图选择一个主预设，用户明确条件始终优先。预设依据 `geekbi-web-v2` 当前实际请求参数整理；文案与代码不一致时以代码为准。\n\n## 使用规则\n\n- 不叠加多个预设；从全新参数对象生成请求，避免网页或上一轮残留条件污染结果。\n- 默认补 `siteId=1`（名称“全部”，当前映射 `us`，不是跨站聚合）；明确美国用 `2`，其他站点实时解析。再补页码和每页数量。\n- 关键词与类目通常二选一；只有用户明确交叉限定时才组合。\n- 排序方向只用 `asc|desc`。\n- “近 3 个月”按执行时刻减 3 个自然月，转换成带时区 ISO 8601 绝对时间。\n- 预设只定义筛选和排序，不代表命中结果必然是爆品或蓝海。\n\n## 预设\n\n### 热销商品\n\n```text\nsort=sold\norder=desc\n```\n\n按最近销量排序，不把 `sold` 写成累计总销量。\n\n### 日销排行\n\n```text\nsoldMin=10000\nsort=daySold\norder=desc\n```\n\n这是网页当前真实条件；最低最近销量 10000 是榜单门槛，不是日销量门槛。\n\n### 蓝海爆品\n\n```text\nsoldMin=100\nsimilarNumMin=1\nsimilarNumMax=30\nonSaleTimeMin=<执行时刻减3个自然月的ISO时间>\nonSaleTimeMax=<执行时刻的ISO时间>\nsort=daySold\norder=desc\n```\n\n这是网页内置模板的实际宽口径。网页文案中的“销量不超过 1000”并非请求条件，不自动补 `soldMax`。命中后仍应优先保留同款数（跟卖数）不超过 10 的候选，并将超过 20 的候选标为竞争偏高。\n\n### 严格低同款竞争（Skill 补充）\n\n需要更严格的低竞争候选时，使用与蓝海爆品相同条件，但改为：\n\n```text\nsimilarNumMax=10\n```\n\n结果不足且用户接受放宽时可升至 20；这个补充预设不是网页内置模板。\n\n### 热销新品\n\n```text\nonSaleTimeMin=<执行时刻减3个自然月的ISO时间>\nonSaleTimeMax=<执行时刻的ISO时间>\nsort=sold\norder=desc\n```\n\n### 新店热销\n\n```text\nmallOpenTimeMin=<执行时刻减3个自然月的ISO时间>\nmallOpenTimeMax=<执行时刻的ISO时间>\nsort=sold\norder=desc\n```\n\n### 大卖新品\n\n```text\nonSaleTimeMin=<执行时刻减3个自然月的ISO时间>\nonSaleTimeMax=<执行时刻的ISO时间>\nsort=mallSold\norder=desc\n```\n\n网页文案曾写“近 1 个月”，实际请求是近 3 个月；本预设按实际请求。\n\n## 请求前检查\n\n1. 站点是否正确，是否误把名称“全部”的 `1` 写成跨站聚合。\n2. 相对时间是否已变为绝对 ISO 8601。\n3. 是否只使用有效接口参数与 `asc|desc`。\n4. 是否区分网页蓝海宽口径 30 与 Skill 严格低竞争口径 10。\n5. 是否在取得数据后结合销量、趋势、价格、评分和店铺结构验证标签。\n\nFile v0.1.0:references/查询暂停与恢复流程.md\n\n# 查询暂停与恢复流程\n\n业务脚本先正常查询。服务端在 `data.jumpUrl` 中返回操作地址，表示因未登录或其他可恢复条件要求暂停时：\n\n1. 原样使用服务端中文 `msg`，不改写含义。\n2. 将 `jumpUrl` 展示为可点击 Markdown 链接，不自行生成或改写。\n3. 停止数据查询，不展示内部状态或在尚未取得数据时生成业务结论。\n4. 用户完成操作、限制解除或回复“继续”后，原样重跑原业务请求。\n5. 条件仍未满足时使用服务端最新提示；链接失效时重跑请求取得新链接。\n\n非零业务响应没有 `jumpUrl` 时属于普通错误，不进入暂停状态；优先展示服务端一级 `msg`，没有有效提示时才使用脚本中文错误。\n\n## 信息保护\n\n- 查询鉴权与暂停状态由公共请求脚本统一处理，业务脚本直接复用。\n- 所有极鲸云 SHEIN Skills 共用同一个系统用户配置路径和同一份鉴权状态；任意一个 Skill 完成登录后，其他 Skill 优先复用该状态，有效期内不重复登录。\n- 登录凭据依次保存在系统用户配置目录、Skill 的 `.geekbi/agent-auth.json`、当前工作目录的 `.geekbi/agent-auth.json`；读取使用首个存在的副本。\n- 不手工复制、输出或传递登录状态文件；跨 Skill 复用由公共系统配置路径自动完成。\n- 不展示访问令牌、设备码、回调凭据、权限标识、请求头或内部状态对象。\n- 不把账号、密码、密钥或令牌写入文档、示例、回答、日志或命令行参数。\n\nFile v0.1.0:skill-card.md\n\n## Description:\n\nSearches GeekBI Cloud SHEIN product data so sellers can filter and analyze products by keyword, category, site, hosting mode, sales, price, supply price, ratings, listing time, and competition signals.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[geekbi](https://clawhub.ai/user/geekbi)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal sellers and ecommerce analysts use this skill to research SHEIN product opportunities, compare candidate products, and form selection decisions from GeekBI Cloud data. It supports bestseller, new-arrival, low-competition, price-band, sales-trend, and product-comparison workflows.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill stores GeekBI login tokens in local configuration, skill, or working-directory state files.\n\nMitigation: Review local state locations before installation and remove any .geekbi/agent-auth.json files from the skill or working directory if they appear.\n\nRisk: The skill may surface server-provided login or action links during authentication or quota workflows.\n\nMitigation: Use only the official GeekBI endpoint and verify any login link before opening it.\n\nRisk: Incomplete pagination, missing values, or inconsistent site, currency, and time windows can lead to misleading product conclusions.\n\nMitigation: Require responses to disclose filters, pagination, sample size, data update time, missing values, and limitations before making selection recommendations.\n\n## Reference(s):\n\n- [Server-resolved GitHub provenance](https://github.com/geekbi/geekbi-shein-product-search-skill)\n- [ClawHub skill page](https://clawhub.ai/geekbi/skills/geekbi-shein-product-search-skill)\n- [GeekBI publisher profile](https://clawhub.ai/user/geekbi)\n- [GeekBI Cloud API endpoint](https://openapi.geekbi.com)\n- [SHEIN 商品搜索方法](references/SHEIN商品搜索.md)\n- [SHEIN 商品搜索接口](references/SHEIN商品搜索接口.md)\n- [SHEIN 商品榜单查询预设](references/SHEIN商品榜单预设.md)\n- [查询暂停与恢复流程](references/查询暂停与恢复流程.md)\n\n## Skill Output:\n\n**Output Type(s):** [Analysis, Markdown, Shell commands, Guidance]\n\n**Output Format:** [Markdown with concise business analysis, clickable product links, and occasional shell commands or JSON only when troubleshooting or integration details are requested.]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Responses should state data scope, filters, site, currency, pagination range, sample size, update time, opportunity/risk rationale, and next actions.]\n\n## Skill Version(s):\n\n0.1.0 (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\nFile v0.1.0:agents/openai.yaml\n\ninterface:\n  display_name: \"极鲸云 SHEIN 商品搜索\"\n  short_description: \"搜索和分析 SHEIN 商品，评估销量、价格、趋势与同款竞争\"\n  default_prompt: \"使用 $geekbi-shein-product-search-skill 搜索并分析 SHEIN 商品机会。\"\n\nFile v0.1.0:requirements.txt\n\nplatformdirs>=4.0,<5.0","readmeExcerpt":"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","codeSnippets":[],"executableExamples":[{"language":"text","snippet":"安装这个Skill: https://github.com/geekbi/geekbi-shein-product-search-skill"},{"language":"text","snippet":"帮我找 SHEIN 美国站最近卖得最好的大码女装，并分析价格、销量和同款竞争。"},{"language":"text","snippet":"查找 SHEIN 德国站最近3个月上架、销量增长较快的宠物用品新品。"},{"language":"text","snippet":"帮我筛选 SHEIN 美国站售价20至40美元、供货价不超过80元、同款数不超过10的收纳商品。"},{"language":"text","snippet":"对比 SHEIN 美国站全托管和半托管无线充电器中销量最高的商品，判断哪些值得继续验证。"},{"language":"bash","snippet":"python3 scripts/shein_goods_search.py \\\n  --param siteId=1 \\\n  --param keyword=dress \\\n  --param soldMin=100 \\\n  --param sort=daySold \\\n  --param order=desc \\\n  --param page=1 \\\n  --param size=20"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: geekbi-shein-product-search-skill\ndescription: 通过极鲸云搜索和分析 SHEIN 商品数据，按关键词、可信类目 ID、站点、托管模式、销量、销售额、价格、供货价、同款数、评分、上架时间等条件筛选商品，并完成热销榜、新品榜、低竞争商品、候选商品对比、价格带、销量趋势、竞争强度和选品机会判断。用户提到 SHEIN 商品搜索、找品、选品、爆款、新品、蓝海商品、低竞争商品、商品榜单、商品销量、商品价格、供货价、全托管、半托管、跟卖数、同款竞争、商品表现或候选商品比较时使用。只依据极鲸云真实返回的商品数据形成结论。\n---\n\n# 极鲸云 SHEIN 商品搜索\n\n## 遵守原则\n\n- 只使用极鲸云返回的真实数据，明确区分接口事实、可复算指标和经营判断。\n- 直接运行查询脚本并复用极鲸云 SHEIN Skills 的统一登录态；已有登录态可用时不得主动重新登录。仅在服务端明确要求操作时，按 [查询暂停与恢复流程](references/查询暂停与恢复流程.md) 暂停并等待。\n- 默认使用简体中文和绝对日期；记录站点、币种、时间口径、筛选条件、分页范围、样本量和数据更新时间。\n- 对缺失值、异常值、估算值和未完成分页作显式说明，不用不完整数据支撑强结论。\n- 面向用户使用中文业务名称，不展示脚本命令、英文参数或原始 JSON；仅在用户明确要求开发对接、故障排查或原始响应时展示必要技术信息。\n- 使用服务端原样返回的 `linkUrl`。每次展示商品时都将标题写成可点击的 Markdown 链接，不自行拼接或猜测链接。\n\n## 执行工作流\n\n1. 明确用户的决策问题、目标站点、时间范围、商品意图、托管模式、价格带和其他硬性条件。不会显著改变结论时采用合理默认值并说明。\n2. 读取 [SHEIN 商品搜索](references/SHEIN商品搜索.md) 和 [SHEIN 商品搜索接口](references/SHEIN商品搜索接口.md)。只有用户要求热销、新品、蓝海、新店、大卖或其他榜单时，再读取 [SHEIN 商品榜单查询预设](references/SHEIN商品榜单预设.md)。\n3. 未指定站点时使用默认入口 `1`（名称“全部”，当前映射 `us`，不是跨国家聚合）；用户明确指定美国站时使用 `2`。用户指定其他国家、地区、站点 UID 或域名时，运行 `python3 scripts/shein_site_list.py --country \"国家或地区名\"`；只接受唯一精确匹配，不猜测站点。\n4. 生成全新的最小必要查询条件。仅在用户提供或上下文已有可信类目 ID 时使用类目筛选；没有可信类目 ID 时直接使用简洁关键词，不依赖其他 Skill 获取类目 ID，也不得根据类目名称猜测 ID。仅在用户明确要求类目内搜索特定商品时组合关键词和类目条件。\n5. 运行 `python3 scripts/shein_goods_search.py`。认证模块自动读取统一登录态，不额外执行登录操作。\n6. 检查响应、分页、关键字段、时间口径和可比性。服务端要求暂停时读取 [查询暂停与恢复流程](references/查询暂停与恢复流程.md)，恢复后使用原条件重跑。\n7. 按用户问题完成排序、筛选和必要计算。请求完整分布时逐页查询；只允许访问前 10000 条，命中超过 10000 时应缩小筛选范围。只读取部分页面时明确标为样本，不将当前页外推为全市场。\n8. 交付结论、数据口径、关键证据、机会与风险及下一步动作。用户只要搜索结果或链接时保持简洁。\n\n## 保持业务口径\n\n- 将 `sold/sales` 解释为最近销量/销售额，将 `totalSold/totalSales` 解释为累计总量；未确认固定窗口时不把最近口径硬写成 90 天。\n- 将日、周、月变化率按小数比例解释：`0.25` 表示增长 25%，`-0.1` 表示下降 10%。\n- 将商品价格和销售额按当前 SHEIN 站点币种解释，将供货价按人民币解释；计算利润前先统一币种并说明汇率口径。\n- 将托管模式按 `1=全托管`、`2=半托管` 解释；未限定时不擅自选择。\n- 将 `similarNum` 面向用户统一称为“同款数（跟卖数）”：不超过 10 为优选区间，11 至 20 为中等竞争，超过 20 为高竞争；结合销量、增长、价格、供货价、评分和上架时间综合判断。\n- 将单次商品搜索视为当前条件下的商品样本。统一站点、币种、时间窗和筛选边界后再比较；口径不一致时停止直接排名。\n\n## 检查交付结果\n\n默认按以下顺序输出：\n\n1. 一句话结论。\n2. 数据口径：站点、时间、条件、分页范围、样本量和更新时间。\n3. 关键发现：仅展示影响决策的销量、增长、价格、供货价、同款数（跟卖数）、评分或时间指标。\n4. 机会与风险：说明证据、限制和置信度。\n5. 行动建议：给出优先级、验证动作和进入门槛。\n\n发送答复前逐项检查：服务端返回非空 `linkUrl` 的每个已展示商品，都必须以 `[商品标题](<linkUrl>)` 形式出现。"},{"path":"README.md","content":"# 极鲸云 SHEIN 商品搜索 Skill\n\n通过极鲸云提供的真实 SHEIN 商品数据，为跨境卖家完成商品搜索、候选筛选和选品判断。该 Skill 可以按关键词、可信类目、站点、托管模式、销量、销售额、价格、供货价、同款数（跟卖数）、评分和上架时间等条件查找商品，帮助卖家发现热销款、新品和低竞争机会，并评估市场表现、价格空间与同行竞争压力。\n\n## 主要能力\n\n| 能力 | 可以解决的问题 |\n| --- | --- |\n| SHEIN 商品搜索 | 按关键词、可信类目 ID、站点、托管模式和经营条件查找目标商品，快速形成可验证的候选商品池 |\n| 热销与新品发现 | 查询热销商品、日销排行和近期上架新品，识别正在起量或值得持续观察的商品 |\n| 商品表现分析 | 比较最近与累计销量、销售额、增长率、评分、评论数量和上架时间，判断商品热度与生命周期 |\n| 价格与供应空间评估 | 对比站点售价与人民币供货价，了解主流价格带并筛选具备进一步利润验证价值的候选 |\n| 同款竞争判断 | 结合同款数（跟卖数）、销量、增长和价格评估同质化竞争与核价压力，发现相对低竞争机会 |\n\n## 适用场景\n\n本项目适合以下任务：\n\n- SHEIN 跨境电商选品和候选商品筛选。\n- 按关键词查找美国站或其他 SHEIN 站点的目标商品。\n- 热销商品、日销排行和近期新品研究。\n- 低同款、低竞争商品和潜力商品发现。\n- 商品销量、销售额、价格、供货价和增长表现比较。\n- 全托管、半托管商品及其市场表现比较。\n- 为采购、测款和是否进入提供数据依据与验证建议。\n\n## 安装 / 更新\n\n请直接将下面这段话发送给支持 Skill 的 AI 助手，即可完成安装或更新到最新版本：\n\n```text\n安装这个Skill: https://github.com/geekbi/geekbi-shein-product-search-skill\n```\n\n## 开始使用\n\n安装后直接用中文描述目标即可，例如：\n\n```text\n帮我找 SHEIN 美国站最近卖得最好的大码女装，并分析价格、销量和同款竞争。\n```\n\n```text\n查找 SHEIN 德国站最近3个月上架、销量增长较快的宠物用品新品。\n```\n\n```text\n帮我筛选 SHEIN 美国站售价20至40美元、供货价不超过80元、同款数不超过10的收纳商品。\n```\n\n```text\n对比 SHEIN 美国站全托管和半托管无线充电器中销量最高的商品，判断哪些值得继续验证。\n```"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn7aztmefa4fv3mdrqs9vagx7h8c14z2\",\n  \"slug\": \"geekbi-shein-product-search-skill\",\n  \"version\": \"0.1.0\",\n  \"publishedAt\": 1786604038252\n}"},{"path":"references/SHEIN商品搜索.md","content":"# SHEIN 商品搜索方法\n\n## 适用问题\n\n- 热销、日销、新品、低同款竞争、新店热销与大卖新品。\n- 指定关键词、类目、价格带、托管模式、评分、评论量或上架时间找商品。\n- 对比候选商品的销量、销售额、增长、价格、供货价与店铺实力。\n\n需要榜单时读取 [商品榜单预设](SHEIN商品榜单预设.md)，调用方式和完整字段见 [商品搜索接口](SHEIN商品搜索接口.md)。\n\n## 查询步骤\n\n1. 固定站点；未指定用默认入口 `1`（名称“全部”，当前映射 `us`，不是跨站聚合），明确美国用 `2`，其他站点实时解析。\n2. 关键词和类目通常二选一。类目 ID 必须来自用户或类目搜索，不能按名称猜测。\n3. 从全新参数对象加入硬条件，再选择与问题一致的单一排序字段。\n4. 首次通常取 20–50 条；`total` 是精确命中数。需要完整分布时继续分页，最大每页 200、最多访问前 10000 条；命中超过 10000 时缩小筛选范围，不能把已取样本称为全量。\n5. 先检查数据更新时间、缺失值与样本边界，再比较候选。\n\n## 指标解释\n\n- `sold/sales`：最近销量/销售额；`totalSold/totalSales`：累计总量。不得互换。\n- 日、周、月指标用于近期表现；对应变化率是小数比例，`0.2` 表示增长 20%。\n- `minPrice/maxPrice` 使用站点本地币种；供货价字段使用人民币。利润测算前统一币种，并另计平台费、物流、退货和广告成本。\n- `similarNum` 对外称为“同款数（跟卖数）”，表示销售同一款商品的同行数量；数值越高通常代表核价和同质化竞争更强。\n- `goodsScore/reviewNum` 分别反映评分与反馈规模；高销量低评分、低评论量高评分都需谨慎。\n- `mallSold` 是关联店铺近 3 个月销量信号，不等于该商品销量。\n- 托管模式只按 `1=全托管`、`2=半托管` 解释。\n- 上架时间可能为空；筛选时服务端可回退采集创建时间，回答中不要把采集时间写成确定上架日。\n\n## 选品判断\n\n至少同时检查需求、趋势、竞争、价格空间、评价与店铺结构：\n\n- 需求：最近销量、累计销量和销售额是否有足够绝对量。\n- 趋势：日、周、月指标是否一致，增长是否由低基数造成。\n- 竞争：同款数（跟卖数）、商品数量与头部集中是否过高。\n- 经济性：售价与供货价价差是否足以覆盖全部成本。\n- 质量：评分、评论量与评论痛点是否存在系统性风险。\n- 可复制性：头部表现是否只来自单一大店或超长经营历史。\n\n结果只证明命中当前筛选，不自动证明“爆品”或“蓝海”。"},{"path":"references/SHEIN商品搜索接口.md","content":"# SHEIN 商品搜索接口\n\n## 调用\n\n```bash\npython3 scripts/shein_goods_search.py \\\n  --param siteId=1 \\\n  --param keyword=dress \\\n  --param soldMin=100 \\\n  --param sort=daySold \\\n  --param order=desc \\\n  --param page=1 \\\n  --param size=20\n```\n\n每个查询条件单独使用一个 `--param 名称=值`。`catIds` 可重复传入；脚本保持多值。默认服务地址为 `https://openapi.geekbi.com`，仅开发测试时传 `--base-url`。\n\n## 站点解析\n\n- 未指定：传 `siteId=1`（名称“全部”，当前映射 `us`，不是跨站聚合）。\n- 明确美国：传 `siteId=2`。\n- 其他国家、地区、站点 UID 或域名：先运行：\n\n```bash\npython3 scripts/shein_site_list.py --country 德国\n```\n\n只在唯一命中后使用返回的 `siteId`；多义时请用户确认。\n\n## 参数\n\n基础条件：\n\n| 参数 | 含义 |\n| --- | --- |\n| `keyword` | 商品名称、商品 ID、SPU、货号或店铺 ID 的混合查询，最长 300 字符 |\n| `blockKeyword` | 排除商品名称中的词，最长 300 字符 |\n| `matchMode` | `1` 严格 AND 匹配；`2` 75% 模糊匹配，默认 2 |\n| `catIds` | 类目 ID，可重复；多个 ID 为 OR |\n| `siteId` | 极鲸云 SHEIN 站点 ID |\n| `hostingMode` | `1` 全托管；`2` 半托管；`0` 或不传为不限 |\n| `page` / `size` | 页码默认 1；每页默认 20、最大 200；`page × size` 不得超过 10000 |\n| `sort` / `order` | 排序字段；方向只允许 `asc` 或 `desc` |\n\n数值范围均使用 `<指标>Min` / `<指标>Max`：\n\n- 销量：`sold`、`totalSold`、`daySold`、`weekSold`、`monthSold`。\n- 销量变化率：`daySoldRate`、`weekSoldRate`、`monthSoldRate`。\n- 销售额：`sales`、`totalSales`、`daySales`、`weekSales`、`monthSales`。\n- 销售额变化率：`daySalesRate`、`weekSalesRate`、`monthSalesRate`。\n- 店铺与竞争：`mallSold`、`similarNum`。\n- 价格与质量：`price`（过滤最低售价）、`supplyPrice`、`goodsScore`、`reviewNum`。\n\n时间范围使用 ISO 8601：`onSaleTimeMin/Max`、`mallOpenTimeMin/Max`。最小值不得大于最大值。变化率传小数，如 `0.2` 表示 20%。\n\n可排序字段：\n\n```text\nsold,totalSold,daySold,weekSold,monthSold,\ndaySoldRate,weekSoldRate,monthSoldRate,totalSoldRate,\nsales,totalSales,daySales,weekSales,monthSales,\ndaySalesRate,weekSalesRate,monthSalesRate,totalSalesRate,\nminPrice,maxPrice,supplyPrice,minSupplyPrice,medianSupplyPrice,maxSupplyPrice,\ngoodsScore,reviewNum,similarNum,similarNumUpdateTime,onSaleTime,\nmallSold,mallOpenTime,createTime,updateTime\n```\n\n接口不接受 `siteUID`、商品状态、图片字段或精确同款数；同款数（跟卖数）仅用 Min/Max。\n\n## 同款数（跟卖数）评估口径\n\n- `similarNum` 对外统一称为“同款数（跟卖数）”，表示销售同一款商品的同行数量。\n- 数值越大，同行越多、同质化竞争越强，通常核价通过概率也越低。\n- 非工厂型卖家优先选择同款数不超过 10 的商品；超过 20 的候选默认降级或剔除，除非存在明确的价格、渠道、产品差异化或运营优势。\n- 将同款数作为重要竞争指标，但同时结合销量及增长、供货价、商品价格、评价、上架时间和卖家自身能力综合判断。\n\n## 响应\n\n成功结构为 `code=0`，`data` 至少包含精确命中数 `total`、`list`、`site`。列表只允许分页访问前 10000 条；`total>10000` 时缩小筛选范围再做完整分布分析。每个商品公开：\n\n- 标识：`id`、`goodsId`、`goodsSn`、`spuId`、`mallId`、`siteId`、`siteUID`、`linkUrl`。\n- 基础：`hostingMode`、`thumbnail`、`goodsName`、`catId`、`catIds`、`catItems`。\n- 竞争：`similarNum`、`similarNumUpdateTime`。\n- 销量：`sold`、`daySold`、`weekSold`、`monthSold`、`totalSold` 及全部对应 Rate。\n- 销售额：`sales`、`daySales`、`weekSales`、`monthSales`、`totalSales` 及全部对应 Rate。\n- 价格：`minPrice`、`maxPrice`、`supplyPrice`、`minSupplyPrice`、`medianSupplyPrice`、`maxSupplyPrice`。\n- 质量与店铺：`goodsScore`、`reviewNum`、`mallOpenTime`、`mallSold`。\n- 时间：`onSaleTime`、`createTime`、`updateTime`。\n\n`site` 包含站点名、域名、语言、货币符号、符号位置、汇率和千分位信息。接口不返回收藏等用户私有字段。\n\n## 退出状态\n\n- `0`：查询成功并输出 JSON。\n- `2`：需要用户完成登录、额度或开通动作，按暂停流程处理。\n- `1`：参数、网络或接口错误，错误 JSON 写入标准错误。"}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"搜索和分析 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","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":666,"uniquenessScore":61,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-10T06:05:27.613Z","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-10T06:05:27.613Z","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-10T11:01:22.884Z","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"}]}}}