{"id":"a3bf7beb-6494-49a1-84b5-bf77b5e4d893","entityType":"agent","slug":"clawhub-geekbi-geekbi-shein-category-search-skill","name":"极鲸云 Shein 品类搜索&分析","canonicalUrl":"https://www.xpersona.co/agent/clawhub-geekbi-geekbi-shein-category-search-skill","canonicalPath":"/agent/clawhub-geekbi-geekbi-shein-category-search-skill","generatedAt":"2026-10-10T10:59:58.684Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-10T05:47:31.031Z","emptyReason":null},"description":"搜索和分析 SHEIN 类目，判断市场规模、供需与品类机会 Skill: 极鲸云 Shein 品类搜索&分析 Owner: geekbi Summary: 搜索和分析 SHEIN 类目，判断市场规模、供需与品类机会 Tags: latest:0.1.0 Version history: v0.1.0 | 2026-08-13T06:53:26.331Z | auto - 首次发布极鲸云 SHEIN 类目搜索技能。 - 支持通过多维筛选、排序条件实时搜索和分析 SHEIN 类目，返回经过路径和层级核验的可信类目 ID。 - 可筛选与输出热销类目、蓝海类目、品类规模及类目增长等榜单，并按需分站点执行。 - 严格依赖极鲸云脚本与接口返回的数据，不编造类目信息或市场结论。 - 支持系统用户配置登录态自动复用，并处理服务端要求的暂停与恢复流程。 Archive index: Archive v0.1.0: 18 files, 20947 bytes Files: .gitignore (32b),","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-category-search-skill","sourceUrl":"https://clawhub.ai/geekbi/geekbi-shein-category-search-skill","homepage":"https://clawhub.ai/geekbi/skills/geekbi-shein-category-search-skill","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/geekbi/geekbi-shein-category-search-skill","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/geekbi/skills/geekbi-shein-category-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-08"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-10T05:47:31.031Z","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-10T05:47:31.031Z","emptyReason":null},"stars":null,"forks":null,"downloads":1642,"packageName":null,"latestVersion":"0.1.0","tractionLabel":"1.6K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T05:47:31.030Z","emptyReason":null},"lastUpdatedAt":"2026-10-10T05:47:31.031Z","lastCrawledAt":"2026-10-10T05:47:31.030Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-11T05:47:31.030Z","lastVerifiedAt":null,"highlights":[{"version":"0.1.0","createdAt":"2026-08-13T06:53:26.331Z","changelog":"- 首次发布极鲸云 SHEIN 类目搜索技能。 - 支持通过多维筛选、排序条件实时搜索和分析 SHEIN 类目，返回经过路径和层级核验的可信类目 ID。 - 可筛选与输出热销类目、蓝海类目、品类规模及类目增长等榜单，并按需分站点执行。 - 严格依赖极鲸云脚本与接口返回的数据，不编造类目信息或市场结论。 - 支持系统用户配置登录态自动复用，并处理服务端要求的暂停与恢复流程。","fileCount":18,"zipByteSize":20947}]},"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-category-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-category-search-skill/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-geekbi-geekbi-shein-category-search-skill/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-geekbi-geekbi-shein-category-search-skill/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-geekbi-geekbi-shein-category-search-skill/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-geekbi-geekbi-shein-category-search-skill/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-geekbi-geekbi-shein-category-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-10T10:59:58.683Z"}},"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-category-search-skill/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-geekbi-geekbi-shein-category-search-skill/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-geekbi-geekbi-shein-category-search-skill/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-geekbi-geekbi-shein-category-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-10T05:47:31.031Z","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:26.331Z | auto\n\n- 首次发布极鲸云 SHEIN 类目搜索技能。\n- 支持通过多维筛选、排序条件实时搜索和分析 SHEIN 类目，返回经过路径和层级核验的可信类目 ID。\n- 可筛选与输出热销类目、蓝海类目、品类规模及类目增长等榜单，并按需分站点执行。\n- 严格依赖极鲸云脚本与接口返回的数据，不编造类目信息或市场结论。\n- 支持系统用户配置登录态自动复用，并处理服务端要求的暂停与恢复流程。\n\nArchive index:\n\nArchive v0.1.0: 18 files, 20947 bytes\n\nFiles: .gitignore (32b), agents (0b), agents/openai.yaml (256b), README.md (2488b), references (0b), references/SHEIN类目搜索.md (1258b), references/SHEIN类目搜索接口.md (1660b), references/SHEIN类目榜单预设.md (1068b), references/查询暂停与恢复流程.md (1271b), requirements.txt (23b), scripts (0b), scripts/geekbi_auth.py (23978b), scripts/shein_category_search.py (4126b), scripts/shein_search_common.py (5306b), scripts/shein_site_list.py (3486b), skill-card.md (2811b), SKILL.md (3514b), _meta.json (153b)\n\nFile v0.1.0:SKILL.md\n\n---\nname: \"geekbi-shein-category-search-skill\"\ndescription: \"通过极鲸云实时搜索和分析 SHEIN 类目，返回可信类目 ID、层级、父链和完整路径，支持按站点、名称、层级、父类目、蓝海指数、近 3 个月与累计销量和销售额、平均价格、商品数、店铺数、半托管供给及增长指标筛选和排序。用户提到 SHEIN 类目搜索、类目 ID、类目路径、热销类目、蓝海类目、品类规模、类目趋势、半托管渗透、供需竞争或类目机会时使用。\"\n---\n\n# 极鲸云 SHEIN 类目搜索\n\n仅使用极鲸云实时返回的数据搜索和分析 SHEIN 类目。独立返回经类目路径和层级验证的可信 ID，不根据名称猜测类目 ID，不编造类目、指标、链接或市场结论。\n\n## 执行流程\n\n1. 先读取 [SHEIN 类目搜索](references/SHEIN类目搜索.md)，按其中的业务口径、分析方法和输出要求执行。\n2. 读取 [SHEIN 类目搜索接口](references/SHEIN类目搜索接口.md)，只选取用户请求所需的查询参数。\n3. 未指定站点时使用 `siteId=1`（站点列表名称“全部”，当前映射 `us`，不是跨国家聚合）；明确美国站时使用 `siteId=2`。指定其他国家或地区时，先运行 `python3 scripts/shein_site_list.py --country \"国家或地区名\"`，只采用唯一精确匹配的站点 ID。\n4. 用户请求热销类目、蓝海类目或类目机会榜单时，再读取 [SHEIN 类目榜单查询预设](references/SHEIN类目榜单预设.md)，每次只采用一个最符合意图的主预设。\n5. 从本 Skill 根目录运行 `python3 scripts/shein_category_search.py --param \"名称=值\"`。需要多个条件时重复传入 `--param`。\n6. 用返回的完整类目路径、层级和父类目核验 `catId`。名称相近或路径不唯一时列出候选并请用户确认，不自行选择。\n7. 检查返回结构、命中总数、当前页、样本量和更新时间。`total` 是精确命中数，但最多只能分页访问前 10000 条；超过时缩小筛选范围。需要完整结果时逐页查询，未完成分页时明确说明仅为样本。\n8. 按参考文档分析数据并输出中文业务结论。对每个返回非空 `linkUrl` 的类目，将类目名称或完整路径写成可点击链接。\n\n## 复用登录态\n\n- 先直接运行类目搜索脚本。脚本通过 `scripts/geekbi_auth.py` 优先读取所有极鲸云 Skills 共用的系统用户配置登录态；已有有效登录态时不得再次要求登录。\n- 仅在脚本返回 `actionRequired` 或退出码 `2` 时读取并执行 [查询暂停与恢复流程](references/查询暂停与恢复流程.md)。向用户展示服务端中文提示和有效跳转链接，然后暂停查询；用户完成操作并回复继续后，原样重跑同一命令。\n- 退出码 `1` 时仅展示错误输出中的一级中文 `msg`。不得展示访问令牌、设备码、请求头、原始错误 JSON 或异常栈。\n\n## 资源路由\n\n- 执行任何类目搜索、类目 ID 查询或类目分析时，读取 `references/SHEIN类目搜索.md`。\n- 组装查询参数、选择排序字段或解释返回字段时，读取 `references/SHEIN类目搜索接口.md`。\n- 处理类目榜单请求时，读取 `references/SHEIN类目榜单预设.md`。\n- 仅在服务端要求用户操作时，读取 `references/查询暂停与恢复流程.md`。\n\n若环境尚未安装依赖，运行 `python3 -m pip install -r requirements.txt` 后再执行查询脚本。\n\nFile v0.1.0:README.md\n\n# 极鲸云 SHEIN 类目搜索 Skill\n\n通过极鲸云提供的真实 SHEIN 类目数据，帮助国内跨境卖家查询可信类目 ID、层级、父链和完整路径，并分析类目市场规模、需求趋势、商品与店铺供给、价格和半托管渗透，为品类研究和赛道判断提供依据。本 Skill 提供类目级市场判断，类目数据不能直接证明具体单品机会。\n\n## 主要能力\n\n| 能力 | 可以解决的问题 |\n| --- | --- |\n| SHEIN 类目搜索 | 按中文或英文名称、层级和父类目查找类目，并用完整路径核验可信类目 ID |\n| 类目市场规模 | 结合近 3 个月与累计销量、销售额及平均价格，判断品类需求规模和市场体量 |\n| 供需竞争分析 | 对比需求增长与商品数、店铺数及其变化，识别供给拥挤度和竞争压力 |\n| 类目趋势研究 | 结合日、周、月均销量和销售额及其增长率，识别近期增长、回落和异常波动 |\n| 蓝海与经营模式 | 综合蓝海指数、价格、商品与店铺供给及半托管渗透，筛选值得进一步验证的类目 |\n\n## 适用场景\n\n本项目适合以下任务：\n\n- 查询 SHEIN 类目 ID、类目层级、父链和完整归属路径。\n- 搜索一级、二级或指定父类目下的直接子类目。\n- 研究类目近 3 个月及累计销量、销售额、商品数和店铺数等市场规模。\n- 查找热销类目、蓝海类目和近期增长类目。\n- 对比需求增长与商品、店铺供给增长，判断供需竞争。\n- 分析类目平均价格和半托管商品、店铺渗透情况。\n- 为后续品类调研确定可信的类目范围和筛选条件。\n\n## 安装 / 更新\n\n请直接将下面这段话发送给支持 Skill 的 AI 助手，即可完成安装或更新到最新版本：\n\n```text\n安装这个Skill: https://github.com/geekbi/geekbi-shein-category-search-skill\n```\n\n## 开始使用\n\n安装后直接用中文描述目标即可，例如：\n\n```text\n帮我查 SHEIN 美国站 pet supplies 对应的可信类目 ID、层级和完整路径。\n```\n\n```text\n列出 SHEIN 美国站累计销量最高的二级类目，并比较市场规模、平均价格和竞争供给。\n```\n\n```text\n查找 SHEIN 美国站月销量增长快于商品数和店铺数增长的二级类目，筛选值得继续调研的方向。\n```\n\n```text\n分析 SHEIN 美国站蓝海指数较高的类目，结合近 3 个月销量、累计销售额、商品数和店铺数说明机会与风险。\n```\n\nFile v0.1.0:_meta.json\n\n{\n  \"ownerId\": \"kn7aztmefa4fv3mdrqs9vagx7h8c14z2\",\n  \"slug\": \"geekbi-shein-category-search-skill\",\n  \"version\": \"0.1.0\",\n  \"publishedAt\": 1786604006331\n}\n\nFile v0.1.0:references/SHEIN类目搜索.md\n\n# SHEIN 类目搜索方法\n\n## 适用问题\n\n- 查类目 ID、层级、父链和市场边界。\n- 比较类目需求规模、价格带、增长、商品供给、店铺供给与半托管渗透。\n- 寻找热销、增长或蓝海类目，并为商品、店铺和关键词查询提供可信类目 ID。\n\n榜单见 [类目榜单预设](SHEIN类目榜单预设.md)，接口见 [类目搜索接口](SHEIN类目搜索接口.md)。\n\n## 分析框架\n\n- 需求规模：近 3 个月与累计销量、销售额；平均价格辅助判断客单价。\n- 需求趋势：日、周、月均销量和销售额及变化率，防止低基数极端增长。\n- 当前供给：`itemCount`、`mallCount` 是当前总量；周期商品数和店铺数是日/周/月均值，对应 Rate 才是变化率。\n- 托管结构：半托管商品数/商品数、半托管店铺数/店铺数可复算渗透率，分母缺失或为零时不计算。\n- 蓝海指数：极鲸云预计算信号，越高通常越偏蓝海，但未知公式；必须与绝对需求、增长和供给交叉验证。\n- 可比性：优先比较同层级类目，避免大类与叶子类目直接排名。\n\n类目查询得到的 ID 才可传给其他能力。名称相近、跨站点或不同层级时不得猜测 ID。\n\nFile v0.1.0:references/SHEIN类目搜索接口.md\n\n# SHEIN 类目搜索接口\n\n## 调用\n\n```bash\npython3 scripts/shein_category_search.py \\\n  --param siteId=1 \\\n  --param keyword=女装 \\\n  --param catLevel=2 \\\n  --param sort=totalSold \\\n  --param order=desc\n```\n\n基础参数：`keyword`、`siteId`、`catLevel`、精确 `parentCatId`、`page`、`size`、`sort`、`order`。默认入口 1 名称为“全部”但当前映射 `us`，不是跨站聚合；明确美国用 2，其他站点实时解析。\n\n以下指标均支持 Min/Max：\n\n- `dsr`、`sold`、`sales`、`totalSold`、`totalSales`、`avgPrice`。\n- `itemCount`、`semiManagedItemCount`、`mallCount`、`semiManagedMallCount`。\n- 日/周/月均 `Sold`、`Sales`、`ItemCount`、`MallCount` 及全部对应 Rate。\n\n可排序字段为 `catLevel`、上述数值指标、`createTime`、`updateTime`。方向只允许小写 `asc|desc`；页码从 1 开始，每页最大 200，`page × size` 不得超过 10000。`total` 是精确命中数；命中超过 10000 时只能访问前 10000 条，应缩小筛选范围后再做完整分布分析。\n\n## 响应字段\n\n成功响应 `data` 包含 `total`、`list`、`site`。类目项公开：\n\n- `id`、`catId`、`siteId`、`siteUID`、`linkUrl`。\n- `thumbnail`、`catName`、`catNameCn`、`catLevel`、`parentCatId`、`isLeaf`、`parentCatItems`。\n- `dsr`、`sold`、`sales`、`totalSold`、`totalSales`、`avgPrice`。\n- `itemCount`、`semiManagedItemCount`、`mallCount`、`semiManagedMallCount`。\n- 日/周/月均销量、销售额、商品数、店铺数及全部 Rate。\n- `createTime`、`updateTime`。\n\n不返回收藏等用户私有字段。退出状态：成功 0，需要动作 2，错误 1。\n\nFile v0.1.0:references/SHEIN类目榜单预设.md\n\n# SHEIN 类目榜单查询预设\n\n每次选择一个主预设，只补充站点、分页、用户明确的关键词或层级。不同层级类目通常不直接排名。\n\n## 预设\n\n### 热销类目\n\n```text\nsort=totalSold\norder=desc\n```\n\n按累计总销量排序，不自动增加层级、时间或销量门槛。\n\n### 蓝海类目\n\n```text\nsort=dsr\norder=desc\n```\n\n至少同时检查总销量、月增长、商品数、店铺数和平均价格。蓝海指数是预计算信号，未知公式，不能单独作为进入依据。\n\n## 补充方法\n\n- 近期需求增长：按月销量或销售额增长率降序，并设置绝对量门槛。\n- 需求增长快于供给：比较需求增长率与商品数、店铺数的对应 Rate；周期商品数、店铺数本身是均值，不是变化量。\n- 半托管渗透：分别用半托管商品数/商品数、半托管店铺数/店铺数计算；分母为零或缺失时不计算。\n\n默认入口 `1` 名称为“全部”但当前映射 `us`，不是跨站聚合；明确美国用 `2`。排序方向只用 `asc|desc`。\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- 登录凭据依次保存在系统用户配置目录、Skill 的 `.geekbi/agent-auth.json`、当前工作目录的 `.geekbi/agent-auth.json`；读取使用首个存在的副本。\n- 不展示访问令牌、设备码、回调凭据、权限标识、请求头或内部状态对象。\n- 不把账号、密码、密钥或令牌写入文档、示例、回答、日志或命令行参数。\n\nFile v0.1.0:skill-card.md\n\n## Description:\n\nSearches and analyzes GeekBI real-time SHEIN category data to return verified category IDs, hierarchy paths, market-size metrics, supply and competition signals, growth trends, and blue-ocean indicators.\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, marketplace analysts, and agent users use this skill to find trustworthy SHEIN category IDs and compare category demand, sales, pricing, supply, store competition, semi-managed penetration, and growth signals before deeper product research.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill stores reusable GeekBI login tokens locally.\n\nMitigation: Install only if you trust geekbi, then review and clear .geekbi/agent-auth.json copies in the user config, skill directory, and working directory when finished.\n\nRisk: The authentication flow can display service-provided login or action links.\n\nMitigation: Follow only expected GeekBI destinations and ignore unexpected login links or service messages whose destination is not clearly trusted.\n\nRisk: Category conclusions depend on live GeekBI data, pagination limits, and correct category-path validation.\n\nMitigation: Check returned category paths, levels, total hit count, page coverage, sample size, and update time; narrow filters when results exceed the accessible page window.\n\n## Reference(s):\n\n- [Server-resolved GitHub source repository](https://github.com/geekbi/geekbi-shein-category-search-skill)\n- [ClawHub skill page](https://clawhub.ai/geekbi/skills/geekbi-shein-category-search-skill)\n- [GeekBI OpenAPI endpoint](https://openapi.geekbi.com)\n- [SHEIN category search method](artifact/references/SHEIN类目搜索.md)\n- [SHEIN category search API](artifact/references/SHEIN类目搜索接口.md)\n- [SHEIN category ranking presets](artifact/references/SHEIN类目榜单预设.md)\n- [Query pause and resume flow](artifact/references/查询暂停与恢复流程.md)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, shell commands, guidance]\n\n**Output Format:** [Chinese Markdown with optional shell commands and JSON helper-script output]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Results depend on live GeekBI data; queries validate category paths, levels, totals, page limits, sample size, and update time before presenting conclusions.]\n\n## Skill Version(s):\n\n0.1.0 (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\nFile v0.1.0:agents/openai.yaml\n\ninterface:\n  display_name: \"极鲸云 SHEIN 类目搜索\"\n  short_description: \"搜索和分析 SHEIN 类目，判断市场规模、供需与品类机会\"\n  default_prompt: \"使用 $geekbi-shein-category-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:26.331Z | auto - 首次发布极鲸云 SHEIN 类目搜索技能。 - 支持通过多维筛选、排序条件实时搜索和分析 SHEIN 类目，返回经过路径和层级核验的可信类目 ID。 - 可筛选与输出热销类目、蓝海类目、品类规模及类目增长等榜单，并按需分站点执行。 - 严格依赖极鲸云脚本与接口返回的数据，不编造类目信息或市场结论。 - 支持系统用户配置登录态自动复用，并处理服务端要求的暂停与恢复流程。 Archive index: Archive v0.1.0: 18 files, 20947 bytes Files: .gitignore (32b),","codeSnippets":[],"executableExamples":[{"language":"text","snippet":"安装这个Skill: https://github.com/geekbi/geekbi-shein-category-search-skill"},{"language":"text","snippet":"帮我查 SHEIN 美国站 pet supplies 对应的可信类目 ID、层级和完整路径。"},{"language":"text","snippet":"列出 SHEIN 美国站累计销量最高的二级类目，并比较市场规模、平均价格和竞争供给。"},{"language":"text","snippet":"查找 SHEIN 美国站月销量增长快于商品数和店铺数增长的二级类目，筛选值得继续调研的方向。"},{"language":"text","snippet":"分析 SHEIN 美国站蓝海指数较高的类目，结合近 3 个月销量、累计销售额、商品数和店铺数说明机会与风险。"},{"language":"bash","snippet":"python3 scripts/shein_category_search.py \\\n  --param siteId=1 \\\n  --param keyword=女装 \\\n  --param catLevel=2 \\\n  --param sort=totalSold \\\n  --param order=desc"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: \"geekbi-shein-category-search-skill\"\ndescription: \"通过极鲸云实时搜索和分析 SHEIN 类目，返回可信类目 ID、层级、父链和完整路径，支持按站点、名称、层级、父类目、蓝海指数、近 3 个月与累计销量和销售额、平均价格、商品数、店铺数、半托管供给及增长指标筛选和排序。用户提到 SHEIN 类目搜索、类目 ID、类目路径、热销类目、蓝海类目、品类规模、类目趋势、半托管渗透、供需竞争或类目机会时使用。\"\n---\n\n# 极鲸云 SHEIN 类目搜索\n\n仅使用极鲸云实时返回的数据搜索和分析 SHEIN 类目。独立返回经类目路径和层级验证的可信 ID，不根据名称猜测类目 ID，不编造类目、指标、链接或市场结论。\n\n## 执行流程\n\n1. 先读取 [SHEIN 类目搜索](references/SHEIN类目搜索.md)，按其中的业务口径、分析方法和输出要求执行。\n2. 读取 [SHEIN 类目搜索接口](references/SHEIN类目搜索接口.md)，只选取用户请求所需的查询参数。\n3. 未指定站点时使用 `siteId=1`（站点列表名称“全部”，当前映射 `us`，不是跨国家聚合）；明确美国站时使用 `siteId=2`。指定其他国家或地区时，先运行 `python3 scripts/shein_site_list.py --country \"国家或地区名\"`，只采用唯一精确匹配的站点 ID。\n4. 用户请求热销类目、蓝海类目或类目机会榜单时，再读取 [SHEIN 类目榜单查询预设](references/SHEIN类目榜单预设.md)，每次只采用一个最符合意图的主预设。\n5. 从本 Skill 根目录运行 `python3 scripts/shein_category_search.py --param \"名称=值\"`。需要多个条件时重复传入 `--param`。\n6. 用返回的完整类目路径、层级和父类目核验 `catId`。名称相近或路径不唯一时列出候选并请用户确认，不自行选择。\n7. 检查返回结构、命中总数、当前页、样本量和更新时间。`total` 是精确命中数，但最多只能分页访问前 10000 条；超过时缩小筛选范围。需要完整结果时逐页查询，未完成分页时明确说明仅为样本。\n8. 按参考文档分析数据并输出中文业务结论。对每个返回非空 `linkUrl` 的类目，将类目名称或完整路径写成可点击链接。\n\n## 复用登录态\n\n- 先直接运行类目搜索脚本。脚本通过 `scripts/geekbi_auth.py` 优先读取所有极鲸云 Skills 共用的系统用户配置登录态；已有有效登录态时不得再次要求登录。\n- 仅在脚本返回 `actionRequired` 或退出码 `2` 时读取并执行 [查询暂停与恢复流程](references/查询暂停与恢复流程.md)。向用户展示服务端中文提示和有效跳转链接，然后暂停查询；用户完成操作并回复继续后，原样重跑同一命令。\n- 退出码 `1` 时仅展示错误输出中的一级中文 `msg`。不得展示访问令牌、设备码、请求头、原始错误 JSON 或异常栈。\n\n## 资源路由\n\n- 执行任何类目搜索、类目 ID 查询或类目分析时，读取 `references/SHEIN类目搜索.md`。\n- 组装查询参数、选择排序字段或解释返回字段时，读取 `references/SHEIN类目搜索接口.md`。\n- 处理类目榜单请求时，读取 `references/SHEIN类目榜单预设.md`。\n- 仅在服务端要求用户操作时，读取 `references/查询暂停与恢复流程.md`。\n\n若环境尚未安装依赖，运行 `python3 -m pip install -r requirements.txt` 后再执行查询脚本。"},{"path":"README.md","content":"# 极鲸云 SHEIN 类目搜索 Skill\n\n通过极鲸云提供的真实 SHEIN 类目数据，帮助国内跨境卖家查询可信类目 ID、层级、父链和完整路径，并分析类目市场规模、需求趋势、商品与店铺供给、价格和半托管渗透，为品类研究和赛道判断提供依据。本 Skill 提供类目级市场判断，类目数据不能直接证明具体单品机会。\n\n## 主要能力\n\n| 能力 | 可以解决的问题 |\n| --- | --- |\n| SHEIN 类目搜索 | 按中文或英文名称、层级和父类目查找类目，并用完整路径核验可信类目 ID |\n| 类目市场规模 | 结合近 3 个月与累计销量、销售额及平均价格，判断品类需求规模和市场体量 |\n| 供需竞争分析 | 对比需求增长与商品数、店铺数及其变化，识别供给拥挤度和竞争压力 |\n| 类目趋势研究 | 结合日、周、月均销量和销售额及其增长率，识别近期增长、回落和异常波动 |\n| 蓝海与经营模式 | 综合蓝海指数、价格、商品与店铺供给及半托管渗透，筛选值得进一步验证的类目 |\n\n## 适用场景\n\n本项目适合以下任务：\n\n- 查询 SHEIN 类目 ID、类目层级、父链和完整归属路径。\n- 搜索一级、二级或指定父类目下的直接子类目。\n- 研究类目近 3 个月及累计销量、销售额、商品数和店铺数等市场规模。\n- 查找热销类目、蓝海类目和近期增长类目。\n- 对比需求增长与商品、店铺供给增长，判断供需竞争。\n- 分析类目平均价格和半托管商品、店铺渗透情况。\n- 为后续品类调研确定可信的类目范围和筛选条件。\n\n## 安装 / 更新\n\n请直接将下面这段话发送给支持 Skill 的 AI 助手，即可完成安装或更新到最新版本：\n\n```text\n安装这个Skill: https://github.com/geekbi/geekbi-shein-category-search-skill\n```\n\n## 开始使用\n\n安装后直接用中文描述目标即可，例如：\n\n```text\n帮我查 SHEIN 美国站 pet supplies 对应的可信类目 ID、层级和完整路径。\n```\n\n```text\n列出 SHEIN 美国站累计销量最高的二级类目，并比较市场规模、平均价格和竞争供给。\n```\n\n```text\n查找 SHEIN 美国站月销量增长快于商品数和店铺数增长的二级类目，筛选值得继续调研的方向。\n```\n\n```text\n分析 SHEIN 美国站蓝海指数较高的类目，结合近 3 个月销量、累计销售额、商品数和店铺数说明机会与风险。\n```"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn7aztmefa4fv3mdrqs9vagx7h8c14z2\",\n  \"slug\": \"geekbi-shein-category-search-skill\",\n  \"version\": \"0.1.0\",\n  \"publishedAt\": 1786604006331\n}"},{"path":"references/SHEIN类目搜索.md","content":"# SHEIN 类目搜索方法\n\n## 适用问题\n\n- 查类目 ID、层级、父链和市场边界。\n- 比较类目需求规模、价格带、增长、商品供给、店铺供给与半托管渗透。\n- 寻找热销、增长或蓝海类目，并为商品、店铺和关键词查询提供可信类目 ID。\n\n榜单见 [类目榜单预设](SHEIN类目榜单预设.md)，接口见 [类目搜索接口](SHEIN类目搜索接口.md)。\n\n## 分析框架\n\n- 需求规模：近 3 个月与累计销量、销售额；平均价格辅助判断客单价。\n- 需求趋势：日、周、月均销量和销售额及变化率，防止低基数极端增长。\n- 当前供给：`itemCount`、`mallCount` 是当前总量；周期商品数和店铺数是日/周/月均值，对应 Rate 才是变化率。\n- 托管结构：半托管商品数/商品数、半托管店铺数/店铺数可复算渗透率，分母缺失或为零时不计算。\n- 蓝海指数：极鲸云预计算信号，越高通常越偏蓝海，但未知公式；必须与绝对需求、增长和供给交叉验证。\n- 可比性：优先比较同层级类目，避免大类与叶子类目直接排名。\n\n类目查询得到的 ID 才可传给其他能力。名称相近、跨站点或不同层级时不得猜测 ID。"},{"path":"references/SHEIN类目搜索接口.md","content":"# SHEIN 类目搜索接口\n\n## 调用\n\n```bash\npython3 scripts/shein_category_search.py \\\n  --param siteId=1 \\\n  --param keyword=女装 \\\n  --param catLevel=2 \\\n  --param sort=totalSold \\\n  --param order=desc\n```\n\n基础参数：`keyword`、`siteId`、`catLevel`、精确 `parentCatId`、`page`、`size`、`sort`、`order`。默认入口 1 名称为“全部”但当前映射 `us`，不是跨站聚合；明确美国用 2，其他站点实时解析。\n\n以下指标均支持 Min/Max：\n\n- `dsr`、`sold`、`sales`、`totalSold`、`totalSales`、`avgPrice`。\n- `itemCount`、`semiManagedItemCount`、`mallCount`、`semiManagedMallCount`。\n- 日/周/月均 `Sold`、`Sales`、`ItemCount`、`MallCount` 及全部对应 Rate。\n\n可排序字段为 `catLevel`、上述数值指标、`createTime`、`updateTime`。方向只允许小写 `asc|desc`；页码从 1 开始，每页最大 200，`page × size` 不得超过 10000。`total` 是精确命中数；命中超过 10000 时只能访问前 10000 条，应缩小筛选范围后再做完整分布分析。\n\n## 响应字段\n\n成功响应 `data` 包含 `total`、`list`、`site`。类目项公开：\n\n- `id`、`catId`、`siteId`、`siteUID`、`linkUrl`。\n- `thumbnail`、`catName`、`catNameCn`、`catLevel`、`parentCatId`、`isLeaf`、`parentCatItems`。\n- `dsr`、`sold`、`sales`、`totalSold`、`totalSales`、`avgPrice`。\n- `itemCount`、`semiManagedItemCount`、`mallCount`、`semiManagedMallCount`。\n- 日/周/月均销量、销售额、商品数、店铺数及全部 Rate。\n- `createTime`、`updateTime`。\n\n不返回收藏等用户私有字段。退出状态：成功 0，需要动作 2，错误 1。"}],"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:26.331Z | auto - 首次发布极鲸云 SHEIN 类目搜索技能。 - 支持通过多维筛选、排序条件实时搜索和分析 SHEIN 类目，返回经过路径和层级核验的可信类目 ID。 - 可筛选与输出热销类目、蓝海类目、品类规模及类目增长等榜单，并按需分站点执行。 - 严格依赖极鲸云脚本与接口返回的数据，不编造类目信息或市场结论。 - 支持系统用户配置登录态自动复用，并处理服务端要求的暂停与恢复流程。 Archive index: Archive v0.1.0: 18 files, 20947 bytes Files: .gitignore (32b),","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":494,"uniquenessScore":63,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-10T05:47:31.031Z","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-10T05:47:31.031Z","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-10T10:59:58.684Z","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"}]}}}