{"id":"6b581fc9-3007-44ff-9529-426a2eeccb0c","entityType":"agent","slug":"clawhub-geekbi-geekbi-temu-shop-search-skill","name":"极鲸云 Temu 店铺搜索","canonicalUrl":"https://www.xpersona.co/agent/clawhub-geekbi-geekbi-temu-shop-search-skill","canonicalPath":"/agent/clawhub-geekbi-geekbi-temu-shop-search-skill","generatedAt":"2026-10-10T10:07:07.486Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-10T03:48:53.189Z","emptyReason":null},"description":"搜索和分析 Temu 店铺，研究竞店规模、增长和经营效率 Skill: 极鲸云 Temu 店铺搜索 Owner: geekbi Summary: 搜索和分析 Temu 店铺，研究竞店规模、增长和经营效率 Tags: latest:0.1.0 Version history: v0.1.0 | 2026-08-12T07:31:37.263Z | auto - 首次发布：实现 Temu 店铺搜索与分析功能，基于极鲸云实时数据。 - 支持按店铺名称/ID、站点、销量、销售额、评分、评论数、粉丝数、价格、开店时间、动销等多维度筛选与排序。 - 支持店铺榜单（热销/新店/高成长等）查询，并严格按接口参数和预设执行。 - 复用统一登录态，处理服务端暂停/恢复流程，提升用户体验。 - 优化错误处理，输出规范化中文业务结论与可点击店铺链接。 Archive index: Archive v0.1.0: 17 files, 24511 bytes Files: .gitignore (28b), ag","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.7K downloads reported by the source. Last updated 10/10/2026.","installCommand":"clawhub skill install s174eqt3xz844hgj4g79d0an318c07m7:geekbi-temu-shop-search-skill","sourceUrl":"https://clawhub.ai/geekbi/geekbi-temu-shop-search-skill","homepage":"https://clawhub.ai/geekbi/skills/geekbi-temu-shop-search-skill","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/geekbi/geekbi-temu-shop-search-skill","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/geekbi/skills/geekbi-temu-shop-search-skill","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":65,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"搜索和分析 Temu 店铺，研究竞店规模、增长和经营效率 Skill: 极鲸云 Temu 店铺搜索 Owner: geekbi Summary: 搜索和分析 Temu 店铺，研究竞店规模、增长和经营效率 Tags: latest:0.1.0 Version history: v0.1.0 | 2026-08-12T07"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-10T03:48:53.189Z","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-10T03:48:53.189Z","emptyReason":null},"stars":null,"forks":null,"downloads":1716,"packageName":null,"latestVersion":"0.1.0","tractionLabel":"1.7K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T03:48:53.189Z","emptyReason":null},"lastUpdatedAt":"2026-10-10T03:48:53.189Z","lastCrawledAt":"2026-10-10T03:48:53.189Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-11T03:48:53.189Z","lastVerifiedAt":null,"highlights":[{"version":"0.1.0","createdAt":"2026-08-12T07:31:37.263Z","changelog":"- 首次发布：实现 Temu 店铺搜索与分析功能，基于极鲸云实时数据。 - 支持按店铺名称/ID、站点、销量、销售额、评分、评论数、粉丝数、价格、开店时间、动销等多维度筛选与排序。 - 支持店铺榜单（热销/新店/高成长等）查询，并严格按接口参数和预设执行。 - 复用统一登录态，处理服务端暂停/恢复流程，提升用户体验。 - 优化错误处理，输出规范化中文业务结论与可点击店铺链接。","fileCount":17,"zipByteSize":24511}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s174eqt3xz844hgj4g79d0an318c07m7:geekbi-temu-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-temu-shop-search-skill/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-geekbi-geekbi-temu-shop-search-skill/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-geekbi-geekbi-temu-shop-search-skill/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-geekbi-geekbi-temu-shop-search-skill/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-geekbi-geekbi-temu-shop-search-skill/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-geekbi-geekbi-temu-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-10T10:07:07.486Z"}},"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-temu-shop-search-skill/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-geekbi-geekbi-temu-shop-search-skill/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-geekbi-geekbi-temu-shop-search-skill/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-geekbi-geekbi-temu-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-10T03:48:53.189Z","emptyReason":null},"readme":"Skill: 极鲸云 Temu 店铺搜索\n\nOwner: geekbi\n\nSummary: 搜索和分析 Temu 店铺，研究竞店规模、增长和经营效率\n\nTags: latest:0.1.0\n\nVersion history:\n\nv0.1.0 | 2026-08-12T07:31:37.263Z | auto\n\n- 首次发布：实现 Temu 店铺搜索与分析功能，基于极鲸云实时数据。\n- 支持按店铺名称/ID、站点、销量、销售额、评分、评论数、粉丝数、价格、开店时间、动销等多维度筛选与排序。\n- 支持店铺榜单（热销/新店/高成长等）查询，并严格按接口参数和预设执行。\n- 复用统一登录态，处理服务端暂停/恢复流程，提升用户体验。\n- 优化错误处理，输出规范化中文业务结论与可点击店铺链接。\n\nArchive index:\n\nArchive v0.1.0: 17 files, 24511 bytes\n\nFiles: .gitignore (28b), agents (0b), agents/openai.yaml (248b), README.md (2398b), references (0b), references/Temu店铺搜索.md (5660b), references/Temu店铺搜索接口.md (7844b), references/Temu店铺榜单预设.md (2652b), references/查询暂停与恢复流程.md (1988b), requirements.txt (23b), scripts (0b), scripts/geekbi_auth.py (23978b), scripts/temu_shop_search.py (6331b), scripts/temu_site_list.py (3482b), skill-card.md (2778b), SKILL.md (3293b), _meta.json (148b)\n\nFile v0.1.0:SKILL.md\n\n---\nname: \"geekbi-temu-shop-search-skill\"\ndescription: \"通过极鲸云实时搜索和分析 Temu 店铺，支持按店铺名称或 ID、站点、可信类目 ID、托管模式、销量、销售额、评分、评论数、商品数、粉丝数、价格、开店时间、增长和动销指标筛选及排序。用户提到 Temu 店铺搜索、店铺链接、竞品店铺、竞店调研、热销店铺、头部店铺、新店、高成长店铺、店铺经营规模、动销效率或店铺排名时使用。\"\n---\n\n# 极鲸云 Temu 店铺搜索\n\n仅使用极鲸云实时返回的数据搜索和分析 Temu 店铺。将结论限定在店铺层级，不编造店铺、指标、链接或未返回的经营信息。\n\n## 执行流程\n\n1. 先读取 [Temu 店铺搜索](references/Temu店铺搜索.md)，按其中的业务口径、分析方法和输出要求执行。\n2. 读取 [Temu 店铺搜索接口](references/Temu店铺搜索接口.md)，只选取用户请求所需的查询参数。\n3. 未指定站点或指定美国站时使用站点 ID `48`。指定其他国家或地区时，先运行 `python3 scripts/temu_site_list.py --country \"国家或地区名\"`，只采用唯一精确匹配的站点 ID。\n4. 仅在已有可信类目 ID 时传入 `catIds`。没有可信 ID 时不得按类目名称猜测；优先省略类目条件并按店铺关键词搜索，类目条件不可省略时请用户提供明确 ID。\n5. 用户请求热销店铺、热销新店、最近开店等榜单时，再读取 [Temu 店铺榜单查询预设](references/Temu店铺榜单预设.md)，每次只采用一个最符合意图的主预设。\n6. 从本 Skill 根目录运行 `python3 scripts/temu_shop_search.py --param \"名称=值\"`。需要多个条件时重复传入 `--param`；需要多个类目 ID 时重复传入 `catIds`。\n7. 检查返回结构、命中总数、当前页、样本量和更新时间。需要全量结果时逐页查询；未完成分页时明确说明仅为样本。\n8. 按参考文档分析数据并输出中文业务结论。对每个返回非空 `linkUrl` 的店铺，将店铺名称写成可点击链接。\n\n## 复用登录态\n\n- 先直接运行店铺搜索脚本。脚本通过 `scripts/geekbi_auth.py` 优先读取所有极鲸云 Temu Skills 共用的系统用户配置登录态；已有有效登录态时不得再次要求登录。\n- 仅在脚本返回 `actionRequired` 或退出码 `2` 时读取并执行 [查询暂停与恢复流程](references/查询暂停与恢复流程.md)。向用户展示服务端中文提示和有效跳转链接，然后暂停查询；用户完成操作并回复继续后，原样重跑同一命令。\n- 退出码 `1` 时仅展示错误输出中的一级中文 `msg`。不得展示访问令牌、设备码、请求头、原始错误 JSON 或异常栈。\n\n## 资源路由\n\n- 执行任何店铺搜索或店铺分析时，读取 `references/Temu店铺搜索.md`。\n- 组装查询参数、选择排序字段或解释返回字段时，读取 `references/Temu店铺搜索接口.md`。\n- 处理店铺榜单请求时，读取 `references/Temu店铺榜单预设.md`。\n- 仅在服务端要求用户操作时，读取 `references/查询暂停与恢复流程.md`。\n\n若环境尚未安装依赖，运行 `python3 -m pip install -r requirements.txt` 后再执行查询脚本。\n\nFile v0.1.0:README.md\n\n# 极鲸云 Temu 店铺搜索 Skill\n\n通过极鲸云提供的真实 Temu 店铺数据，帮助国内跨境卖家搜索目标店铺、筛选竞品店铺，并分析经营规模、近期增长、动销效率、口碑和托管模式，为竞店调研、经营对标和市场竞争判断提供依据。本 Skill 专注店铺层级，不提供店内单品明细。\n\n## 主要能力\n\n| 能力 | 可以解决的问题 |\n| --- | --- |\n| Temu 店铺搜索 | 按店铺名称或 ID、站点和可信类目 ID 定位目标店铺，获取可直接访问的店铺详情链接 |\n| 竞品店铺筛选 | 按托管模式、开店时间、销量、销售额、评分、评论数、商品数、粉丝数和平均价格筛选可比店铺 |\n| 店铺榜单研究 | 查找热销店铺、高评论店铺、热销新店和最近开店的店铺，快速建立竞店候选清单 |\n| 经营表现分析 | 结合日、周、月销量与销售额及其增长率，判断店铺近期表现、增长潜力和回落风险 |\n| 动销与经营效率 | 结合商品数、动销商品数、动销率、粉丝和口碑，区分规模型店铺与高效率店铺 |\n\n## 适用场景\n\n本项目适合以下任务：\n\n- 搜索指定 Temu 店铺并获取可信店铺链接。\n- 查找头部店铺、热销店铺和直接竞争店铺。\n- 筛选最近开店、近期增长较快或具有潜力的新店。\n- 对比全托管与半托管店铺的经营规模和表现。\n- 分析店铺销量、销售额、商品规模、粉丝和口碑。\n- 评估店铺动销效率、近期增长和经营风险。\n- 建立竞品店铺清单并完成经营对标。\n\n## 安装 / 更新\n\n请直接将下面这段话发送给支持 Skill 的 AI 助手，即可完成安装或更新到最新版本：\n\n```text\n安装这个Skill: https://github.com/geekbi/geekbi-temu-shop-search-skill\n```\n\n## 开始使用\n\n安装后直接用中文描述目标即可，例如：\n\n```text\n查找Temu美国站总销量最高的20家店铺，并比较总销售额、商品数量、评分和动销率。\n```\n\n```text\n查找Temu美国站最近3个月开店且月销量增长较快的新店，并判断哪些值得持续跟踪。\n```\n\n```text\n搜索Temu店铺 Acme Home，给我店铺链接，并分析它的经营规模、近期增长和口碑。\n```\n\n```text\n对比Temu美国站半托管店铺的销量、销售额、商品规模和月动销效率，筛选表现较好的竞店。\n```\n\nFile v0.1.0:_meta.json\n\n{\n  \"ownerId\": \"kn7aztmefa4fv3mdrqs9vagx7h8c14z2\",\n  \"slug\": \"geekbi-temu-shop-search-skill\",\n  \"version\": \"0.1.0\",\n  \"publishedAt\": 1786519897263\n}\n\nFile v0.1.0:references/Temu店铺搜索.md\n\n# Temu 店铺搜索\n\n## 工作原则\n\n- 只使用极鲸云返回的真实店铺数据，不编造店铺、指标或搜索结果。\n- 将数据事实、基于数据的计算和分析判断明确区分。\n- 默认使用简体中文，日期使用绝对日期，金额标明当前 Temu 站点币种。\n- 对缺失值、异常值、样本量和未完成分页作显式说明，不用缺失数据支撑强结论。\n- 接口参数、响应字段、请求命令和原始 JSON 仅用于内部调用。进度说明、分析过程和最终答复使用中文业务名称，不展示英文参数；只有用户明确要求开发对接或故障排查时才展示必要技术信息。\n\n## 执行流程\n\n1. 明确用户要找特定店铺、筛选竞品、寻找新店，还是研究头部店铺的经营表现。\n2. 明确站点、店铺名称或 ID、类目、开店时间、经营规模和托管模式等必要条件。未指定站点时默认美国站，并在结果中说明。\n3. 读取 [Temu 店铺搜索接口](Temu店铺搜索接口.md)，生成最小必要查询条件。未指定站点或明确要求美国站时直接使用美国站默认值；只有用户指定其他国家或地区时，才运行 `scripts/temu_site_list.py` 实时解析站点。用户要求热销店铺、热销新店或最近开店等榜单时，再读取 [Temu 店铺榜单查询预设](Temu店铺榜单预设.md)。\n4. 使用 `scripts/temu_shop_search.py` 发起查询；服务端要求暂停查询时，按 [查询暂停与恢复流程](查询暂停与恢复流程.md) 提示并暂停。\n5. 恢复条件满足后原样重跑查询，取得店铺数据后再分析。\n6. 查询失败时，只向用户提示错误输出一级 `msg` 的中文文案，不展示错误 JSON、状态码、异常栈或内部字段。\n7. 检查分页范围、样本量、关键字段和更新时间后再分析；未读取全部分页时明确标为样本。\n\n## 查询策略\n\n- `keyword` 可匹配店铺名称或店铺 ID。用户给出明确店铺名称或 ID 时优先使用关键词查询。\n- 店铺搜索使用 Temu 通用站点 ID。美国站直接使用默认值 `48` 且不请求站点列表；其他国家或地区使用 `scripts/temu_site_list.py --country \"国家或地区名\"` 实时查询，只有唯一精确匹配时才将返回的站点 ID 传给店铺搜索。\n- `catIds` 使用 Temu 通用类目 ID，不存在独立的店铺主营类目 ID。只使用用户明确给出或极鲸云数据中已确认的可信 ID，优先一级或二级类目。没有可信 ID 时不根据类目名称猜测；省略 `catIds` 并仅按店铺关键词搜索，或请用户提供明确 ID。\n- 一般在关键词和类目中选择一个主条件；只有用户明确要求在某类目内查特定店铺时才组合，且说明结果可能显著减少。\n- 用户未指定排序时，根据问题选择一个最相关指标；寻找大卖优先按店铺总销量或总销售额降序，寻找高成长店铺优先筛选月均销量和月销量增长率，寻找新店优先限制开店时间后再按经营规模降序。\n- 不为凑结果擅自放宽用户明确给出的销量、销售额、评分、粉丝数、商品数、客单价或时间范围。\n- 服务端为每个店铺返回 `linkUrl`，指向该店铺在极鲸云的 Temu 店铺详情页。每个被展示的店铺都必须把店铺名称写成 `[店铺名称](<linkUrl>)`；这条规则适用于表格、列表、排名、候选清单和正文，不因用户未主动要求链接或要求简洁结果而省略。\n\n## 分析方法\n\n从以下维度评估店铺，不仅按单一销量排名：\n\n- 经营规模：店铺总销量、总销售额、商品数量、粉丝数和评论数。\n- 近期表现：结合日、周、月均销量与销售额，及其增长率判断加速或回落，不用单一时间窗口下结论。\n- 商品与定价：经营类目、平均价格及商品数量，判断价格带和铺货深度。\n- 动销效率：结合动销商品数和动销率，区分“商品多但动销弱”与“规模不大但单品效率高”的店铺。\n- 口碑：店铺评分与评论规模结合观察，避免用少量评论的高评分作强结论。\n- 发展阶段：结合开店时间与经营规模识别新店、高成长候选或成熟大卖。\n- 经营模式：区分全托管和半托管后再比较，不把不同模式的店铺直接横向排名。\n- 风险与限制：日、周、月指标可用于识别近期趋势，但不等于完整历史时序。本能力不提供单品明细和完整上新节奏，需要时明确标注为未验证项。热度仅作辅助指标，没有明确口径时不单独用它下结论。\n\n只有指标属于同一站点和可比口径时才计算店均、品均或占比。用总销售额除以商品数量等派生指标时，说明公式并排除分母为零或缺失的样本。\n\n## 输出要求\n\n店铺表格或清单的名称列必须使用 `[店铺名称](<linkUrl>)`。发送答复前逐行检查：服务端返回非空 `linkUrl` 的每个店铺都必须存在对应的可点击店铺名称，缺少任何一个都先修复再交付。\n\n用户只索要店铺链接时，仅返回 `[店铺名称](<linkUrl>)`，不附加接口、字段、链接类型或缺失状态说明。\n\n默认按以下顺序输出：\n\n1. 一句话结论。\n2. 数据口径：站点、条件、排序、分页范围、样本量和更新时间。\n3. 候选店铺：中文展示核心指标和入选原因。\n4. 经营特征与竞争判断：区分事实、计算和判断。\n5. 风险、数据限制和下一步验证动作。\n\n如果用户只要求搜索结果，保持简洁，不强行扩展为完整竞品报告。\n\nFile v0.1.0:references/Temu店铺搜索接口.md\n\n# Temu 店铺搜索接口\n\n## 目录\n\n- [脚本调用](#脚本调用)\n- [基础参数](#基础参数)\n- [站点解析](#站点解析)\n- [区间筛选参数](#区间筛选参数)\n- [排序字段](#排序字段)\n- [响应与失败处理](#成功响应)\n\n## 脚本调用\n\n单页数量最大为 200。\n\n通过以下命令调用：\n\n```bash\npython3 scripts/temu_shop_search.py \\\n  --param \"keyword=店铺名称或ID\" \\\n  --param \"siteId=48\" \\\n  --param \"size=20\" \\\n  --param \"sort=mallSold\" \\\n  --param \"order=desc\"\n```\n\n服务端要求暂停查询时，按 [查询暂停与恢复流程](查询暂停与恢复流程.md) 提示用户；恢复条件满足后再次运行同一命令。\n\n## 基础参数\n\n| 参数 | 类型 | 默认值 | 说明 |\n| --- | --- | --- | --- |\n| `keyword` | string | 无 | 店铺名称或店铺 ID，最长 300 个字符 |\n| `catIds` | integer，可重复 | 无 | Temu 通用类目 ID；多个值匹配其中任一类目 |\n| `siteId` | integer | `48` | 极鲸云站点 ID；美国站直接使用默认值，其他国家或地区先用 `scripts/temu_site_list.py` 实时解析 |\n| `page` | integer | `1` | 页码，从 1 开始 |\n| `size` | integer | `20` | 每页数量，最大 200 |\n| `sort` | string | 无 | 排序字段，取值见下方 |\n| `order` | string | `desc` | `asc` 或 `desc` |\n| `hostingMode` | integer | 无 | 托管模式：`1` 全托管，`2` 半托管 |\n\n不要从类目中文名或英文名自行推断 ID。没有可信 ID 时，不传 `catIds`，仅按店铺关键词搜索；用户的请求必须限定类目时，请用户提供明确类目 ID。\n\n## 站点解析\n\n- 未指定站点或指定美国站时，直接使用默认站点 ID `48`，不额外查询站点列表。\n- 用户指定其他国家或地区时，运行 `python3 scripts/temu_site_list.py --country \"国家或地区名\"`，将唯一精确匹配的站点 ID 传给店铺搜索。\n- 脚本实时匹配服务端返回的中文名或英文名，不使用本地静态站点表，不按语言、币种或相似名称猜测。\n- 无匹配时请用户确认国家或地区名；多个匹配时列出中文站点名请用户澄清，不自行选择。\n\n## 区间筛选参数\n\n每项均支持 `Min` 和 `Max` 后缀：\n\n| 维度 | 最小值 | 最大值 |\n| --- | --- | --- |\n| 店铺总销量 | `mallSoldMin` | `mallSoldMax` |\n| 店铺总销售额 | `mallSalesMin` | `mallSalesMax` |\n| 店铺评分 | `mallStarMin` | `mallStarMax` |\n| 评论数 | `reviewNumMin` | `reviewNumMax` |\n| 商品数量 | `goodsNumMin` | `goodsNumMax` |\n| 粉丝数 | `followerNumMin` | `followerNumMax` |\n| 平均价格 | `avgPriceMin` | `avgPriceMax` |\n| 开店时间 | `mallOpenTimeMin` | `mallOpenTimeMax` |\n| 日均销量 | `daySoldMin` | `daySoldMax` |\n| 周均销量 | `weekSoldMin` | `weekSoldMax` |\n| 月均销量 | `monthSoldMin` | `monthSoldMax` |\n| 日均销售额 | `daySalesMin` | `daySalesMax` |\n| 周均销售额 | `weekSalesMin` | `weekSalesMax` |\n| 月均销售额 | `monthSalesMin` | `monthSalesMax` |\n| 日均销量增长率 | `daySoldRateMin` | `daySoldRateMax` |\n| 周均销量增长率 | `weekSoldRateMin` | `weekSoldRateMax` |\n| 月均销量增长率 | `monthSoldRateMin` | `monthSoldRateMax` |\n| 日均销售额增长率 | `daySalesRateMin` | `daySalesRateMax` |\n| 周均销售额增长率 | `weekSalesRateMin` | `weekSalesRateMax` |\n| 月均销售额增长率 | `monthSalesRateMin` | `monthSalesRateMax` |\n| 日均商品数 | `dayItemCountMin` | `dayItemCountMax` |\n| 周均商品数 | `weekItemCountMin` | `weekItemCountMax` |\n| 月均商品数 | `monthItemCountMin` | `monthItemCountMax` |\n| 日均商品数增长率 | `dayItemCountRateMin` | `dayItemCountRateMax` |\n| 周均商品数增长率 | `weekItemCountRateMin` | `weekItemCountRateMax` |\n| 月均商品数增长率 | `monthItemCountRateMin` | `monthItemCountRateMax` |\n| 日均粉丝数 | `dayFollowerMin` | `dayFollowerMax` |\n| 周均粉丝数 | `weekFollowerMin` | `weekFollowerMax` |\n| 月均粉丝数 | `monthFollowerMin` | `monthFollowerMax` |\n| 日均粉丝数增长率 | `dayFollowerRateMin` | `dayFollowerRateMax` |\n| 周均粉丝数增长率 | `weekFollowerRateMin` | `weekFollowerRateMax` |\n| 月均粉丝数增长率 | `monthFollowerRateMin` | `monthFollowerRateMax` |\n| 日动销商品数 | `daySellthroughCountMin` | `daySellthroughCountMax` |\n| 周动销商品数 | `weekSellthroughCountMin` | `weekSellthroughCountMax` |\n| 月动销商品数 | `monthSellthroughCountMin` | `monthSellthroughCountMax` |\n| 日动销率 | `daySellthroughRateMin` | `daySellthroughRateMax` |\n| 周动销率 | `weekSellthroughRateMin` | `weekSellthroughRateMax` |\n| 月动销率 | `monthSellthroughRateMin` | `monthSellthroughRateMax` |\n\n开店时间使用 ISO 8601 日期时间。平均价格和销售额使用当前查询站点币种，向用户展示时必须标明币种。\n\n比率口径需要特别区分：\n\n- 销量、销售额、商品数和粉丝数的增长率，查询和响应均使用小数；例如用户要求增长率至少 20%，请求值使用 `0.2`。\n- 动销率查询使用 0–100 的百分比值；例如至少 20%，请求值使用 `20`。响应中动销率仍是小数，展示给用户时转成百分比。\n\n## 排序字段\n\n| 维度 | `sort` 可选值 |\n| --- | --- |\n| 店铺总销量 | `mallSold` |\n| 店铺总销售额 | `mallSales` |\n| 店铺评分 | `mallStar` |\n| 评论数 | `reviewNum` |\n| 商品数量 | `goodsNum` |\n| 粉丝数 | `followerNum` |\n| 平均价格 | `avgPrice` |\n| 热度 | `hot` |\n| 日/周/月均销量 | `daySold`、`weekSold`、`monthSold` |\n| 日/周/月均销量增长率 | `daySoldRate`、`weekSoldRate`、`monthSoldRate` |\n| 日/周/月均销售额 | `daySales`、`weekSales`、`monthSales` |\n| 日/周/月均销售额增长率 | `daySalesRate`、`weekSalesRate`、`monthSalesRate` |\n| 日/周/月均商品数 | `dayItemCount`、`weekItemCount`、`monthItemCount` |\n| 日/周/月均商品数增长率 | `dayItemCountRate`、`weekItemCountRate`、`monthItemCountRate` |\n| 日/周/月均粉丝数 | `dayFollower`、`weekFollower`、`monthFollower` |\n| 日/周/月均粉丝数增长率 | `dayFollowerRate`、`weekFollowerRate`、`monthFollowerRate` |\n| 日/周/月动销商品数 | `daySellthroughCount`、`weekSellthroughCount`、`monthSellthroughCount` |\n| 日/周/月动销率 | `daySellthroughRate`、`weekSellthroughRate`、`monthSellthroughRate` |\n| 开店时间 | `mallOpenTime` |\n| 数据更新时间 | `updateTime` |\n\n`order` 使用 `asc` 或 `desc`。\n\n## 成功响应\n\n```json\n{\n  \"code\": 0,\n  \"data\": {\n    \"total\": 100,\n    \"list\": []\n  }\n}\n```\n\n- `data.total` 是当前条件下的命中总数。\n- `data.list` 是当前页店铺列表。\n- 核心字段包括站点 ID、店铺 ID、名称、Logo、评分、评论数、商品数量、粉丝数、总销量、总销售额、平均价格、热度、经营类目、托管模式、开店时间、数据更新时间和 `linkUrl`。\n- 同时返回日/周/月均销量、销售额、商品数、粉丝数及其增长率，以及日/周/月动销商品数和动销率。\n- `linkUrl` 指向该店铺在极鲸云的 Temu 店铺详情页。展示结果时必须将每个店铺名称写成 `[店铺名称](<linkUrl>)`；该要求覆盖列表、表格、排名、候选清单和正文，不因用户未主动要求链接、要求简洁回答或表格空间有限而省略。\n\n## 失败处理\n\n- 服务端要求暂停查询时，按 [查询暂停与恢复流程](查询暂停与恢复流程.md) 展示提示，有跳转地址时再展示可点击链接，不把它解释为无数据。\n- 退出码 `1` 时读取 stderr 一级 `msg`，面向用户只提示该中文文案。\n- `code != 0`、HTTP 非 2xx、响应不是 JSON 或缺少 `data` 时，本次查询失败。\n- 请求多页时逐页累计并记录实际读取页数；未完成全部分页时不得声称结果为全量。\n\nFile v0.1.0:references/Temu店铺榜单预设.md\n\n# Temu 店铺榜单查询预设\n\n根据用户的榜单或竞品店铺调研意图选择一个查询预设，并以用户明确提出的条件为准。\n\n## 使用规则\n\n- 每次只选择一个最贴近用户意图的主预设；除非用户明确要求，不叠加多个预设。\n- 在预设之外补充站点、页码和每页数量，可按需增加关键词或类目。用户的明确条件优先于预设。\n- 排序方向统一使用 `desc` 或 `asc`。\n- 未指定或指定美国站时使用默认值，其他国家或地区先实时查询站点列表。\n- 将“近 3 个月”换算为查询执行时刻减 3 个自然月至执行时刻，传绝对 ISO 8601 时间。\n- 预设只定义筛选和排序，不代表命中店铺必然是“大卖”或“潜力店”；取得数据后仍需结合销量、增长率、动销率、商品数、口碑和开店时间验证。\n\n以下参数块省略站点、分页及所有未设置参数。\n\n## 查询预设\n\n### 热销店铺\n\n适用于“热销店铺”“头部竞品店铺”“总销量最高的店铺”等请求。\n\n```text\nsort=mallSold\norder=desc\n```\n\n### 高评论店铺\n\n适用于“评论规模大的店铺”“评价样本多的店铺”等请求。\n\n```text\nsort=reviewNum\norder=desc\n```\n\n评论数反映反馈样本规模，不等同于高评分或好口碑；还需结合店铺评分和近期经营表现判断。\n\n### 热销新店\n\n适用于“最近三个月的热销新店”“近期潜力店铺”等请求。\n\n```text\nmallOpenTimeMin=<执行时刻减3个自然月的ISO时间>\nmallOpenTimeMax=<执行时刻的ISO时间>\nsort=mallSold\norder=desc\n```\n\n该预设先限制近 3 个月开店，再按店铺总销量降序。对候选店铺下“潜力店”结论前，还要检查月均销量、月销量增长率和月动销率，避免把靠单一历史爆款累积销量的新店当成持续增长店铺。\n\n### 最近开店\n\n适用于“最近开的店”“最新入场店铺”等请求。\n\n```text\nsort=mallOpenTime\norder=desc\n```\n\n按开店时间从新到旧排序，不自动增加“近 1 个月”或“近 3 个月”条件；用户明确给定时间范围时再补充。\n\n## 生成请求前检查\n\n1. 是否只选择了一个主预设。\n2. 美国站是否使用默认值，其他站点是否已通过实时站点列表解析。\n3. 相对时间是否已转换为绝对 ISO 8601 时间。\n4. 排序方向是否只使用 `asc` 或 `desc`。\n5. 查询参数是否全部存在于店铺搜索接口契约中。\n6. 是否区分了总销量、评论规模和店铺评分，避免混用不同口径。\n7. 是否按用户明确条件调整预设，并在数据口径中说明。\n\nFile v0.1.0:references/查询暂停与恢复流程.md\n\n# 查询暂停与恢复流程\n\n业务脚本先正常查询数据。服务端因未登录、额度不足、请求受限、需要充值、开通或升级等原因要求暂停查询时，按以下流程处理：\n\n1. 使用服务端返回的中文 `msg` 提示用户，不改写提示含义。\n2. 服务端返回 `jumpUrl` 时，将其展示为可点击的 Markdown 链接；没有返回时不自行生成链接。\n3. 暂停数据查询，不展示原始 JSON 或内部状态字段，也不在尚未取得数据时生成选品或市场分析结论。\n4. 用户完成提示要求的操作、等待限制解除或回复“继续”后，原样重跑原业务脚本。\n5. 恢复条件仍未满足时，继续使用服务端最新的提示；有跳转链接时继续展示该链接，不创建并行操作。\n6. 跳转链接失效时重新运行原业务请求，使用服务端新返回的提示和链接。\n\n服务端只返回提示而没有跳转地址时，直接展示提示并停止本次查询。普通查询错误也只展示服务端一级 `msg`；没有有效提示时再使用脚本生成的中文错误。\n\n## 信息保护\n\n- 查询鉴权和暂停状态统一由公共请求脚本处理，业务脚本直接复用。\n- 所有极鲸云 Temu Skills 共用同一个系统用户配置路径和同一份鉴权状态；任意一个 Skill 完成登录后，其他 Skill 优先复用该状态，有效期内不重复登录。\n- 登录凭据依次保存到共享的系统用户配置目录、当前 Skill 目录的 `.geekbi/agent-auth.json` 和当前工作目录的 `.geekbi/agent-auth.json`；读取时也按照这一优先级选择首个存在的副本。\n- 不手工复制、输出或传递登录状态文件；跨 Skill 复用由公共系统配置路径自动完成。\n- 不向用户展示访问令牌、设备码、回调凭据、权限标识、请求头或内部状态对象。\n- 不把账号、密码、密钥或令牌写入 Skill 文档、示例、回答、日志或命令行参数。\n\nFile v0.1.0:skill-card.md\n\n## Description:\n\nSearches and analyzes Temu shops using GeekBI live data, supporting shop name or ID lookup, site selection, trusted category IDs, hosting mode, sales, revenue, ratings, reviews, product count, followers, price, opening time, growth, sell-through filters, ranking, and competitor research.\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, analysts, and operators use this skill to search Temu shops, build competitor shop lists, compare shop-level performance, and assess growth, sales scale, sell-through efficiency, ratings, and operating risk from GeekBI data.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill reuses GeekBI login state and may copy tokens into local .geekbi folders in the current project and skill directory as well as user configuration.\n\nMitigation: Run it only in workspaces where local auth files will not be archived, synced, committed, or shared; clear the GeekBI auth state if exposure is a concern.\n\nRisk: The server security verdict is suspicious because local credential reuse needs review before installation.\n\nMitigation: Review the security summary and install only if GeekBI API requests and local session reuse are acceptable for the environment.\n\nRisk: Shop analysis can be misleading when results are incomplete, missing fields, or based on a single page of data.\n\nMitigation: Report pagination, sample size, missing values, and update time, and avoid strong conclusions when the returned data does not support them.\n\n## Reference(s):\n\n- [ClawHub Skill Page](https://clawhub.ai/geekbi/skills/geekbi-temu-shop-search-skill)\n- [Server-resolved GitHub provenance](https://github.com/geekbi/geekbi-temu-shop-search-skill)\n- [Temu Shop Search](references/Temu店铺搜索.md)\n- [Temu Shop Search API](references/Temu店铺搜索接口.md)\n- [Temu Shop Ranking Presets](references/Temu店铺榜单预设.md)\n- [Query Pause and Resume Flow](references/查询暂停与恢复流程.md)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, Shell commands, Guidance]\n\n**Output Format:** [Chinese Markdown business analysis with linked shop names]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Includes query scope, sample size, pagination status, update time, and store links when returned by GeekBI.]\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: \"极鲸云 Temu 店铺搜索\"\n  short_description: \"搜索和分析 Temu 店铺，研究竞店规模、增长和经营效率\"\n  default_prompt: \"使用 $geekbi-temu-shop-search-skill 搜索并分析 Temu 竞品店铺。\"\n\nFile v0.1.0:requirements.txt\n\nplatformdirs>=4.0,<5.0","readmeExcerpt":"Skill: 极鲸云 Temu 店铺搜索 Owner: geekbi Summary: 搜索和分析 Temu 店铺，研究竞店规模、增长和经营效率 Tags: latest:0.1.0 Version history: v0.1.0 | 2026-08-12T07:31:37.263Z | auto - 首次发布：实现 Temu 店铺搜索与分析功能，基于极鲸云实时数据。 - 支持按店铺名称/ID、站点、销量、销售额、评分、评论数、粉丝数、价格、开店时间、动销等多维度筛选与排序。 - 支持店铺榜单（热销/新店/高成长等）查询，并严格按接口参数和预设执行。 - 复用统一登录态，处理服务端暂停/恢复流程，提升用户体验。 - 优化错误处理，输出规范化中文业务结论与可点击店铺链接。 Archive index: Archive v0.1.0: 17 files, 24511 bytes Files: .gitignore (28b), ag","codeSnippets":[],"executableExamples":[{"language":"text","snippet":"安装这个Skill: https://github.com/geekbi/geekbi-temu-shop-search-skill"},{"language":"text","snippet":"查找Temu美国站总销量最高的20家店铺，并比较总销售额、商品数量、评分和动销率。"},{"language":"text","snippet":"查找Temu美国站最近3个月开店且月销量增长较快的新店，并判断哪些值得持续跟踪。"},{"language":"text","snippet":"搜索Temu店铺 Acme Home，给我店铺链接，并分析它的经营规模、近期增长和口碑。"},{"language":"text","snippet":"对比Temu美国站半托管店铺的销量、销售额、商品规模和月动销效率，筛选表现较好的竞店。"},{"language":"bash","snippet":"python3 scripts/temu_shop_search.py \\\n  --param \"keyword=店铺名称或ID\" \\\n  --param \"siteId=48\" \\\n  --param \"size=20\" \\\n  --param \"sort=mallSold\" \\\n  --param \"order=desc\""}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: \"geekbi-temu-shop-search-skill\"\ndescription: \"通过极鲸云实时搜索和分析 Temu 店铺，支持按店铺名称或 ID、站点、可信类目 ID、托管模式、销量、销售额、评分、评论数、商品数、粉丝数、价格、开店时间、增长和动销指标筛选及排序。用户提到 Temu 店铺搜索、店铺链接、竞品店铺、竞店调研、热销店铺、头部店铺、新店、高成长店铺、店铺经营规模、动销效率或店铺排名时使用。\"\n---\n\n# 极鲸云 Temu 店铺搜索\n\n仅使用极鲸云实时返回的数据搜索和分析 Temu 店铺。将结论限定在店铺层级，不编造店铺、指标、链接或未返回的经营信息。\n\n## 执行流程\n\n1. 先读取 [Temu 店铺搜索](references/Temu店铺搜索.md)，按其中的业务口径、分析方法和输出要求执行。\n2. 读取 [Temu 店铺搜索接口](references/Temu店铺搜索接口.md)，只选取用户请求所需的查询参数。\n3. 未指定站点或指定美国站时使用站点 ID `48`。指定其他国家或地区时，先运行 `python3 scripts/temu_site_list.py --country \"国家或地区名\"`，只采用唯一精确匹配的站点 ID。\n4. 仅在已有可信类目 ID 时传入 `catIds`。没有可信 ID 时不得按类目名称猜测；优先省略类目条件并按店铺关键词搜索，类目条件不可省略时请用户提供明确 ID。\n5. 用户请求热销店铺、热销新店、最近开店等榜单时，再读取 [Temu 店铺榜单查询预设](references/Temu店铺榜单预设.md)，每次只采用一个最符合意图的主预设。\n6. 从本 Skill 根目录运行 `python3 scripts/temu_shop_search.py --param \"名称=值\"`。需要多个条件时重复传入 `--param`；需要多个类目 ID 时重复传入 `catIds`。\n7. 检查返回结构、命中总数、当前页、样本量和更新时间。需要全量结果时逐页查询；未完成分页时明确说明仅为样本。\n8. 按参考文档分析数据并输出中文业务结论。对每个返回非空 `linkUrl` 的店铺，将店铺名称写成可点击链接。\n\n## 复用登录态\n\n- 先直接运行店铺搜索脚本。脚本通过 `scripts/geekbi_auth.py` 优先读取所有极鲸云 Temu Skills 共用的系统用户配置登录态；已有有效登录态时不得再次要求登录。\n- 仅在脚本返回 `actionRequired` 或退出码 `2` 时读取并执行 [查询暂停与恢复流程](references/查询暂停与恢复流程.md)。向用户展示服务端中文提示和有效跳转链接，然后暂停查询；用户完成操作并回复继续后，原样重跑同一命令。\n- 退出码 `1` 时仅展示错误输出中的一级中文 `msg`。不得展示访问令牌、设备码、请求头、原始错误 JSON 或异常栈。\n\n## 资源路由\n\n- 执行任何店铺搜索或店铺分析时，读取 `references/Temu店铺搜索.md`。\n- 组装查询参数、选择排序字段或解释返回字段时，读取 `references/Temu店铺搜索接口.md`。\n- 处理店铺榜单请求时，读取 `references/Temu店铺榜单预设.md`。\n- 仅在服务端要求用户操作时，读取 `references/查询暂停与恢复流程.md`。\n\n若环境尚未安装依赖，运行 `python3 -m pip install -r requirements.txt` 后再执行查询脚本。"},{"path":"README.md","content":"# 极鲸云 Temu 店铺搜索 Skill\n\n通过极鲸云提供的真实 Temu 店铺数据，帮助国内跨境卖家搜索目标店铺、筛选竞品店铺，并分析经营规模、近期增长、动销效率、口碑和托管模式，为竞店调研、经营对标和市场竞争判断提供依据。本 Skill 专注店铺层级，不提供店内单品明细。\n\n## 主要能力\n\n| 能力 | 可以解决的问题 |\n| --- | --- |\n| Temu 店铺搜索 | 按店铺名称或 ID、站点和可信类目 ID 定位目标店铺，获取可直接访问的店铺详情链接 |\n| 竞品店铺筛选 | 按托管模式、开店时间、销量、销售额、评分、评论数、商品数、粉丝数和平均价格筛选可比店铺 |\n| 店铺榜单研究 | 查找热销店铺、高评论店铺、热销新店和最近开店的店铺，快速建立竞店候选清单 |\n| 经营表现分析 | 结合日、周、月销量与销售额及其增长率，判断店铺近期表现、增长潜力和回落风险 |\n| 动销与经营效率 | 结合商品数、动销商品数、动销率、粉丝和口碑，区分规模型店铺与高效率店铺 |\n\n## 适用场景\n\n本项目适合以下任务：\n\n- 搜索指定 Temu 店铺并获取可信店铺链接。\n- 查找头部店铺、热销店铺和直接竞争店铺。\n- 筛选最近开店、近期增长较快或具有潜力的新店。\n- 对比全托管与半托管店铺的经营规模和表现。\n- 分析店铺销量、销售额、商品规模、粉丝和口碑。\n- 评估店铺动销效率、近期增长和经营风险。\n- 建立竞品店铺清单并完成经营对标。\n\n## 安装 / 更新\n\n请直接将下面这段话发送给支持 Skill 的 AI 助手，即可完成安装或更新到最新版本：\n\n```text\n安装这个Skill: https://github.com/geekbi/geekbi-temu-shop-search-skill\n```\n\n## 开始使用\n\n安装后直接用中文描述目标即可，例如：\n\n```text\n查找Temu美国站总销量最高的20家店铺，并比较总销售额、商品数量、评分和动销率。\n```\n\n```text\n查找Temu美国站最近3个月开店且月销量增长较快的新店，并判断哪些值得持续跟踪。\n```\n\n```text\n搜索Temu店铺 Acme Home，给我店铺链接，并分析它的经营规模、近期增长和口碑。\n```\n\n```text\n对比Temu美国站半托管店铺的销量、销售额、商品规模和月动销效率，筛选表现较好的竞店。\n```"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn7aztmefa4fv3mdrqs9vagx7h8c14z2\",\n  \"slug\": \"geekbi-temu-shop-search-skill\",\n  \"version\": \"0.1.0\",\n  \"publishedAt\": 1786519897263\n}"},{"path":"references/Temu店铺搜索.md","content":"# Temu 店铺搜索\n\n## 工作原则\n\n- 只使用极鲸云返回的真实店铺数据，不编造店铺、指标或搜索结果。\n- 将数据事实、基于数据的计算和分析判断明确区分。\n- 默认使用简体中文，日期使用绝对日期，金额标明当前 Temu 站点币种。\n- 对缺失值、异常值、样本量和未完成分页作显式说明，不用缺失数据支撑强结论。\n- 接口参数、响应字段、请求命令和原始 JSON 仅用于内部调用。进度说明、分析过程和最终答复使用中文业务名称，不展示英文参数；只有用户明确要求开发对接或故障排查时才展示必要技术信息。\n\n## 执行流程\n\n1. 明确用户要找特定店铺、筛选竞品、寻找新店，还是研究头部店铺的经营表现。\n2. 明确站点、店铺名称或 ID、类目、开店时间、经营规模和托管模式等必要条件。未指定站点时默认美国站，并在结果中说明。\n3. 读取 [Temu 店铺搜索接口](Temu店铺搜索接口.md)，生成最小必要查询条件。未指定站点或明确要求美国站时直接使用美国站默认值；只有用户指定其他国家或地区时，才运行 `scripts/temu_site_list.py` 实时解析站点。用户要求热销店铺、热销新店或最近开店等榜单时，再读取 [Temu 店铺榜单查询预设](Temu店铺榜单预设.md)。\n4. 使用 `scripts/temu_shop_search.py` 发起查询；服务端要求暂停查询时，按 [查询暂停与恢复流程](查询暂停与恢复流程.md) 提示并暂停。\n5. 恢复条件满足后原样重跑查询，取得店铺数据后再分析。\n6. 查询失败时，只向用户提示错误输出一级 `msg` 的中文文案，不展示错误 JSON、状态码、异常栈或内部字段。\n7. 检查分页范围、样本量、关键字段和更新时间后再分析；未读取全部分页时明确标为样本。\n\n## 查询策略\n\n- `keyword` 可匹配店铺名称或店铺 ID。用户给出明确店铺名称或 ID 时优先使用关键词查询。\n- 店铺搜索使用 Temu 通用站点 ID。美国站直接使用默认值 `48` 且不请求站点列表；其他国家或地区使用 `scripts/temu_site_list.py --country \"国家或地区名\"` 实时查询，只有唯一精确匹配时才将返回的站点 ID 传给店铺搜索。\n- `catIds` 使用 Temu 通用类目 ID，不存在独立的店铺主营类目 ID。只使用用户明确给出或极鲸云数据中已确认的可信 ID，优先一级或二级类目。没有可信 ID 时不根据类目名称猜测；省略 `catIds` 并仅按店铺关键词搜索，或请用户提供明确 ID。\n- 一般在关键词和类目中选择一个主条件；只有用户明确要求在某类目内查特定店铺时才组合，且说明结果可能显著减少。\n- 用户未指定排序时，根据问题选择一个最相关指标；寻找大卖优先按店铺总销量或总销售额降序，寻找高成长店铺优先筛选月均销量和月销量增长率，寻找新店优先限制开店时间后再按经营规模降序。\n- 不为凑结果擅自放宽用户明确给出的销量、销售额、评分、粉丝数、商品数、客单价或时间范围。\n- 服务端为每个店铺返回 `linkUrl`，指向该店铺在极鲸云的 Temu 店铺详情页。每个被展示的店铺都必须把店铺名称写成 `[店铺名称](<linkUrl>)`；这条规则适用于表格、列表、排名、候选清单和正文，不因用户未主动要求链接或要求简洁结果而省略。\n\n## 分析方法\n\n从以下维度评估店铺，不仅按单一销量排名：\n\n- 经营规模：店铺总销量、总销售额、商品数量、粉丝数和评论数。\n- 近期表现：结合日、周、月均销量与销售额，及其增长率判断加速或回落，不用单一时间窗口下结论。\n- 商品与定价：经营类目、平均价格及商品数量，判断价格带和铺货深度。\n- 动销效率：结合动销商品数和动销率，区分“商品多但动销弱”与“规模不大但单品效率高”的店铺。\n- 口碑：店铺评分与评论规模结合观察，避免用少量评论的高评分作强结论。\n- 发展阶段：结合开店时间与经营规模识别新店、高成长候选或成熟大卖。\n- 经营模式：区分全托管和半托管后再比较，不把不同模式的店铺直接横向排名。\n- 风险与限制：日、周、月指标可用于识别近期趋势，但不等于完整历史时序。本能力不提供单品明细和完整上新节奏，需要时明确标注为未验证项。热度仅作辅助指标，没有明确口径时不单独用它下结论。\n\n只有指标属于同一站点和可比口径时才计算店均、品均或占比。用总销售额除以商品数量等派生指标时，说明公式并排除分母为零或缺失的样本。\n\n## 输出要求\n\n店铺表格或清单的名称列必须使用 `[店铺名称](<linkUrl>)`。发送答复前逐行检查：服务端返回非空 `linkUrl` 的每个店铺都必须存在对应的可点击店铺名称，缺少任何一个都先修复再交付。\n\n用户只索要店铺链接时，仅返回 `[店铺名称](<linkUrl>)`，不附加接口、字段、链接类型或缺失状态说明。\n\n默认按以下顺序输出：\n\n1. 一句话结论。\n2. 数据口径：站点、条件、排序、分页范围、样本量和更新时间。\n3. 候选店铺：中文展示核心指标和入选原因。\n4. 经营特征与竞争判断：区分事实、计算和判断。\n5. 风险、数据限制和下一步验证动作。\n\n如果用户只要求搜索结果，保持简洁，不强行扩展为完整竞品报告。"},{"path":"references/Temu店铺搜索接口.md","content":"# Temu 店铺搜索接口\n\n## 目录\n\n- [脚本调用](#脚本调用)\n- [基础参数](#基础参数)\n- [站点解析](#站点解析)\n- [区间筛选参数](#区间筛选参数)\n- [排序字段](#排序字段)\n- [响应与失败处理](#成功响应)\n\n## 脚本调用\n\n单页数量最大为 200。\n\n通过以下命令调用：\n\n```bash\npython3 scripts/temu_shop_search.py \\\n  --param \"keyword=店铺名称或ID\" \\\n  --param \"siteId=48\" \\\n  --param \"size=20\" \\\n  --param \"sort=mallSold\" \\\n  --param \"order=desc\"\n```\n\n服务端要求暂停查询时，按 [查询暂停与恢复流程](查询暂停与恢复流程.md) 提示用户；恢复条件满足后再次运行同一命令。\n\n## 基础参数\n\n| 参数 | 类型 | 默认值 | 说明 |\n| --- | --- | --- | --- |\n| `keyword` | string | 无 | 店铺名称或店铺 ID，最长 300 个字符 |\n| `catIds` | integer，可重复 | 无 | Temu 通用类目 ID；多个值匹配其中任一类目 |\n| `siteId` | integer | `48` | 极鲸云站点 ID；美国站直接使用默认值，其他国家或地区先用 `scripts/temu_site_list.py` 实时解析 |\n| `page` | integer | `1` | 页码，从 1 开始 |\n| `size` | integer | `20` | 每页数量，最大 200 |\n| `sort` | string | 无 | 排序字段，取值见下方 |\n| `order` | string | `desc` | `asc` 或 `desc` |\n| `hostingMode` | integer | 无 | 托管模式：`1` 全托管，`2` 半托管 |\n\n不要从类目中文名或英文名自行推断 ID。没有可信 ID 时，不传 `catIds`，仅按店铺关键词搜索；用户的请求必须限定类目时，请用户提供明确类目 ID。\n\n## 站点解析\n\n- 未指定站点或指定美国站时，直接使用默认站点 ID `48`，不额外查询站点列表。\n- 用户指定其他国家或地区时，运行 `python3 scripts/temu_site_list.py --country \"国家或地区名\"`，将唯一精确匹配的站点 ID 传给店铺搜索。\n- 脚本实时匹配服务端返回的中文名或英文名，不使用本地静态站点表，不按语言、币种或相似名称猜测。\n- 无匹配时请用户确认国家或地区名；多个匹配时列出中文站点名请用户澄清，不自行选择。\n\n## 区间筛选参数\n\n每项均支持 `Min` 和 `Max` 后缀：\n\n| 维度 | 最小值 | 最大值 |\n| --- | --- | --- |\n| 店铺总销量 | `mallSoldMin` | `mallSoldMax` |\n| 店铺总销售额 | `mallSalesMin` | `mallSalesMax` |\n| 店铺评分 | `mallStarMin` | `mallStarMax` |\n| 评论数 | `reviewNumMin` | `reviewNumMax` |\n| 商品数量 | `goodsNumMin` | `goodsNumMax` |\n| 粉丝数 | `followerNumMin` | `followerNumMax` |\n| 平均价格 | `avgPriceMin` | `avgPriceMax` |\n| 开店时间 | `mallOpenTimeMin` | `mallOpenTimeMax` |\n| 日均销量 | `daySoldMin` | `daySoldMax` |\n| 周均销量 | `weekSoldMin` | `weekSoldMax` |\n| 月均销量 | `monthSoldMin` | `monthSoldMax` |\n| 日均销售额 | `daySalesMin` | `daySalesMax` |\n| 周均销售额 | `weekSalesMin` | `weekSalesMax` |\n| 月均销售额 | `monthSalesMin` | `monthSalesMax` |\n| 日均销量增长率 | `daySoldRateMin` | `daySoldRateMax` |\n| 周均销量增长率 | `weekSoldRateMin` | `weekSoldRateMax` |\n| 月均销量增长率 | `monthSoldRateMin` | `monthSoldRateMax` |\n| 日均销售额增长率 | `daySalesRateMin` | `daySalesRateMax` |\n| 周均销售额增长率 | `weekSalesRateMin` | `weekSalesRateMax` |\n| 月均销售额增长率 | `monthSalesRateMin` | `monthSalesRateMax` |\n| 日均商品数 | `dayItemCountMin` | `dayItemCountMax` |\n| 周均商品数 | `weekItemCountMin` | `weekItemCountMax` |\n| 月均商品数 | `monthItemCountMin` | `monthItemCountMax` |\n| 日均商品数增长率 | `dayItemCountRateMin` | `dayItemCountRateMax` |\n| 周均商品数增长率 | `weekItemCountRateMin` | `weekItemCountRateMax` |\n| 月均商品数增长率 | `monthItemCountRateMin` | `monthItemCountRateMax` |\n| 日均粉丝数 | `dayFollowerMin` | `dayFollowerMax` |\n| 周均粉丝数 | `weekFollowerMin` | `weekFollowerMax` |\n| 月均粉丝数 | `monthFollowerMin` | `monthFollowerMax` |\n| 日均粉丝数增长率 | `dayFollowerRateMin` | `dayFollowerRateMax` |\n| 周均粉丝数增长率 | `weekFollowerRateMin` | `weekFollowerRateMax` |\n| 月均粉丝数增长率 | `monthFollowerRateMin` | `monthFollowerRateMax` |\n| 日动销商品数 | `daySellthroughCountMin` | `daySellthroughCountMax` |\n| 周动销商品数 | `weekSellthroughCountMin` | `weekSellthroughC"}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"搜索和分析 Temu 店铺，研究竞店规模、增长和经营效率 Skill: 极鲸云 Temu 店铺搜索 Owner: geekbi Summary: 搜索和分析 Temu 店铺，研究竞店规模、增长和经营效率 Tags: latest:0.1.0 Version history: v0.1.0 | 2026-08-12T07:31:37.263Z | auto - 首次发布：实现 Temu 店铺搜索与分析功能，基于极鲸云实时数据。 - 支持按店铺名称/ID、站点、销量、销售额、评分、评论数、粉丝数、价格、开店时间、动销等多维度筛选与排序。 - 支持店铺榜单（热销/新店/高成长等）查询，并严格按接口参数和预设执行。 - 复用统一登录态，处理服务端暂停/恢复流程，提升用户体验。 - 优化错误处理，输出规范化中文业务结论与可点击店铺链接。 Archive index: Archive v0.1.0: 17 files, 24511 bytes Files: .gitignore (28b), ag","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":576,"uniquenessScore":65,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-10T03:48:53.189Z","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-10T03:48:53.189Z","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:07:07.486Z","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"}]}}}