{"id":"6e3957ee-cec2-43a7-a376-efbf2216519f","entityType":"agent","slug":"clawhub-geekbi-geekbi-temu-category-search-skill","name":"极鲸云 Temu 类目搜索/品类搜索","canonicalUrl":"https://www.xpersona.co/agent/clawhub-geekbi-geekbi-temu-category-search-skill","canonicalPath":"/agent/clawhub-geekbi-geekbi-temu-category-search-skill","generatedAt":"2026-10-10T06:57:45.223Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-10T03:29:12.991Z","emptyReason":null},"description":"搜索和分析 Temu 类目，判断市场规模、供需与品类机会 Skill: 极鲸云 Temu 类目搜索/品类搜索 Owner: geekbi Summary: 搜索和分析 Temu 类目，判断市场规模、供需与品类机会 Tags: latest:0.1.0 Version history: v0.1.0 | 2026-08-12T07:31:28.344Z | auto - 首次发布：实现通过极鲸云实时搜索和分析 Temu 类目，返回可信类目 ID 和完整路径。 - 支持按站点、名称、层级、父类目及多项业务指标筛选与排序。 - 按请求自动复用已有极鲸云登录状态，无需重复登录。 - 严格遵循官方接口及文档，保障返回类目数据真实可靠。 - 处理榜单类请求时自动选用最合适的预设，输出中文业务结论与可点击类目链接。 Archive index: Archive v0.1.0: 17 files, 24107 bytes Files: .gitignore (28b), agents (0b), 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-category-search-skill","sourceUrl":"https://clawhub.ai/geekbi/geekbi-temu-category-search-skill","homepage":"https://clawhub.ai/geekbi/skills/geekbi-temu-category-search-skill","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/geekbi/geekbi-temu-category-search-skill","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/geekbi/skills/geekbi-temu-category-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-"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-10T03:29:12.991Z","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:29:12.991Z","emptyReason":null},"stars":null,"forks":null,"downloads":1734,"packageName":null,"latestVersion":"0.1.0","tractionLabel":"1.7K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T03:29:12.990Z","emptyReason":null},"lastUpdatedAt":"2026-10-10T03:29:12.991Z","lastCrawledAt":"2026-10-10T03:29:12.990Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-11T03:29:12.990Z","lastVerifiedAt":null,"highlights":[{"version":"0.1.0","createdAt":"2026-08-12T07:31:28.344Z","changelog":"- 首次发布：实现通过极鲸云实时搜索和分析 Temu 类目，返回可信类目 ID 和完整路径。 - 支持按站点、名称、层级、父类目及多项业务指标筛选与排序。 - 按请求自动复用已有极鲸云登录状态，无需重复登录。 - 严格遵循官方接口及文档，保障返回类目数据真实可靠。 - 处理榜单类请求时自动选用最合适的预设，输出中文业务结论与可点击类目链接。","fileCount":17,"zipByteSize":24107}]},"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-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-temu-category-search-skill/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-geekbi-geekbi-temu-category-search-skill/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-geekbi-geekbi-temu-category-search-skill/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-geekbi-geekbi-temu-category-search-skill/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-geekbi-geekbi-temu-category-search-skill/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-geekbi-geekbi-temu-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-10T06:57:45.222Z"}},"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-category-search-skill/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-geekbi-geekbi-temu-category-search-skill/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-geekbi-geekbi-temu-category-search-skill/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-geekbi-geekbi-temu-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-10T03:29:12.991Z","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:28.344Z | auto\n\n- 首次发布：实现通过极鲸云实时搜索和分析 Temu 类目，返回可信类目 ID 和完整路径。\n- 支持按站点、名称、层级、父类目及多项业务指标筛选与排序。\n- 按请求自动复用已有极鲸云登录状态，无需重复登录。\n- 严格遵循官方接口及文档，保障返回类目数据真实可靠。\n- 处理榜单类请求时自动选用最合适的预设，输出中文业务结论与可点击类目链接。\n\nArchive index:\n\nArchive v0.1.0: 17 files, 24107 bytes\n\nFiles: .gitignore (28b), agents (0b), agents/openai.yaml (252b), README.md (2399b), references (0b), references/Temu类目搜索.md (5438b), references/Temu类目搜索接口.md (6694b), references/Temu类目榜单预设.md (2499b), references/查询暂停与恢复流程.md (1988b), requirements.txt (23b), scripts (0b), scripts/geekbi_auth.py (23978b), scripts/temu_category_search.py (5895b), scripts/temu_site_list.py (3482b), skill-card.md (2788b), SKILL.md (3233b), _meta.json (152b)\n\nFile v0.1.0:SKILL.md\n\n---\nname: \"geekbi-temu-category-search-skill\"\ndescription: \"通过极鲸云实时搜索和分析 Temu 类目，返回可信类目 ID 和完整路径，支持按站点、名称、层级、父类目、蓝海指数、销量、销售额、商品数、店铺数、半托管供给和增长指标筛选及排序。用户提到 Temu 类目搜索、类目 ID、类目路径、热销类目、蓝海类目、品类规模、类目趋势、供需竞争或类目机会时使用。\"\n---\n\n# 极鲸云 Temu 类目搜索\n\n仅使用极鲸云实时返回的数据搜索和分析 Temu 类目。独立返回经类目路径和层级验证的可信 ID，不根据名称猜测类目 ID，不编造类目、指标、链接或市场结论。\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. 用户请求热销类目、蓝海类目或类目机会榜单时，再读取 [Temu 类目榜单查询预设](references/Temu类目榜单预设.md)，每次只采用一个最符合意图的主预设。\n5. 从本 Skill 根目录运行 `python3 scripts/temu_category_search.py --param \"名称=值\"`。需要多个条件时重复传入 `--param`。\n6. 用返回的完整类目路径、层级和父类目核验 `catId`。名称相近或路径不唯一时列出候选并请用户确认，不自行选择。\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- 执行任何类目搜索、类目 ID 查询或类目分析时，读取 `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 类目数据，帮助国内跨境卖家查询可信类目 ID、层级和完整路径，并分析类目市场规模、需求趋势、商品与店铺供给、价格和半托管渗透，为品类研究和赛道判断提供依据。本 Skill 提供类目级市场判断，类目数据不能直接证明具体单品机会。\n\n## 主要能力\n\n| 能力 | 可以解决的问题 |\n| --- | --- |\n| Temu 类目搜索 | 按中文或英文名称、层级和父类目查找类目，并用完整路径核验可信类目 ID |\n| 类目市场规模 | 结合总销量、总销售额、近期销量与销售额，判断品类需求规模和市场体量 |\n| 供需竞争分析 | 对比需求增长与商品数、店铺数及其变化，识别供给拥挤度和竞争压力 |\n| 类目趋势研究 | 结合日、周、月销量和销售额增长率，识别近期增长、回落和异常波动 |\n| 蓝海与经营模式 | 综合蓝海指数、价格、商品与店铺供给及半托管占比，筛选值得进一步验证的类目 |\n\n## 适用场景\n\n本项目适合以下任务：\n\n- 查询 Temu 类目 ID、类目层级和完整归属路径。\n- 搜索一级、二级或指定父类目下的直接子类目。\n- 研究类目销量、销售额、商品数和店铺数等市场规模。\n- 查找热销类目、蓝海类目和近期增长类目。\n- 对比需求增长与商品、店铺供给增长，判断供需竞争。\n- 分析类目平均价格和半托管商品、店铺渗透情况。\n- 为后续品类调研确定可信的类目范围和筛选条件。\n\n## 安装 / 更新\n\n请直接将下面这段话发送给支持 Skill 的 AI 助手，即可完成安装或更新到最新版本：\n\n```text\n安装这个Skill: https://github.com/geekbi/geekbi-temu-category-search-skill\n```\n\n## 开始使用\n\n安装后直接用中文描述目标即可，例如：\n\n```text\n帮我查Temu美国站 pet supplies 对应的可信类目 ID、层级和完整路径。\n```\n\n```text\n列出Temu美国站总销量最高的二级类目，并比较市场规模、平均价格和竞争供给。\n```\n\n```text\n查找Temu美国站月销量增长快于商品数和店铺数增长的二级类目，筛选值得继续调研的方向。\n```\n\n```text\n分析Temu美国站蓝海指数较高的类目，结合销量、销售额、商品数和店铺数说明机会与风险。\n```\n\nFile v0.1.0:_meta.json\n\n{\n  \"ownerId\": \"kn7aztmefa4fv3mdrqs9vagx7h8c14z2\",\n  \"slug\": \"geekbi-temu-category-search-skill\",\n  \"version\": \"0.1.0\",\n  \"publishedAt\": 1786519888344\n}\n\nFile v0.1.0:references/Temu类目搜索.md\n\n# Temu 类目搜索\n\n## 工作原则\n\n- 只使用极鲸云返回的真实类目数据，不编造类目、ID、指标或查询结果。\n- 明确区分数据事实、可复算的派生指标和分析判断。\n- 默认使用简体中文，日期使用绝对日期；平均价格和销售额标明当前 Temu 站点币种。\n- 对缺失值、异常值、样本量和未完成分页作显式说明；指标为 `0` 时也要结合其他指标和更新时间核验，不自动当成真实为零。\n- 接口参数、响应字段、请求命令和原始 JSON 仅用于内部调用。进度说明、分析过程和最终答复使用中文业务名称，不展示英文参数；只有用户明确要求开发对接或故障排查时才展示必要技术信息。\n\n## 执行流程\n\n1. 明确用户是要找可信类目 ID、查热销/蓝海类目、研究市场规模，还是为后续数据查询确定类目条件。\n2. 明确站点、类目关键词、层级、父类目、需求规模和供给规模等必要条件。未指定站点时默认美国站，并在结果口径中说明。\n3. 读取 [Temu 类目搜索接口](Temu类目搜索接口.md)，生成最小必要查询条件。用户要求热销类目或蓝海类目时，再读取 [Temu 类目榜单查询预设](Temu类目榜单预设.md)。\n4. 未指定站点或明确要求美国站时直接使用默认值；只有用户指定其他国家或地区时，才运行 `scripts/temu_site_list.py` 实时解析站点。\n5. 使用 `scripts/temu_category_search.py` 查询；服务端要求暂停查询时，按 [查询暂停与恢复流程](查询暂停与恢复流程.md) 提示并暂停。\n6. 恢复条件满足后原样重跑查询，取得类目数据后再分析。\n7. 查询失败时，只向用户提示错误输出一级 `msg` 的中文文案，不展示错误 JSON、状态码、异常栈或内部字段。\n8. 核对分页范围、样本量、关键指标和更新时间后再分析；未读取全部分页时明确标为样本。\n\n## 查询策略\n\n- 类目名称使用内置模糊搜索；用户提供明确行业或品类名称时优先使用关键词。\n- 优先查询一级或二级类目。用户未要求精细下钻时，不主动限制三级、四级类目；过细类目容易导致市场样本过少。\n- 已知父类目 ID 时，可查其直接子类目。搜索结果返回从一级类目到当前类目的完整路径，用路径和层级验证 ID，不根据名称猜测 ID。\n- 返回的 `catId` 属于 Temu 通用类目 ID 体系。必须结合完整类目路径、层级和父类目验证 ID；名称相近时列出候选并请用户确认，不根据名称猜测。\n- 搜索特定类目名称时，不为了“更准”无条件叠加父类目和层级；只在用户已明确市场边界或需要下钻时组合，并注意条件过多会减少结果。\n- 未指定排序时按问题选择一个主指标：热销优先总销量，蓝海优先蓝海指数，近期增长优先月销量增长率或月销售额增长率。\n- 服务端为每个类目返回 `linkUrl`，指向该类目在极鲸云的 Temu 类目详情页。每个被展示的类目都必须把类目名称或完整类目路径写成 `[类目名称或完整类目路径](<linkUrl>)`；这条规则适用于表格、列表、排名、候选清单和正文，不因用户未主动要求链接或要求简洁结果而省略。\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. 候选类目：展示中文类目路径、类目 ID、核心指标和入选原因。\n4. 机会与竞争判断：区分事实、计算和判断。\n5. 风险、数据限制和下一步验证动作。\n\n用户只要类目 ID 或简单搜索结果时保持简洁，不强行扩展为完整市场报告。\n\nFile v0.1.0:references/Temu类目搜索接口.md\n\n# Temu 类目搜索接口\n\n## 目录\n\n- [脚本调用](#脚本调用)\n- [基础参数](#基础参数)\n- [站点与类目 ID](#站点与类目-id)\n- [区间筛选参数](#区间筛选参数)\n- [排序字段](#排序字段)\n- [响应与失败处理](#成功响应)\n\n## 脚本调用\n\n单页数量最大为 200。\n\n通过以下命令调用：\n\n```bash\npython3 scripts/temu_category_search.py \\\n  --param \"keyword=clothing\" \\\n  --param \"siteId=48\" \\\n  --param \"catLevel=2\" \\\n  --param \"size=20\" \\\n  --param \"sort=totalSold\" \\\n  --param \"order=desc\"\n```\n\n服务端要求暂停查询时，按 [查询暂停与恢复流程](查询暂停与恢复流程.md) 提示用户；恢复条件满足后再次运行同一命令。\n\n## 基础参数\n\n| 参数 | 类型 | 默认值 | 说明 |\n| --- | --- | --- | --- |\n| `keyword` | string | 无 | 类目中文或英文名称，最长 300 个字符，使用内置模糊搜索 |\n| `siteId` | integer | `48` | 极鲸云站点 ID；美国站直接使用默认值，其他国家或地区先实时解析站点 |\n| `catLevel` | integer | 无 | 类目层级：1、2、3 或 4；作为通用市场筛选条件时优先 1 或 2 |\n| `parentCatId` | integer | 无 | 父类目 ID，只返回该父类目的直接子类目；`0` 代表根层 |\n| `page` | integer | `1` | 页码，从 1 开始 |\n| `size` | integer | `20` | 每页数量，最大 200 |\n| `sort` | string | 无 | 排序字段，取值见下方 |\n| `order` | string | `desc` | `asc` 或 `desc` |\n\n## 站点与类目 ID\n\n- 未指定站点或指定美国站时，直接使用美国站 ID `48`，不额外查询站点列表。\n- 用户指定其他国家或地区时，运行 `python3 scripts/temu_site_list.py --country \"国家或地区名\"`，只使用唯一精确匹配的站点 ID。\n- 不使用本地静态站点表，不按语言、币种或相似名称猜测。无匹配或多个匹配时请用户确认。\n- 响应中的 `catId` 属于 Temu 通用类目 ID 体系，可作为后续支持类目筛选的请求条件；用于广泛市场筛选时优先使用一级或二级类目。\n\n## 区间筛选参数\n\n每项均支持 `Min` 和 `Max` 后缀：\n\n| 维度 | 最小值 | 最大值 |\n| --- | --- | --- |\n| 蓝海指数 | `dsrMin` | `dsrMax` |\n| 总销量 | `totalSoldMin` | `totalSoldMax` |\n| 平均价格 | `avgPriceMin` | `avgPriceMax` |\n| 总销售额 | `totalSalesMin` | `totalSalesMax` |\n| 总商品数 | `itemCountMin` | `itemCountMax` |\n| 半托管商品数 | `semiManagedItemCountMin` | `semiManagedItemCountMax` |\n| 总店铺数 | `mallCountMin` | `mallCountMax` |\n| 半托管店铺数 | `semiManagedMallCountMin` | `semiManagedMallCountMax` |\n| 日/周/月销量 | `daySoldMin`、`weekSoldMin`、`monthSoldMin` | `daySoldMax`、`weekSoldMax`、`monthSoldMax` |\n| 日/周/月销量增长率 | `daySoldRateMin`、`weekSoldRateMin`、`monthSoldRateMin` | `daySoldRateMax`、`weekSoldRateMax`、`monthSoldRateMax` |\n| 日/周/月销售额 | `daySalesMin`、`weekSalesMin`、`monthSalesMin` | `daySalesMax`、`weekSalesMax`、`monthSalesMax` |\n| 日/周/月销售额增长率 | `daySalesRateMin`、`weekSalesRateMin`、`monthSalesRateMin` | `daySalesRateMax`、`weekSalesRateMax`、`monthSalesRateMax` |\n| 日/周/月商品数变化量 | `dayItemCountMin`、`weekItemCountMin`、`monthItemCountMin` | `dayItemCountMax`、`weekItemCountMax`、`monthItemCountMax` |\n| 日/周/月商品数增长率 | `dayItemCountRateMin`、`weekItemCountRateMin`、`monthItemCountRateMin` | `dayItemCountRateMax`、`weekItemCountRateMax`、`monthItemCountRateMax` |\n| 日/周/月店铺数变化量 | `dayMallCountMin`、`weekMallCountMin`、`monthMallCountMin` | `dayMallCountMax`、`weekMallCountMax`、`monthMallCountMax` |\n| 日/周/月店铺数增长率 | `dayMallCountRateMin`、`weekMallCountRateMin`、`monthMallCountRateMin` | `dayMallCountRateMax`、`weekMallCountRateMax`、`monthMallCountRateMax` |\n\n增长率的查询和响应均使用小数；例如用户要求增长率至少 20%，请求值使用 `0.2`。商品数和店铺数的周期值是变化量，可能为负数。平均价格和所有销售额使用当前查询站点币种。\n\n## 排序字段\n\n| 维度 | `sort` 可选值 |\n| --- | --- |\n| 蓝海指数 | `dsr` |\n| 总销量/平均价格/总销售额 | `totalSold`、`avgPrice`、`totalSales` |\n| 总商品数/半托管商品数 | `itemCount`、`semiManagedItemCount` |\n| 总店铺数/半托管店铺数 | `mallCount`、`semiManagedMallCount` |\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| 日/周/月店铺数变化量 | `dayMallCount`、`weekMallCount`、`monthMallCount` |\n| 日/周/月店铺数增长率 | `dayMallCountRate`、`weekMallCountRate`、`monthMallCountRate` |\n| 类目层级 | `catLevel` |\n| 数据创建/更新时间 | `createTime`、`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` 是当前条件下的命中总数，`data.list` 是当前页类目列表。\n- 基础字段包括站点 ID、类目 ID、类目名称、缩略图、层级、父类目 ID、是否叶子类目、Temu 前台 ID 和数据时间。\n- `parentCatItems` 是从一级类目到当前类目的完整路径，用它确认类目归属。\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- 预设只定义排序，不表示命中类目必然值得进入；取得数据后仍需结合需求规模、近期增长、商品供给、店铺供给和价格带验证。\n\n以下参数块省略站点、分页及所有未设置条件。\n\n## 查询预设\n\n### 热销类目\n\n适用于“热销类目”“哪些品类销量最高”“头部市场”等请求。\n\n```text\nsort=totalSold\norder=desc\n```\n\n该预设只按总销量从高到低排序，不自动补充类目层级、最低销量或时间窗口。用于选品时优先对比一级或二级类目，避免样本过细。\n\n### 蓝海类目\n\n适用于“蓝海类目”“供需关系更好的品类”“哪些市场竞争相对小”等请求。\n\n```text\nsort=dsr\norder=desc\n```\n\n该预设只按蓝海指数从高到低排序。蓝海指数不能单独证明市场值得进入；对排名靠前的类目，至少检查总销量、月销量与增长率、商品数、店铺数和平均价格。\n\n## 补充调研方法\n\n下列方法用于按用户问题补充分析：\n\n- 找近期需求增长：按月销量增长率或月销售额增长率降序，并设置最低月销量或月销售额，避免小基数极端增长。\n- 找需求增长快于供给的类目：先筛选月销量增长率为正，再对比月商品数和月店铺数增长率；这一判断需在返回数据后计算，不是单一接口条件。\n- 找半托管渗透类目：结合半托管商品数/总商品数和半托管店铺数/总店铺数计算占比；任一分母为零或缺失时不计算。\n\n## 生成请求前检查\n\n1. 是否只选择了一个主预设。\n2. 美国站是否使用默认值，其他站点是否已实时解析。\n3. 是否无依据叠加了类目层级、销量阈值或增长率条件。\n4. 作为后续市场筛选条件时，是否优先使用一级或二级类目 ID。\n5. 排序方向是否只使用 `asc` 或 `desc`。\n6. 查询条件是否全部存在于类目搜索契约中。\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 GeekBI's live Temu category data to return verified category IDs and paths, filter by site, hierarchy, demand, supply, blue-ocean, sales, revenue, semi-managed, and growth metrics, and produce Chinese category opportunity analysis.\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 analysts use this skill to identify trusted Temu category IDs, category paths, market scale, demand trends, supply pressure, and category-level opportunities from GeekBI data. It is intended for category research and follow-up validation, not as standalone proof of single-product opportunity.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill stores reusable GeekBI login tokens in local GeekBI auth state files.\n\nMitigation: Run in an isolated workspace when appropriate and remove .geekbi/agent-auth.json copies after use, following the server security guidance.\n\nRisk: Network and result-link destinations are not fully constrained beyond the GeekBI flow.\n\nMitigation: Avoid custom --base-url values and review vendor-provided result links before opening or sharing them.\n\nRisk: Category-level market data can be mistaken for proof of a specific product or store opportunity.\n\nMitigation: Use the skill's own output boundary: disclose sample size, pagination, update time, and require follow-up validation before business decisions.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/geekbi/skills/geekbi-temu-category-search-skill)\n- [Server-resolved GitHub provenance](https://github.com/geekbi/geekbi-temu-category-search-skill)\n- [GeekBI OpenAPI host](https://openapi.geekbi.com)\n- [Temu 类目搜索](references/Temu类目搜索.md)\n- [Temu 类目搜索接口](references/Temu类目搜索接口.md)\n- [Temu 类目榜单查询预设](references/Temu类目榜单预设.md)\n- [查询暂停与恢复流程](references/查询暂停与恢复流程.md)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, Shell commands, Configuration, Guidance]\n\n**Output Format:** [Chinese Markdown with linked category names and optional JSON from helper scripts]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Results depend on authenticated GeekBI data; incomplete pagination, missing values, and category-level-only evidence must be disclosed.]\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: \"极鲸云 Temu 类目搜索\"\n  short_description: \"搜索和分析 Temu 类目，判断市场规模、供需与品类机会\"\n  default_prompt: \"使用 $geekbi-temu-category-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:28.344Z | auto - 首次发布：实现通过极鲸云实时搜索和分析 Temu 类目，返回可信类目 ID 和完整路径。 - 支持按站点、名称、层级、父类目及多项业务指标筛选与排序。 - 按请求自动复用已有极鲸云登录状态，无需重复登录。 - 严格遵循官方接口及文档，保障返回类目数据真实可靠。 - 处理榜单类请求时自动选用最合适的预设，输出中文业务结论与可点击类目链接。 Archive index: Archive v0.1.0: 17 files, 24107 bytes Files: .gitignore (28b), agents (0b), ag","codeSnippets":[],"executableExamples":[{"language":"text","snippet":"安装这个Skill: https://github.com/geekbi/geekbi-temu-category-search-skill"},{"language":"text","snippet":"帮我查Temu美国站 pet supplies 对应的可信类目 ID、层级和完整路径。"},{"language":"text","snippet":"列出Temu美国站总销量最高的二级类目，并比较市场规模、平均价格和竞争供给。"},{"language":"text","snippet":"查找Temu美国站月销量增长快于商品数和店铺数增长的二级类目，筛选值得继续调研的方向。"},{"language":"text","snippet":"分析Temu美国站蓝海指数较高的类目，结合销量、销售额、商品数和店铺数说明机会与风险。"},{"language":"bash","snippet":"python3 scripts/temu_category_search.py \\\n  --param \"keyword=clothing\" \\\n  --param \"siteId=48\" \\\n  --param \"catLevel=2\" \\\n  --param \"size=20\" \\\n  --param \"sort=totalSold\" \\\n  --param \"order=desc\""}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: \"geekbi-temu-category-search-skill\"\ndescription: \"通过极鲸云实时搜索和分析 Temu 类目，返回可信类目 ID 和完整路径，支持按站点、名称、层级、父类目、蓝海指数、销量、销售额、商品数、店铺数、半托管供给和增长指标筛选及排序。用户提到 Temu 类目搜索、类目 ID、类目路径、热销类目、蓝海类目、品类规模、类目趋势、供需竞争或类目机会时使用。\"\n---\n\n# 极鲸云 Temu 类目搜索\n\n仅使用极鲸云实时返回的数据搜索和分析 Temu 类目。独立返回经类目路径和层级验证的可信 ID，不根据名称猜测类目 ID，不编造类目、指标、链接或市场结论。\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. 用户请求热销类目、蓝海类目或类目机会榜单时，再读取 [Temu 类目榜单查询预设](references/Temu类目榜单预设.md)，每次只采用一个最符合意图的主预设。\n5. 从本 Skill 根目录运行 `python3 scripts/temu_category_search.py --param \"名称=值\"`。需要多个条件时重复传入 `--param`。\n6. 用返回的完整类目路径、层级和父类目核验 `catId`。名称相近或路径不唯一时列出候选并请用户确认，不自行选择。\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- 执行任何类目搜索、类目 ID 查询或类目分析时，读取 `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 类目数据，帮助国内跨境卖家查询可信类目 ID、层级和完整路径，并分析类目市场规模、需求趋势、商品与店铺供给、价格和半托管渗透，为品类研究和赛道判断提供依据。本 Skill 提供类目级市场判断，类目数据不能直接证明具体单品机会。\n\n## 主要能力\n\n| 能力 | 可以解决的问题 |\n| --- | --- |\n| Temu 类目搜索 | 按中文或英文名称、层级和父类目查找类目，并用完整路径核验可信类目 ID |\n| 类目市场规模 | 结合总销量、总销售额、近期销量与销售额，判断品类需求规模和市场体量 |\n| 供需竞争分析 | 对比需求增长与商品数、店铺数及其变化，识别供给拥挤度和竞争压力 |\n| 类目趋势研究 | 结合日、周、月销量和销售额增长率，识别近期增长、回落和异常波动 |\n| 蓝海与经营模式 | 综合蓝海指数、价格、商品与店铺供给及半托管占比，筛选值得进一步验证的类目 |\n\n## 适用场景\n\n本项目适合以下任务：\n\n- 查询 Temu 类目 ID、类目层级和完整归属路径。\n- 搜索一级、二级或指定父类目下的直接子类目。\n- 研究类目销量、销售额、商品数和店铺数等市场规模。\n- 查找热销类目、蓝海类目和近期增长类目。\n- 对比需求增长与商品、店铺供给增长，判断供需竞争。\n- 分析类目平均价格和半托管商品、店铺渗透情况。\n- 为后续品类调研确定可信的类目范围和筛选条件。\n\n## 安装 / 更新\n\n请直接将下面这段话发送给支持 Skill 的 AI 助手，即可完成安装或更新到最新版本：\n\n```text\n安装这个Skill: https://github.com/geekbi/geekbi-temu-category-search-skill\n```\n\n## 开始使用\n\n安装后直接用中文描述目标即可，例如：\n\n```text\n帮我查Temu美国站 pet supplies 对应的可信类目 ID、层级和完整路径。\n```\n\n```text\n列出Temu美国站总销量最高的二级类目，并比较市场规模、平均价格和竞争供给。\n```\n\n```text\n查找Temu美国站月销量增长快于商品数和店铺数增长的二级类目，筛选值得继续调研的方向。\n```\n\n```text\n分析Temu美国站蓝海指数较高的类目，结合销量、销售额、商品数和店铺数说明机会与风险。\n```"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn7aztmefa4fv3mdrqs9vagx7h8c14z2\",\n  \"slug\": \"geekbi-temu-category-search-skill\",\n  \"version\": \"0.1.0\",\n  \"publishedAt\": 1786519888344\n}"},{"path":"references/Temu类目搜索.md","content":"# Temu 类目搜索\n\n## 工作原则\n\n- 只使用极鲸云返回的真实类目数据，不编造类目、ID、指标或查询结果。\n- 明确区分数据事实、可复算的派生指标和分析判断。\n- 默认使用简体中文，日期使用绝对日期；平均价格和销售额标明当前 Temu 站点币种。\n- 对缺失值、异常值、样本量和未完成分页作显式说明；指标为 `0` 时也要结合其他指标和更新时间核验，不自动当成真实为零。\n- 接口参数、响应字段、请求命令和原始 JSON 仅用于内部调用。进度说明、分析过程和最终答复使用中文业务名称，不展示英文参数；只有用户明确要求开发对接或故障排查时才展示必要技术信息。\n\n## 执行流程\n\n1. 明确用户是要找可信类目 ID、查热销/蓝海类目、研究市场规模，还是为后续数据查询确定类目条件。\n2. 明确站点、类目关键词、层级、父类目、需求规模和供给规模等必要条件。未指定站点时默认美国站，并在结果口径中说明。\n3. 读取 [Temu 类目搜索接口](Temu类目搜索接口.md)，生成最小必要查询条件。用户要求热销类目或蓝海类目时，再读取 [Temu 类目榜单查询预设](Temu类目榜单预设.md)。\n4. 未指定站点或明确要求美国站时直接使用默认值；只有用户指定其他国家或地区时，才运行 `scripts/temu_site_list.py` 实时解析站点。\n5. 使用 `scripts/temu_category_search.py` 查询；服务端要求暂停查询时，按 [查询暂停与恢复流程](查询暂停与恢复流程.md) 提示并暂停。\n6. 恢复条件满足后原样重跑查询，取得类目数据后再分析。\n7. 查询失败时，只向用户提示错误输出一级 `msg` 的中文文案，不展示错误 JSON、状态码、异常栈或内部字段。\n8. 核对分页范围、样本量、关键指标和更新时间后再分析；未读取全部分页时明确标为样本。\n\n## 查询策略\n\n- 类目名称使用内置模糊搜索；用户提供明确行业或品类名称时优先使用关键词。\n- 优先查询一级或二级类目。用户未要求精细下钻时，不主动限制三级、四级类目；过细类目容易导致市场样本过少。\n- 已知父类目 ID 时，可查其直接子类目。搜索结果返回从一级类目到当前类目的完整路径，用路径和层级验证 ID，不根据名称猜测 ID。\n- 返回的 `catId` 属于 Temu 通用类目 ID 体系。必须结合完整类目路径、层级和父类目验证 ID；名称相近时列出候选并请用户确认，不根据名称猜测。\n- 搜索特定类目名称时，不为了“更准”无条件叠加父类目和层级；只在用户已明确市场边界或需要下钻时组合，并注意条件过多会减少结果。\n- 未指定排序时按问题选择一个主指标：热销优先总销量，蓝海优先蓝海指数，近期增长优先月销量增长率或月销售额增长率。\n- 服务端为每个类目返回 `linkUrl`，指向该类目在极鲸云的 Temu 类目详情页。每个被展示的类目都必须把类目名称或完整类目路径写成 `[类目名称或完整类目路径](<linkUrl>)`；这条规则适用于表格、列表、排名、候选清单和正文，不因用户未主动要求链接或要求简洁结果而省略。\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. 候选类目：展示中文类目路径、类目 ID、核心指标和入选原因。\n4. 机会与竞争判断：区分事实、计算和判断。\n5. 风险、数据限制和下一步验证动作。\n\n用户只要类目 ID 或简单搜索结果时保持简洁，不强行扩展为完整市场报告。"},{"path":"references/Temu类目搜索接口.md","content":"# Temu 类目搜索接口\n\n## 目录\n\n- [脚本调用](#脚本调用)\n- [基础参数](#基础参数)\n- [站点与类目 ID](#站点与类目-id)\n- [区间筛选参数](#区间筛选参数)\n- [排序字段](#排序字段)\n- [响应与失败处理](#成功响应)\n\n## 脚本调用\n\n单页数量最大为 200。\n\n通过以下命令调用：\n\n```bash\npython3 scripts/temu_category_search.py \\\n  --param \"keyword=clothing\" \\\n  --param \"siteId=48\" \\\n  --param \"catLevel=2\" \\\n  --param \"size=20\" \\\n  --param \"sort=totalSold\" \\\n  --param \"order=desc\"\n```\n\n服务端要求暂停查询时，按 [查询暂停与恢复流程](查询暂停与恢复流程.md) 提示用户；恢复条件满足后再次运行同一命令。\n\n## 基础参数\n\n| 参数 | 类型 | 默认值 | 说明 |\n| --- | --- | --- | --- |\n| `keyword` | string | 无 | 类目中文或英文名称，最长 300 个字符，使用内置模糊搜索 |\n| `siteId` | integer | `48` | 极鲸云站点 ID；美国站直接使用默认值，其他国家或地区先实时解析站点 |\n| `catLevel` | integer | 无 | 类目层级：1、2、3 或 4；作为通用市场筛选条件时优先 1 或 2 |\n| `parentCatId` | integer | 无 | 父类目 ID，只返回该父类目的直接子类目；`0` 代表根层 |\n| `page` | integer | `1` | 页码，从 1 开始 |\n| `size` | integer | `20` | 每页数量，最大 200 |\n| `sort` | string | 无 | 排序字段，取值见下方 |\n| `order` | string | `desc` | `asc` 或 `desc` |\n\n## 站点与类目 ID\n\n- 未指定站点或指定美国站时，直接使用美国站 ID `48`，不额外查询站点列表。\n- 用户指定其他国家或地区时，运行 `python3 scripts/temu_site_list.py --country \"国家或地区名\"`，只使用唯一精确匹配的站点 ID。\n- 不使用本地静态站点表，不按语言、币种或相似名称猜测。无匹配或多个匹配时请用户确认。\n- 响应中的 `catId` 属于 Temu 通用类目 ID 体系，可作为后续支持类目筛选的请求条件；用于广泛市场筛选时优先使用一级或二级类目。\n\n## 区间筛选参数\n\n每项均支持 `Min` 和 `Max` 后缀：\n\n| 维度 | 最小值 | 最大值 |\n| --- | --- | --- |\n| 蓝海指数 | `dsrMin` | `dsrMax` |\n| 总销量 | `totalSoldMin` | `totalSoldMax` |\n| 平均价格 | `avgPriceMin` | `avgPriceMax` |\n| 总销售额 | `totalSalesMin` | `totalSalesMax` |\n| 总商品数 | `itemCountMin` | `itemCountMax` |\n| 半托管商品数 | `semiManagedItemCountMin` | `semiManagedItemCountMax` |\n| 总店铺数 | `mallCountMin` | `mallCountMax` |\n| 半托管店铺数 | `semiManagedMallCountMin` | `semiManagedMallCountMax` |\n| 日/周/月销量 | `daySoldMin`、`weekSoldMin`、`monthSoldMin` | `daySoldMax`、`weekSoldMax`、`monthSoldMax` |\n| 日/周/月销量增长率 | `daySoldRateMin`、`weekSoldRateMin`、`monthSoldRateMin` | `daySoldRateMax`、`weekSoldRateMax`、`monthSoldRateMax` |\n| 日/周/月销售额 | `daySalesMin`、`weekSalesMin`、`monthSalesMin` | `daySalesMax`、`weekSalesMax`、`monthSalesMax` |\n| 日/周/月销售额增长率 | `daySalesRateMin`、`weekSalesRateMin`、`monthSalesRateMin` | `daySalesRateMax`、`weekSalesRateMax`、`monthSalesRateMax` |\n| 日/周/月商品数变化量 | `dayItemCountMin`、`weekItemCountMin`、`monthItemCountMin` | `dayItemCountMax`、`weekItemCountMax`、`monthItemCountMax` |\n| 日/周/月商品数增长率 | `dayItemCountRateMin`、`weekItemCountRateMin`、`monthItemCountRateMin` | `dayItemCountRateMax`、`weekItemCountRateMax`、`monthItemCountRateMax` |\n| 日/周/月店铺数变化量 | `dayMallCountMin`、`weekMallCountMin`、`monthMallCountMin` | `dayMallCountMax`、`weekMallCountMax`、`monthMallCountMax` |\n| 日/周/月店铺数增长率 | `dayMallCountRateMin`、`weekMallCountRateMin`、`monthMallCountRateMin` | `dayMallCountRateMax`、`weekMallCountRateMax`、`monthMallCountRateMax` |\n\n增长率的查询和响应均使用小数；例如用户要求增长率至少 20%，请求值使用 `0.2`。商品数和店铺数的周期值是变化量，可能为负数。平均价格和所有销售额使用当前查询站点币种。\n\n## 排序字段\n\n| 维度 | `sort` 可选值 |\n| --- | --- |\n| 蓝海指数 | `dsr` |\n| 总销量/平均价格/总销售额 | `totalSold`、`avgPrice`、`totalSales` |\n| 总商品数/半托管商品数 | `itemCount`、`semiManagedItemCount` |\n| 总店铺数/半托管店铺数 | `mallCount`、`semiManagedMallCount` |\n|"}],"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:28.344Z | auto - 首次发布：实现通过极鲸云实时搜索和分析 Temu 类目，返回可信类目 ID 和完整路径。 - 支持按站点、名称、层级、父类目及多项业务指标筛选与排序。 - 按请求自动复用已有极鲸云登录状态，无需重复登录。 - 严格遵循官方接口及文档，保障返回类目数据真实可靠。 - 处理榜单类请求时自动选用最合适的预设，输出中文业务结论与可点击类目链接。 Archive index: Archive v0.1.0: 17 files, 24107 bytes Files: .gitignore (28b), agents (0b), ag","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":566,"uniquenessScore":68,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-10T03:29:12.991Z","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:29:12.991Z","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-10T06:57:45.223Z","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"}]}}}