{"id":"09034fa2-bac5-4a79-b220-310bc1e523d5","entityType":"agent","slug":"clawhub-geekbi-geekbi-shein-shop-search-skill","name":"极鲸云 Shein 店铺搜索&分析","canonicalUrl":"https://www.xpersona.co/agent/clawhub-geekbi-geekbi-shein-shop-search-skill","canonicalPath":"/agent/clawhub-geekbi-geekbi-shein-shop-search-skill","generatedAt":"2026-10-10T11:01:27.061Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-10T06:37:36.333Z","emptyReason":null},"description":"搜索和分析 SHEIN 店铺，研究竞店规模、增长和经营效率 Skill: 极鲸云 Shein 店铺搜索&分析 Owner: geekbi Summary: 搜索和分析 SHEIN 店铺，研究竞店规模、增长和经营效率 Tags: latest:0.1.0 Version history: v0.1.0 | 2026-08-13T06:53:47.732Z | auto - 初始版本，支持通过极鲸云实时搜索和分析 SHEIN 店铺。 - 可按店铺名称/ID、站点、类目ID、模式、销量、销售额、评分、评论数等多维条件筛选与排序。 - 严格依赖极鲸云返回数据，不编造或推测店铺信息。 - 支持榜单查询、按站点精确筛选、自动处理登录态和查询暂停流程。 - 输出中文业务结论，并支持点击访问店铺链接。 Archive index: Archive v0.1.0: 18 files, 21167 bytes Files: .gitignore (32b), agents (0b), agents/open","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-shop-search-skill","sourceUrl":"https://clawhub.ai/geekbi/geekbi-shein-shop-search-skill","homepage":"https://clawhub.ai/geekbi/skills/geekbi-shein-shop-search-skill","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/geekbi/geekbi-shein-shop-search-skill","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/geekbi/skills/geekbi-shein-shop-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-10T06:37:36.333Z","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:37:36.333Z","emptyReason":null},"stars":null,"forks":null,"downloads":1614,"packageName":null,"latestVersion":"0.1.0","tractionLabel":"1.6K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T06:37:36.333Z","emptyReason":null},"lastUpdatedAt":"2026-10-10T06:37:36.333Z","lastCrawledAt":"2026-10-10T06:37:36.333Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-11T06:37:36.333Z","lastVerifiedAt":null,"highlights":[{"version":"0.1.0","createdAt":"2026-08-13T06:53:47.732Z","changelog":"- 初始版本，支持通过极鲸云实时搜索和分析 SHEIN 店铺。 - 可按店铺名称/ID、站点、类目ID、模式、销量、销售额、评分、评论数等多维条件筛选与排序。 - 严格依赖极鲸云返回数据，不编造或推测店铺信息。 - 支持榜单查询、按站点精确筛选、自动处理登录态和查询暂停流程。 - 输出中文业务结论，并支持点击访问店铺链接。","fileCount":18,"zipByteSize":21167}]},"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-shop-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-shop-search-skill/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-geekbi-geekbi-shein-shop-search-skill/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-geekbi-geekbi-shein-shop-search-skill/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-geekbi-geekbi-shein-shop-search-skill/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-geekbi-geekbi-shein-shop-search-skill/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-geekbi-geekbi-shein-shop-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:27.061Z"}},"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-shop-search-skill/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-geekbi-geekbi-shein-shop-search-skill/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-geekbi-geekbi-shein-shop-search-skill/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-geekbi-geekbi-shein-shop-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:37:36.333Z","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:47.732Z | auto\n\n- 初始版本，支持通过极鲸云实时搜索和分析 SHEIN 店铺。\n- 可按店铺名称/ID、站点、类目ID、模式、销量、销售额、评分、评论数等多维条件筛选与排序。\n- 严格依赖极鲸云返回数据，不编造或推测店铺信息。\n- 支持榜单查询、按站点精确筛选、自动处理登录态和查询暂停流程。\n- 输出中文业务结论，并支持点击访问店铺链接。\n\nArchive index:\n\nArchive v0.1.0: 18 files, 21167 bytes\n\nFiles: .gitignore (32b), agents (0b), agents/openai.yaml (252b), README.md (2470b), references (0b), references/SHEIN店铺搜索.md (1474b), references/SHEIN店铺搜索接口.md (1922b), references/SHEIN店铺榜单预设.md (1212b), references/查询暂停与恢复流程.md (1271b), requirements.txt (23b), scripts (0b), scripts/geekbi_auth.py (23978b), scripts/shein_search_common.py (5306b), scripts/shein_shop_search.py (4150b), scripts/shein_site_list.py (3486b), skill-card.md (2261b), SKILL.md (3545b), _meta.json (149b)\n\nFile v0.1.0:SKILL.md\n\n---\nname: \"geekbi-shein-shop-search-skill\"\ndescription: \"通过极鲸云实时搜索和分析 SHEIN 店铺，支持按店铺名称或 ID、站点、可信类目 ID、托管模式、近 3 个月与累计销量和销售额、评分、评论数、商品数、粉丝数、平均价格、开店时间及增长指标筛选和排序。用户提到 SHEIN 店铺搜索、店铺链接、竞品店铺、竞店调研、热销店铺、头部店铺、新店、高成长店铺、全托管、半托管、店铺经营规模、经营效率或店铺排名时使用。\"\n---\n\n# 极鲸云 SHEIN 店铺搜索\n\n仅使用极鲸云实时返回的数据搜索和分析 SHEIN 店铺。将结论限定在店铺层级，不编造店铺、指标、链接或未返回的经营信息。\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. 仅在已有可信类目 ID 时传入 `catIds`。没有可信 ID 时不得按类目名称猜测；优先省略类目条件并按店铺关键词搜索，类目条件不可省略时请用户提供明确 ID。\n5. 用户请求热销店铺、热销新店、最近开店等榜单时，再读取 [SHEIN 店铺榜单查询预设](references/SHEIN店铺榜单预设.md)，每次只采用一个最符合意图的主预设。\n6. 从本 Skill 根目录运行 `python3 scripts/shein_shop_search.py --param \"名称=值\"`。需要多个条件时重复传入 `--param`；需要多个类目 ID 时重复传入 `catIds`。\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- 执行任何店铺搜索或店铺分析时，读取 `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 店铺数据，帮助国内跨境卖家搜索目标店铺、筛选竞品店铺，并分析经营规模、近期增长、商品结构、粉丝变化、口碑和托管模式，为竞店调研、经营对标和市场竞争判断提供依据。本 Skill 专注店铺层级，不提供店内单品明细。\n\n## 主要能力\n\n| 能力 | 可以解决的问题 |\n| --- | --- |\n| SHEIN 店铺搜索 | 按店铺名称或 ID、站点和可信类目 ID 定位目标店铺，获取可直接访问的店铺详情链接 |\n| 竞品店铺筛选 | 按全托管或半托管、开店时间、销量、销售额、评分、评论数、商品数、粉丝数和平均价格筛选可比店铺 |\n| 店铺榜单研究 | 查找热销店铺、高评论店铺、热销新店和最近开店的店铺，快速建立竞店候选清单 |\n| 经营表现分析 | 结合近 3 个月、累计及日周月销量与销售额，判断店铺规模、近期增长和回落风险 |\n| 商品与粉丝变化 | 结合商品总数、周期商品数、粉丝总数及变化率，判断经营扩张速度和用户资产变化 |\n\n## 适用场景\n\n本项目适合以下任务：\n\n- 搜索指定 SHEIN 店铺并获取可信店铺链接。\n- 查找头部店铺、热销店铺和直接竞争店铺。\n- 筛选最近开店、近期增长较快或具有潜力的新店。\n- 对比全托管与半托管店铺的经营规模和表现。\n- 分析店铺销量、销售额、商品规模、粉丝和口碑。\n- 评估店铺近期增长、商品供给变化和经营风险。\n- 建立竞品店铺清单并完成经营对标。\n\n## 安装 / 更新\n\n请直接将下面这段话发送给支持 Skill 的 AI 助手，即可完成安装或更新到最新版本：\n\n```text\n安装这个Skill: https://github.com/geekbi/geekbi-shein-shop-search-skill\n```\n\n## 开始使用\n\n安装后直接用中文描述目标即可，例如：\n\n```text\n查找 SHEIN 美国站近 3 个月销量最高的 20 家店铺，并比较销售额、商品数量、评分和粉丝规模。\n```\n\n```text\n查找 SHEIN 美国站最近 3 个月开店且月销量增长较快的新店，并判断哪些值得持续跟踪。\n```\n\n```text\n搜索 SHEIN 店铺 Acme Home，给我店铺链接，并分析它的经营规模、近期增长和口碑。\n```\n\n```text\n对比 SHEIN 美国站半托管店铺的近 3 个月销量、销售额、商品规模和粉丝变化，筛选表现较好的竞店。\n```\n\nFile v0.1.0:_meta.json\n\n{\n  \"ownerId\": \"kn7aztmefa4fv3mdrqs9vagx7h8c14z2\",\n  \"slug\": \"geekbi-shein-shop-search-skill\",\n  \"version\": \"0.1.0\",\n  \"publishedAt\": 1786604027732\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\n- 规模：店铺近 3 个月销量/销售额、累计销量/销售额、商品数、粉丝数、评论数。\n- 近期表现：日、周、月均销量和销售额及变化率。\n- 经营效率：近 3 个月销量除以商品数可作粗略动销效率，但分母缺失或为零时不计算。\n- 供给结构：周期商品数字段是日/周/月均值，对应 Rate 才是变化率；当前商品总数是 `goodsNum`，三者不能混用。\n- 用户资产：周期粉丝字段是日/周/月均值，对应 Rate 才是变化率；当前粉丝总数是 `followerNum`。\n- 口碑：店铺星级和评论规模需同时看，高评论不等于高评分。\n- 生命周期：开店时间与增长结合判断；累计规模高不代表近期仍增长。\n- 托管模式：只用 `1=全托管`、`2=半托管`，不传表示不限。\n\n“潜力新店”至少需要近期开店、近期销量有量、月度趋势为正、动销不依赖极少商品且口碑无明显风险。只按累计销量排名不能推出持续增长。\n\nFile v0.1.0:references/SHEIN店铺搜索接口.md\n\n# SHEIN 店铺搜索接口\n\n## 调用\n\n```bash\npython3 scripts/shein_shop_search.py \\\n  --param siteId=1 \\\n  --param catIds=123 \\\n  --param hostingMode=2 \\\n  --param sort=mallSold \\\n  --param order=desc \\\n  --param page=1 \\\n  --param size=20\n```\n\n基础参数：`keyword`、可重复 `catIds`、`siteId`、`hostingMode`（1 全托管、2 半托管）、`page`、`size`、`sort`、`order`。未指定用入口 1（名称“全部”，当前映射 `us`，不是跨站聚合），明确美国用 2，其他站点先运行 `shein_site_list.py`。\n\n以下指标均可使用 Min/Max：\n\n- 近 3 个月与累计规模：`mallSold`、`mallSales`、`totalSold`、`totalSales`；另有 `mallStar`、`reviewNum`、`goodsNum`、`followerNum`、`avgPrice`。\n- 周期经营：日/周/月均 `Sold`、`Sales` 及对应 Rate。\n- 商品供给：日/周/月均 `ItemCount` 及对应 Rate。\n- 粉丝规模：日/周/月均 `Follower` 及对应 Rate。\n- 时间：`mallOpenTimeMin/Max`，使用 ISO 8601。\n\n可排序字段为以上指标、`mallOpenTime`、`createTime`、`updateTime`。方向只允许小写 `asc|desc`，每页最大 200，`page × size` 不得超过 10000，所有范围必须有效。`total` 是精确命中数；命中超过 10000 时只能访问前 10000 条，应缩小筛选范围后再做完整分布分析。\n\n## 响应字段\n\n成功响应 `data` 包含 `total`、`list`、`site`。店铺项公开：\n\n- `id`、`mallId`、`siteId`、`siteUID`、`linkUrl`、`hostingMode`。\n- `mallLogo`、`mallName`、`descriptions`、`catIds`、`catItems`。\n- `mallStar`、`reviewNum`、`goodsNum`、`followerNum`。\n- `mallSold`、`mallSales`、`totalSold`、`totalSales`、`avgPrice`。\n- 日/周/月均销量、销售额、商品数、粉丝数及全部对应 Rate。\n- `mallOpenTime`、`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=mallSold\norder=desc\n```\n\n按店铺近 3 个月销量排序。这是 SHEIN 网页当前实际口径，不按评论量代替热销。\n\n### 高评论店铺（Skill 补充）\n\n```text\nsort=reviewNum\norder=desc\n```\n\n评论数反映反馈规模，不等于高评分或好口碑。\n\n### 热销新店\n\n```text\nmallOpenTimeMin=<执行时刻减3个自然月的ISO时间>\nmallOpenTimeMax=<执行时刻的ISO时间>\nsort=mallSold\norder=desc\n```\n\n对“潜力新店”结论还需检查月销量、增长、商品数和口碑，避免被单一历史爆款误导。\n\n### 最近开店\n\n```text\nsort=mallOpenTime\norder=desc\n```\n\n不自动增加时间范围；用户明确范围时再补充。\n\n## 请求前检查\n\n- 默认入口 `1` 名称为“全部”但当前映射 `us`，不是跨站聚合；明确美国用 `2`，其他站实时解析。\n- 近 3 个月已换算成绝对 ISO 8601。\n- 排序只用 `asc|desc`，并区分近 3 个月销量、累计销量、评论规模和评分。\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\n通过极鲸云实时搜索和分析 SHEIN 店铺，帮助卖家按店铺、站点、类目、托管模式和经营指标筛选竞店并输出中文业务结论。\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 market researchers use this skill to search SHEIN shops, identify competitors, compare shop scale and recent growth, and build store-level benchmarking reports from GeekBI data.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: GeekBI login state may be stored locally, including under .geekbi/agent-auth.json in the current workspace.\n\nMitigation: Use the skill only in trusted workspaces, avoid shared or synced workspaces for authenticated queries, and clear local GeekBI auth state after use when the workspace may be collected or shared.\n\n## Reference(s):\n\n- [ClawHub Skill Page](https://clawhub.ai/geekbi/skills/geekbi-shein-shop-search-skill)\n- [Server-resolved GitHub Import](https://github.com/geekbi/geekbi-shein-shop-search-skill)\n- [SHEIN 店铺搜索方法](artifact/references/SHEIN店铺搜索.md)\n- [SHEIN 店铺搜索接口](artifact/references/SHEIN店铺搜索接口.md)\n- [SHEIN 店铺榜单查询预设](artifact/references/SHEIN店铺榜单预设.md)\n- [查询暂停与恢复流程](artifact/references/查询暂停与恢复流程.md)\n- [GeekBI OpenAPI Endpoint](https://openapi.geekbi.com)\n\n## Skill Output:\n\n**Output Type(s):** [Analysis, Markdown, Shell commands, JSON, Guidance]\n\n**Output Format:** [Chinese Markdown analysis with shop links, supporting shell commands, and JSON returned by GeekBI query scripts]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Uses only GeekBI-returned shop data; paginated queries are limited to the first 10000 results unless filters are narrowed.]\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-shop-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:47.732Z | auto - 初始版本，支持通过极鲸云实时搜索和分析 SHEIN 店铺。 - 可按店铺名称/ID、站点、类目ID、模式、销量、销售额、评分、评论数等多维条件筛选与排序。 - 严格依赖极鲸云返回数据，不编造或推测店铺信息。 - 支持榜单查询、按站点精确筛选、自动处理登录态和查询暂停流程。 - 输出中文业务结论，并支持点击访问店铺链接。 Archive index: Archive v0.1.0: 18 files, 21167 bytes Files: .gitignore (32b), agents (0b), agents/open","codeSnippets":[],"executableExamples":[{"language":"text","snippet":"安装这个Skill: https://github.com/geekbi/geekbi-shein-shop-search-skill"},{"language":"text","snippet":"查找 SHEIN 美国站近 3 个月销量最高的 20 家店铺，并比较销售额、商品数量、评分和粉丝规模。"},{"language":"text","snippet":"查找 SHEIN 美国站最近 3 个月开店且月销量增长较快的新店，并判断哪些值得持续跟踪。"},{"language":"text","snippet":"搜索 SHEIN 店铺 Acme Home，给我店铺链接，并分析它的经营规模、近期增长和口碑。"},{"language":"text","snippet":"对比 SHEIN 美国站半托管店铺的近 3 个月销量、销售额、商品规模和粉丝变化，筛选表现较好的竞店。"},{"language":"bash","snippet":"python3 scripts/shein_shop_search.py \\\n  --param siteId=1 \\\n  --param catIds=123 \\\n  --param hostingMode=2 \\\n  --param sort=mallSold \\\n  --param order=desc \\\n  --param page=1 \\\n  --param size=20"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: \"geekbi-shein-shop-search-skill\"\ndescription: \"通过极鲸云实时搜索和分析 SHEIN 店铺，支持按店铺名称或 ID、站点、可信类目 ID、托管模式、近 3 个月与累计销量和销售额、评分、评论数、商品数、粉丝数、平均价格、开店时间及增长指标筛选和排序。用户提到 SHEIN 店铺搜索、店铺链接、竞品店铺、竞店调研、热销店铺、头部店铺、新店、高成长店铺、全托管、半托管、店铺经营规模、经营效率或店铺排名时使用。\"\n---\n\n# 极鲸云 SHEIN 店铺搜索\n\n仅使用极鲸云实时返回的数据搜索和分析 SHEIN 店铺。将结论限定在店铺层级，不编造店铺、指标、链接或未返回的经营信息。\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. 仅在已有可信类目 ID 时传入 `catIds`。没有可信 ID 时不得按类目名称猜测；优先省略类目条件并按店铺关键词搜索，类目条件不可省略时请用户提供明确 ID。\n5. 用户请求热销店铺、热销新店、最近开店等榜单时，再读取 [SHEIN 店铺榜单查询预设](references/SHEIN店铺榜单预设.md)，每次只采用一个最符合意图的主预设。\n6. 从本 Skill 根目录运行 `python3 scripts/shein_shop_search.py --param \"名称=值\"`。需要多个条件时重复传入 `--param`；需要多个类目 ID 时重复传入 `catIds`。\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- 执行任何店铺搜索或店铺分析时，读取 `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 店铺数据，帮助国内跨境卖家搜索目标店铺、筛选竞品店铺，并分析经营规模、近期增长、商品结构、粉丝变化、口碑和托管模式，为竞店调研、经营对标和市场竞争判断提供依据。本 Skill 专注店铺层级，不提供店内单品明细。\n\n## 主要能力\n\n| 能力 | 可以解决的问题 |\n| --- | --- |\n| SHEIN 店铺搜索 | 按店铺名称或 ID、站点和可信类目 ID 定位目标店铺，获取可直接访问的店铺详情链接 |\n| 竞品店铺筛选 | 按全托管或半托管、开店时间、销量、销售额、评分、评论数、商品数、粉丝数和平均价格筛选可比店铺 |\n| 店铺榜单研究 | 查找热销店铺、高评论店铺、热销新店和最近开店的店铺，快速建立竞店候选清单 |\n| 经营表现分析 | 结合近 3 个月、累计及日周月销量与销售额，判断店铺规模、近期增长和回落风险 |\n| 商品与粉丝变化 | 结合商品总数、周期商品数、粉丝总数及变化率，判断经营扩张速度和用户资产变化 |\n\n## 适用场景\n\n本项目适合以下任务：\n\n- 搜索指定 SHEIN 店铺并获取可信店铺链接。\n- 查找头部店铺、热销店铺和直接竞争店铺。\n- 筛选最近开店、近期增长较快或具有潜力的新店。\n- 对比全托管与半托管店铺的经营规模和表现。\n- 分析店铺销量、销售额、商品规模、粉丝和口碑。\n- 评估店铺近期增长、商品供给变化和经营风险。\n- 建立竞品店铺清单并完成经营对标。\n\n## 安装 / 更新\n\n请直接将下面这段话发送给支持 Skill 的 AI 助手，即可完成安装或更新到最新版本：\n\n```text\n安装这个Skill: https://github.com/geekbi/geekbi-shein-shop-search-skill\n```\n\n## 开始使用\n\n安装后直接用中文描述目标即可，例如：\n\n```text\n查找 SHEIN 美国站近 3 个月销量最高的 20 家店铺，并比较销售额、商品数量、评分和粉丝规模。\n```\n\n```text\n查找 SHEIN 美国站最近 3 个月开店且月销量增长较快的新店，并判断哪些值得持续跟踪。\n```\n\n```text\n搜索 SHEIN 店铺 Acme Home，给我店铺链接，并分析它的经营规模、近期增长和口碑。\n```\n\n```text\n对比 SHEIN 美国站半托管店铺的近 3 个月销量、销售额、商品规模和粉丝变化，筛选表现较好的竞店。\n```"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn7aztmefa4fv3mdrqs9vagx7h8c14z2\",\n  \"slug\": \"geekbi-shein-shop-search-skill\",\n  \"version\": \"0.1.0\",\n  \"publishedAt\": 1786604027732\n}"},{"path":"references/SHEIN店铺搜索.md","content":"# SHEIN 店铺搜索方法\n\n## 适用问题\n\n- 查头部竞品、热销店铺、热销新店、最近开店或高评论店铺。\n- 比较全托管与半托管店铺的规模、增长、商品结构和粉丝变化。\n- 判断类目是否由少数大店控制，或新店是否有可复制增长。\n\n榜单条件见 [店铺榜单预设](SHEIN店铺榜单预设.md)，完整参数见 [店铺搜索接口](SHEIN店铺搜索接口.md)。\n\n## 分析框架\n\n- 规模：店铺近 3 个月销量/销售额、累计销量/销售额、商品数、粉丝数、评论数。\n- 近期表现：日、周、月均销量和销售额及变化率。\n- 经营效率：近 3 个月销量除以商品数可作粗略动销效率，但分母缺失或为零时不计算。\n- 供给结构：周期商品数字段是日/周/月均值，对应 Rate 才是变化率；当前商品总数是 `goodsNum`，三者不能混用。\n- 用户资产：周期粉丝字段是日/周/月均值，对应 Rate 才是变化率；当前粉丝总数是 `followerNum`。\n- 口碑：店铺星级和评论规模需同时看，高评论不等于高评分。\n- 生命周期：开店时间与增长结合判断；累计规模高不代表近期仍增长。\n- 托管模式：只用 `1=全托管`、`2=半托管`，不传表示不限。\n\n“潜力新店”至少需要近期开店、近期销量有量、月度趋势为正、动销不依赖极少商品且口碑无明显风险。只按累计销量排名不能推出持续增长。"},{"path":"references/SHEIN店铺搜索接口.md","content":"# SHEIN 店铺搜索接口\n\n## 调用\n\n```bash\npython3 scripts/shein_shop_search.py \\\n  --param siteId=1 \\\n  --param catIds=123 \\\n  --param hostingMode=2 \\\n  --param sort=mallSold \\\n  --param order=desc \\\n  --param page=1 \\\n  --param size=20\n```\n\n基础参数：`keyword`、可重复 `catIds`、`siteId`、`hostingMode`（1 全托管、2 半托管）、`page`、`size`、`sort`、`order`。未指定用入口 1（名称“全部”，当前映射 `us`，不是跨站聚合），明确美国用 2，其他站点先运行 `shein_site_list.py`。\n\n以下指标均可使用 Min/Max：\n\n- 近 3 个月与累计规模：`mallSold`、`mallSales`、`totalSold`、`totalSales`；另有 `mallStar`、`reviewNum`、`goodsNum`、`followerNum`、`avgPrice`。\n- 周期经营：日/周/月均 `Sold`、`Sales` 及对应 Rate。\n- 商品供给：日/周/月均 `ItemCount` 及对应 Rate。\n- 粉丝规模：日/周/月均 `Follower` 及对应 Rate。\n- 时间：`mallOpenTimeMin/Max`，使用 ISO 8601。\n\n可排序字段为以上指标、`mallOpenTime`、`createTime`、`updateTime`。方向只允许小写 `asc|desc`，每页最大 200，`page × size` 不得超过 10000，所有范围必须有效。`total` 是精确命中数；命中超过 10000 时只能访问前 10000 条，应缩小筛选范围后再做完整分布分析。\n\n## 响应字段\n\n成功响应 `data` 包含 `total`、`list`、`site`。店铺项公开：\n\n- `id`、`mallId`、`siteId`、`siteUID`、`linkUrl`、`hostingMode`。\n- `mallLogo`、`mallName`、`descriptions`、`catIds`、`catItems`。\n- `mallStar`、`reviewNum`、`goodsNum`、`followerNum`。\n- `mallSold`、`mallSales`、`totalSold`、`totalSales`、`avgPrice`。\n- 日/周/月均销量、销售额、商品数、粉丝数及全部对应 Rate。\n- `mallOpenTime`、`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:47.732Z | auto - 初始版本，支持通过极鲸云实时搜索和分析 SHEIN 店铺。 - 可按店铺名称/ID、站点、类目ID、模式、销量、销售额、评分、评论数等多维条件筛选与排序。 - 严格依赖极鲸云返回数据，不编造或推测店铺信息。 - 支持榜单查询、按站点精确筛选、自动处理登录态和查询暂停流程。 - 输出中文业务结论，并支持点击访问店铺链接。 Archive index: Archive v0.1.0: 18 files, 21167 bytes Files: .gitignore (32b), agents (0b), agents/open","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":504,"uniquenessScore":64,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-10T06:37:36.333Z","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:37:36.333Z","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:27.061Z","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"}]}}}