{"id":"f0805fd6-159b-4e2a-8bc4-e66e5e76dfb3","entityType":"agent","slug":"clawhub-geekbi-geekbi-temu-keyword-search-skill","name":"极鲸云 Temu 关键词搜索","canonicalUrl":"https://www.xpersona.co/agent/clawhub-geekbi-geekbi-temu-keyword-search-skill","canonicalPath":"/agent/clawhub-geekbi-geekbi-temu-keyword-search-skill","generatedAt":"2026-10-10T09:50:39.118Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-10T02:49:22.144Z","emptyReason":null},"description":"搜索和分析 Temu 关键词，洞察需求趋势、供给和竞争 Skill: 极鲸云 Temu 关键词搜索 Owner: geekbi Summary: 搜索和分析 Temu 关键词，洞察需求趋势、供给和竞争 Tags: latest:0.1.0 Version history: v0.1.0 | 2026-08-12T07:31:19.677Z | auto geekbi-temu-keyword-search-skill 0.1.0 – Initial Release - Provides Temu keyword search and analysis based on authentic GeekBI data. - Supports searching for specific keywords, hot keywords, blue ocean keywords, new keywords, and market opportunity analysis. - Ensures s","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.8K downloads reported by the source. Last updated 10/10/2026.","installCommand":"clawhub skill install s174eqt3xz844hgj4g79d0an318c07m7:geekbi-temu-keyword-search-skill","sourceUrl":"https://clawhub.ai/geekbi/geekbi-temu-keyword-search-skill","homepage":"https://clawhub.ai/geekbi/skills/geekbi-temu-keyword-search-skill","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/geekbi/geekbi-temu-keyword-search-skill","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/geekbi/skills/geekbi-temu-keyword-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-10T02:49:22.144Z","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-10T02:49:22.144Z","emptyReason":null},"stars":null,"forks":null,"downloads":1757,"packageName":null,"latestVersion":"0.1.0","tractionLabel":"1.8K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T02:49:22.144Z","emptyReason":null},"lastUpdatedAt":"2026-10-10T02:49:22.144Z","lastCrawledAt":"2026-10-10T02:49:22.144Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-11T02:49:22.144Z","lastVerifiedAt":null,"highlights":[{"version":"0.1.0","createdAt":"2026-08-12T07:31:19.677Z","changelog":"geekbi-temu-keyword-search-skill 0.1.0 – Initial Release - Provides Temu keyword search and analysis based on authentic GeekBI data. - Supports searching for specific keywords, hot keywords, blue ocean keywords, new keywords, and market opportunity analysis. - Ensures strict use of site IDs, category IDs, and accurate filters; does not infer category IDs from names. - Always clarifies sample size, missing/zero values, and data update time in results. - Results include both a concise conclusion and supporting data, with all clickable keywords formatted as required. - Fully reuses GeekBI Temu Skills login state and handles query pauses per standard workflow.","fileCount":17,"zipByteSize":24694}]},"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-keyword-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-keyword-search-skill/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-geekbi-geekbi-temu-keyword-search-skill/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-geekbi-geekbi-temu-keyword-search-skill/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-geekbi-geekbi-temu-keyword-search-skill/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-geekbi-geekbi-temu-keyword-search-skill/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-geekbi-geekbi-temu-keyword-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-10T09:50:39.117Z"}},"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-keyword-search-skill/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-geekbi-geekbi-temu-keyword-search-skill/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-geekbi-geekbi-temu-keyword-search-skill/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-geekbi-geekbi-temu-keyword-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-10T02:49:22.144Z","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:19.677Z | auto\n\ngeekbi-temu-keyword-search-skill 0.1.0 – Initial Release\n\n- Provides Temu keyword search and analysis based on authentic GeekBI data.\n- Supports searching for specific keywords, hot keywords, blue ocean keywords, new keywords, and market opportunity analysis.\n- Ensures strict use of site IDs, category IDs, and accurate filters; does not infer category IDs from names.\n- Always clarifies sample size, missing/zero values, and data update time in results.\n- Results include both a concise conclusion and supporting data, with all clickable keywords formatted as required.\n- Fully reuses GeekBI Temu Skills login state and handles query pauses per standard workflow.\n\nArchive index:\n\nArchive v0.1.0: 17 files, 24694 bytes\n\nFiles: .gitignore (28b), agents (0b), agents/openai.yaml (254b), README.md (2547b), references (0b), references/Temu关键词搜索.md (5485b), references/Temu关键词搜索接口.md (6965b), references/Temu关键词榜单预设.md (2898b), references/查询暂停与恢复流程.md (1988b), requirements.txt (23b), scripts (0b), scripts/geekbi_auth.py (23978b), scripts/temu_keyword_search.py (6006b), scripts/temu_site_list.py (3482b), skill-card.md (2510b), SKILL.md (4042b), _meta.json (151b)\n\nFile v0.1.0:SKILL.md\n\n---\nname: geekbi-temu-keyword-search-skill\ndescription: 使用极鲸云查询和分析 Temu 关键词数据。用户需要搜索 Temu 关键词、查特定词、找热销词、蓝海词或新词，分析搜索需求、销量与销售额趋势、商品和店铺供给、竞争强度、平均价格、市场时间、类目归属或关键词机会时使用。仅依据极鲸云真实返回的数据形成结论。\n---\n\n# 极鲸云 Temu 关键词搜索\n\n## 工作原则\n\n- 只使用极鲸云返回的真实关键词数据，区分接口事实、可复算指标和分析判断。\n- 默认使用简体中文和绝对日期，保留站点、筛选条件、排序、分页范围、样本量和更新时间。\n- 将数值 `0`、缺失值、异常值和未完成分页显式标注，不把局部样本描述为全量市场。\n- 复用 GeekBI Temu Skills 的共享登录态。任一 Skill 已完成登录时直接查询，不主动重复登录；脚本要求暂停时按 [查询暂停与恢复流程](references/查询暂停与恢复流程.md) 处理。\n- 仅在用户明确要求开发对接、故障排查或原始响应时展示英文参数、响应字段、命令或原始 JSON。\n\n## 执行流程\n\n1. 明确用户要查特定关键词、热销词、蓝海词、新词还是关键词市场机会，并确认站点、时间口径和硬性条件。未指定站点时使用美国站 `48`，并在结果中说明。\n2. 读取 [Temu 关键词搜索](references/Temu关键词搜索.md) 和 [Temu 关键词搜索接口](references/Temu关键词搜索接口.md)。仅在用户表达榜单意图时再读取 [Temu 关键词榜单预设](references/Temu关键词榜单预设.md)。\n3. 只使用用户提供或当前上下文中已有可靠来源的类目 ID，不根据类目名称猜测。没有可信类目 ID 但用户给出关键词时，直接按原关键词查询；只有必须严格限定类目且缺少 ID 时，才请用户提供类目 ID。\n4. 未指定站点或指定美国站时直接使用 `siteId=48`。用户指定其他国家或地区时，运行 `python3 scripts/temu_site_list.py --country \"国家或地区\"`，只采用唯一精确匹配；无唯一匹配时请用户确认。\n5. 生成最小必要条件并运行 `scripts/temu_keyword_search.py`。不要无依据叠加阈值、时间范围或多个榜单预设。\n6. 脚本要求暂停时展示服务端一级中文提示和有效跳转链接，停止分析；用户完成操作或回复“继续”后原样重跑。\n7. 检查响应、分页、样本量、缺失值、异常值、币种和更新时间。请求全量时逐页读取至覆盖命中总数；未完成时明确标为样本。\n8. 根据需求规模、增长趋势、商品与店铺供给、蓝海指数、平均价格和市场时间形成结论，不用单一指标直接给出进入建议。\n\n## 查询边界\n\n- 查特定词时优先传入用户原始关键词，不自行翻译后替换。\n- 只有已有可信类目 ID 时才使用 `catIds`；类目 ID 可重复传入。没有可信 ID 时保留关键词查询，不猜测或拼接类目 ID。\n- 关键词与类目通常只选一个主筛选条件；仅在用户明确要求交叉限定时组合，并说明结果可能减少。\n- 增长率请求值使用小数，例如 20% 传入 `0.2`；市场时间使用 ISO 8601 日期时间。\n- 蓝海指数只作为供需综合信号，必须与需求规模、近期增长、商品数、店铺数和数据时间交叉判断。\n\n## 输出要求\n\n- 先给一句话结论，再给数据口径、关键关键词、需求与竞争判断、风险和后续验证动作。\n- 简单搜索只返回必要结果，不强行扩展为完整报告。\n- 平均价格和销售额使用当前 Temu 站点币种；币种不明确时不要自行假定。\n- 对每个非空 `linkUrl`，每次展示该关键词时都将名称写成 `[关键词](<linkUrl>)`。不要添加裸链接列、改写链接或用“查看详情”替代名称。\n- 发送答复前检查：非空 `linkUrl` 的关键词数量必须与可点击关键词名称数量一致。\n\nFile v0.1.0:README.md\n\n# 极鲸云 Temu 关键词搜索 Skill\n\n通过极鲸云提供的真实 Temu 关键词数据，查询特定关键词、热销词、蓝海词和新词，分析关键词对应的需求规模、销量与销售额趋势、商品和店铺供给、竞争强度、平均价格与市场阶段，帮助国内跨境卖家识别值得关注的市场需求和关键词方向。\n\n## 主要能力\n\n| 能力 | 可以解决的问题 |\n| --- | --- |\n| Temu 关键词搜索 | 查询特定关键词及其关联类目、需求规模、平均价格、商品数、店铺数和市场时间，快速了解关键词对应的市场概况 |\n| 热销词与趋势词发现 | 按总销量、近期销量或销售额增长筛选关键词，识别需求规模较大或近期增长较快的市场方向 |\n| 蓝海词与新词研究 | 结合蓝海指数、需求规模、供给数量、增长趋势和市场时间，发现值得继续验证的关键词信号 |\n| 供需与竞争分析 | 对比销量、销售额、商品数和店铺数及其变化，判断关键词需求增长是否快于供给增长 |\n| 价格与市场阶段分析 | 结合平均价格、最早商品上架时间、关联类目和半托管渗透情况，判断关键词所处的价格与市场阶段 |\n\n## 适用场景\n\n本项目适合以下任务：\n\n- 查询某个 Temu 关键词的需求规模、平均价格和竞争情况。\n- 查找 Temu 热销词、蓝海词、新词和近期增长词。\n- 分析关键词日、周、月销量及销售额趋势。\n- 对比关键词下的商品供给、店铺供给及其变化。\n- 研究某个类目范围内的关键词需求和市场结构。\n- 判断关键词对应市场处于新兴、增长、成熟还是短期波动阶段。\n- 为市场定位、关键词布局和后续调研筛选优先方向。\n\n## 安装 / 更新\n\n请直接将下面这段话发送给支持 Skill 的 AI 助手，即可完成安装或更新到最新版本：\n\n```text\n安装这个Skill: https://github.com/geekbi/geekbi-temu-keyword-search-skill\n```\n\n## 开始使用\n\n安装后直接用中文描述目标即可，例如：\n\n```text\n分析 Temu 美国站关键词 wireless charger 的需求规模、近期趋势和供给竞争。\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-keyword-search-skill\",\n  \"version\": \"0.1.0\",\n  \"publishedAt\": 1786519879677\n}\n\nFile v0.1.0:references/Temu关键词搜索.md\n\n# Temu 关键词搜索\n\n## 工作原则\n\n- 只使用极鲸云返回的真实关键词数据，不编造关键词、翻译、指标或查询结果。\n- 明确区分数据事实、可复算的派生指标和分析判断。\n- 默认使用简体中文，日期使用绝对日期；平均价格和销售额标明当前 Temu 站点币种。\n- 对缺失值、异常值、样本量和未完成分页作显式说明；指标为 `0` 时结合其他指标和更新时间核验，不自动当成真实为零。\n- 接口参数、响应字段、请求命令和原始 JSON 仅用于内部调用。进度说明、分析过程和最终答复使用中文业务名称，不展示英文参数；只有用户明确要求开发对接或故障排查时才展示必要技术信息。\n\n## 执行流程\n\n1. 明确用户是查特定关键词、找热销/蓝海/新词、从品类中找词，还是研究关键词市场机会。\n2. 明确站点、关键词或类目范围、市场时间、需求规模和供给规模等必要条件。未指定站点时默认美国站，并在结果口径中说明。\n3. 读取 [Temu 关键词搜索接口](Temu关键词搜索接口.md)，生成最小必要查询条件。用户要求热销词、蓝海词或最近新词时，再读取 [Temu 关键词榜单预设](Temu关键词榜单预设.md)。\n4. 未指定站点或明确要求美国站时直接使用默认值；只有用户指定其他国家或地区时，才运行 `scripts/temu_site_list.py` 实时解析站点。\n5. 使用 `scripts/temu_keyword_search.py` 查询；服务端要求暂停查询时，按 [查询暂停与恢复流程](查询暂停与恢复流程.md) 提示并暂停。\n6. 恢复条件满足后原样重跑查询，取得关键词数据后再分析。\n7. 查询失败时，只向用户提示错误输出一级 `msg` 的中文文案，不展示错误 JSON、状态码、异常栈或内部字段。\n8. 核对分页范围、样本量、关键指标和更新时间后再分析；未读取全部分页时明确标为样本。\n\n## 查询策略\n\n- 关键词条件同时匹配英文关键词和中文关键词。查特定词时优先使用关键词，不自行翻译后替换用户输入。\n- 仅使用用户提供或当前上下文中已有可靠来源的一级或二级类目 ID，不根据类目名称猜测 ID。没有可信类目 ID 但已有关键词时，直接按用户原始关键词查询；必须严格限定类目时请用户提供类目 ID。\n- 查特定词时一般使用关键词条件；做品类词机会挖掘时一般使用类目条件。只有用户明确要在某品类内查特定词时才组合，并说明组合条件可能减少结果。\n- “市场年龄”使用该关键词下最早商品上架时间作为代理指标，不是关键词的创建时间。日期越新，表示该词对应市场可能更新。\n- 未指定排序时按问题选择一个主指标：热销优先总销量，蓝海优先蓝海指数，新词优先最早商品上架时间，近期增长优先月销量增长率或月销售额增长率。\n- 服务端为每个关键词返回 `linkUrl`，指向该关键词在极鲸云的 Temu 关键词详情页。每个被展示的关键词都必须把关键词名称写成 `[关键词](<linkUrl>)`；这条规则适用于表格、列表、排名、候选清单和正文，不因用户未主动要求链接或要求简洁结果而省略。\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- [站点与类目 ID](#站点与类目-id)\n- [区间筛选参数](#区间筛选参数)\n- [排序字段](#排序字段)\n- [响应与失败处理](#成功响应)\n\n## 脚本调用\n\n单页数量最大为 200。\n\n通过以下命令调用：\n\n```bash\npython3 scripts/temu_keyword_search.py \\\n  --param \"keyword=summer dress\" \\\n  --param \"siteId=48\" \\\n  --param \"size=20\" \\\n  --param \"sort=totalSold\" \\\n  --param \"order=desc\"\n```\n\n类目 ID 可重复传入：\n\n```bash\npython3 scripts/temu_keyword_search.py \\\n  --param \"catIds=10001\" \\\n  --param \"catIds=20002\" \\\n  --param \"sort=monthSoldRate\" \\\n  --param \"order=desc\"\n```\n\n服务端要求暂停查询时，按 [查询暂停与恢复流程](查询暂停与恢复流程.md) 提示用户；恢复条件满足后再次运行同一命令。\n\n## 基础参数\n\n| 参数 | 类型 | 默认值 | 说明 |\n| --- | --- | --- | --- |\n| `keyword` | string | 无 | 同时匹配英文关键词和中文关键词，最长 300 个字符 |\n| `catIds` | integer，可重复 | 无 | Temu 类目 ID，多个值匹配其中任一类目 |\n| `siteId` | integer | `48` | 极鲸云站点 ID；美国站直接使用默认值，其他国家或地区先实时解析站点 |\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- 只传入用户提供或当前上下文中已有可靠来源的类目 ID，不根据名称猜测。没有可信类目 ID 但已有关键词时，省略 `catIds` 并直接按关键词查询；必须严格限定类目时请用户提供类目 ID。\n\n## 区间筛选参数\n\n每项均支持 `Min` 和 `Max` 后缀：\n\n| 维度 | 最小值 | 最大值 |\n| --- | --- | --- |\n| 蓝海指数 | `dsrMin` | `dsrMax` |\n| 总销量 | `totalSoldMin` | `totalSoldMax` |\n| 平均价格 | `avgPriceMin` | `avgPriceMax` |\n| 总销售额 | `totalSalesMin` | `totalSalesMax` |\n| 市场时间 | `firstOnSaleTimeMin` | `firstOnSaleTimeMax` |\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市场时间使用 ISO 8601 日期时间，它代表该关键词下最早商品的上架时间，不是关键词创建时间。增长率的查询和响应均使用小数；例如用户要求增长率至少 20%，请求值使用 `0.2`。商品数和店铺数的周期值是变化量，可能为负数。平均价格和所有销售额使用当前查询站点币种。\n\n## 排序字段\n\n| 维度 | `sort` 可选值 |\n| --- | --- |\n| 蓝海指数 | `dsr` |\n| 总销量/平均价格/总销售额 | `totalSold`、`avgPrice`、`totalSales` |\n| 市场时间 | `firstOnSaleTime` |\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| 数据创建/更新时间 | `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、英文关键词、中文关键词、缩略图、市场时间、关联类目和数据时间。\n- 市场指标包括蓝海指数、总销量、平均价格、总销售额、商品数、店铺数、半托管商品/店铺数，以及对应日/周/月指标与增长率。\n- `catItems` 是服务端根据关联类目 ID 补全的类目名称和层级，面向用户展示时优先使用它。\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```text\nsort=firstOnSaleTime\norder=desc\n```\n\n该预设按关键词下最早商品的上架时间从新到旧排序，不自动增加“近 1 个月”或“近 3 个月”的时间范围。该时间不是关键词创建时间，也不能单独证明是新趋势；还要检查月销量、月销量增长率和供给变化。\n\n## 补充调研方法\n\n- 找近期需求增长：按月销量增长率或月销售额增长率降序，并设置最低月销量或月销售额，避免小基数极端增长。\n- 找需求增长快于供给的词：先筛选月销量增长率为正，再对比月商品数和月店铺数增长率；这一判断需在返回数据后计算，不是单一接口条件。\n- 找品类词：已有可信的一级或二级类目 ID时可限定范围，再按用户的需求、增长或蓝海目标排序；没有可信 ID 时按用户原始关键词查询，不猜测类目 ID。\n\n## 生成请求前检查\n\n1. 是否只选择了一个主预设。\n2. 美国站是否使用默认值，其他站点是否已实时解析。\n3. 类目 ID 是否来自用户或当前上下文中的可靠来源，而不是根据名称猜测；没有可信 ID 时是否已省略类目条件。\n4. 是否无依据叠加了时间、销量阈值或增长率条件。\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 and analyzes Temu keyword data from GeekBI, including demand, sales and revenue trends, supply, competition, average price, market timing, category association, and keyword opportunities.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[geekbi](https://clawhub.ai/user/geekbi)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal sellers, marketplace analysts, and commerce operators use this skill to search Temu keyword opportunities and compare demand, growth, supply, competition, pricing, and market-stage signals using GeekBI data.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill saves authentication state locally.\n\nMitigation: Install only in trusted workspaces and avoid shared, synced, or version-controlled workspaces until token storage is limited to a protected user config or credential store.\n\nRisk: The skill trusts server-supplied links in keyword results.\n\nMitigation: Review generated links before acting on them and rely on the server-resolved GeekBI data source for keyword analysis.\n\nRisk: Custom base URLs can redirect requests to untrusted endpoints.\n\nMitigation: Use custom base URLs only when the endpoint is controlled and trusted.\n\n## Reference(s):\n\n- [Server-resolved GitHub provenance](https://github.com/geekbi/geekbi-temu-keyword-search-skill)\n- [ClawHub skill page](https://clawhub.ai/geekbi/skills/geekbi-temu-keyword-search-skill)\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):** [Markdown, Shell commands, API Calls, Analysis, Guidance]\n\n**Output Format:** [Markdown analysis with optional inline shell commands and linked keyword names]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Uses Simplified Chinese by default and reports site, filters, pagination scope, sample size, missing or zero values, currency, and update time when available.]\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-keyword-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:19.677Z | auto geekbi-temu-keyword-search-skill 0.1.0 – Initial Release - Provides Temu keyword search and analysis based on authentic GeekBI data. - Supports searching for specific keywords, hot keywords, blue ocean keywords, new keywords, and market opportunity analysis. - Ensures s","codeSnippets":[],"executableExamples":[{"language":"text","snippet":"安装这个Skill: https://github.com/geekbi/geekbi-temu-keyword-search-skill"},{"language":"text","snippet":"分析 Temu 美国站关键词 wireless charger 的需求规模、近期趋势和供给竞争。"},{"language":"text","snippet":"查找 Temu 美国站近期销量增长较快的关键词，并比较商品数和店铺数的变化。"},{"language":"text","snippet":"帮我找 Temu 美国站值得关注的蓝海词，结合需求规模、供给和增长情况说明理由。"},{"language":"text","snippet":"查询 Temu 美国站最近出现的新词，并判断哪些只是短期波动，哪些值得继续关注。"},{"language":"bash","snippet":"python3 scripts/temu_keyword_search.py \\\n  --param \"keyword=summer dress\" \\\n  --param \"siteId=48\" \\\n  --param \"size=20\" \\\n  --param \"sort=totalSold\" \\\n  --param \"order=desc\""}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: geekbi-temu-keyword-search-skill\ndescription: 使用极鲸云查询和分析 Temu 关键词数据。用户需要搜索 Temu 关键词、查特定词、找热销词、蓝海词或新词，分析搜索需求、销量与销售额趋势、商品和店铺供给、竞争强度、平均价格、市场时间、类目归属或关键词机会时使用。仅依据极鲸云真实返回的数据形成结论。\n---\n\n# 极鲸云 Temu 关键词搜索\n\n## 工作原则\n\n- 只使用极鲸云返回的真实关键词数据，区分接口事实、可复算指标和分析判断。\n- 默认使用简体中文和绝对日期，保留站点、筛选条件、排序、分页范围、样本量和更新时间。\n- 将数值 `0`、缺失值、异常值和未完成分页显式标注，不把局部样本描述为全量市场。\n- 复用 GeekBI Temu Skills 的共享登录态。任一 Skill 已完成登录时直接查询，不主动重复登录；脚本要求暂停时按 [查询暂停与恢复流程](references/查询暂停与恢复流程.md) 处理。\n- 仅在用户明确要求开发对接、故障排查或原始响应时展示英文参数、响应字段、命令或原始 JSON。\n\n## 执行流程\n\n1. 明确用户要查特定关键词、热销词、蓝海词、新词还是关键词市场机会，并确认站点、时间口径和硬性条件。未指定站点时使用美国站 `48`，并在结果中说明。\n2. 读取 [Temu 关键词搜索](references/Temu关键词搜索.md) 和 [Temu 关键词搜索接口](references/Temu关键词搜索接口.md)。仅在用户表达榜单意图时再读取 [Temu 关键词榜单预设](references/Temu关键词榜单预设.md)。\n3. 只使用用户提供或当前上下文中已有可靠来源的类目 ID，不根据类目名称猜测。没有可信类目 ID 但用户给出关键词时，直接按原关键词查询；只有必须严格限定类目且缺少 ID 时，才请用户提供类目 ID。\n4. 未指定站点或指定美国站时直接使用 `siteId=48`。用户指定其他国家或地区时，运行 `python3 scripts/temu_site_list.py --country \"国家或地区\"`，只采用唯一精确匹配；无唯一匹配时请用户确认。\n5. 生成最小必要条件并运行 `scripts/temu_keyword_search.py`。不要无依据叠加阈值、时间范围或多个榜单预设。\n6. 脚本要求暂停时展示服务端一级中文提示和有效跳转链接，停止分析；用户完成操作或回复“继续”后原样重跑。\n7. 检查响应、分页、样本量、缺失值、异常值、币种和更新时间。请求全量时逐页读取至覆盖命中总数；未完成时明确标为样本。\n8. 根据需求规模、增长趋势、商品与店铺供给、蓝海指数、平均价格和市场时间形成结论，不用单一指标直接给出进入建议。\n\n## 查询边界\n\n- 查特定词时优先传入用户原始关键词，不自行翻译后替换。\n- 只有已有可信类目 ID 时才使用 `catIds`；类目 ID 可重复传入。没有可信 ID 时保留关键词查询，不猜测或拼接类目 ID。\n- 关键词与类目通常只选一个主筛选条件；仅在用户明确要求交叉限定时组合，并说明结果可能减少。\n- 增长率请求值使用小数，例如 20% 传入 `0.2`；市场时间使用 ISO 8601 日期时间。\n- 蓝海指数只作为供需综合信号，必须与需求规模、近期增长、商品数、店铺数和数据时间交叉判断。\n\n## 输出要求\n\n- 先给一句话结论，再给数据口径、关键关键词、需求与竞争判断、风险和后续验证动作。\n- 简单搜索只返回必要结果，不强行扩展为完整报告。\n- 平均价格和销售额使用当前 Temu 站点币种；币种不明确时不要自行假定。\n- 对每个非空 `linkUrl`，每次展示该关键词时都将名称写成 `[关键词](<linkUrl>)`。不要添加裸链接列、改写链接或用“查看详情”替代名称。\n- 发送答复前检查：非空 `linkUrl` 的关键词数量必须与可点击关键词名称数量一致。"},{"path":"README.md","content":"# 极鲸云 Temu 关键词搜索 Skill\n\n通过极鲸云提供的真实 Temu 关键词数据，查询特定关键词、热销词、蓝海词和新词，分析关键词对应的需求规模、销量与销售额趋势、商品和店铺供给、竞争强度、平均价格与市场阶段，帮助国内跨境卖家识别值得关注的市场需求和关键词方向。\n\n## 主要能力\n\n| 能力 | 可以解决的问题 |\n| --- | --- |\n| Temu 关键词搜索 | 查询特定关键词及其关联类目、需求规模、平均价格、商品数、店铺数和市场时间，快速了解关键词对应的市场概况 |\n| 热销词与趋势词发现 | 按总销量、近期销量或销售额增长筛选关键词，识别需求规模较大或近期增长较快的市场方向 |\n| 蓝海词与新词研究 | 结合蓝海指数、需求规模、供给数量、增长趋势和市场时间，发现值得继续验证的关键词信号 |\n| 供需与竞争分析 | 对比销量、销售额、商品数和店铺数及其变化，判断关键词需求增长是否快于供给增长 |\n| 价格与市场阶段分析 | 结合平均价格、最早商品上架时间、关联类目和半托管渗透情况，判断关键词所处的价格与市场阶段 |\n\n## 适用场景\n\n本项目适合以下任务：\n\n- 查询某个 Temu 关键词的需求规模、平均价格和竞争情况。\n- 查找 Temu 热销词、蓝海词、新词和近期增长词。\n- 分析关键词日、周、月销量及销售额趋势。\n- 对比关键词下的商品供给、店铺供给及其变化。\n- 研究某个类目范围内的关键词需求和市场结构。\n- 判断关键词对应市场处于新兴、增长、成熟还是短期波动阶段。\n- 为市场定位、关键词布局和后续调研筛选优先方向。\n\n## 安装 / 更新\n\n请直接将下面这段话发送给支持 Skill 的 AI 助手，即可完成安装或更新到最新版本：\n\n```text\n安装这个Skill: https://github.com/geekbi/geekbi-temu-keyword-search-skill\n```\n\n## 开始使用\n\n安装后直接用中文描述目标即可，例如：\n\n```text\n分析 Temu 美国站关键词 wireless charger 的需求规模、近期趋势和供给竞争。\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-keyword-search-skill\",\n  \"version\": \"0.1.0\",\n  \"publishedAt\": 1786519879677\n}"},{"path":"references/Temu关键词搜索.md","content":"# Temu 关键词搜索\n\n## 工作原则\n\n- 只使用极鲸云返回的真实关键词数据，不编造关键词、翻译、指标或查询结果。\n- 明确区分数据事实、可复算的派生指标和分析判断。\n- 默认使用简体中文，日期使用绝对日期；平均价格和销售额标明当前 Temu 站点币种。\n- 对缺失值、异常值、样本量和未完成分页作显式说明；指标为 `0` 时结合其他指标和更新时间核验，不自动当成真实为零。\n- 接口参数、响应字段、请求命令和原始 JSON 仅用于内部调用。进度说明、分析过程和最终答复使用中文业务名称，不展示英文参数；只有用户明确要求开发对接或故障排查时才展示必要技术信息。\n\n## 执行流程\n\n1. 明确用户是查特定关键词、找热销/蓝海/新词、从品类中找词，还是研究关键词市场机会。\n2. 明确站点、关键词或类目范围、市场时间、需求规模和供给规模等必要条件。未指定站点时默认美国站，并在结果口径中说明。\n3. 读取 [Temu 关键词搜索接口](Temu关键词搜索接口.md)，生成最小必要查询条件。用户要求热销词、蓝海词或最近新词时，再读取 [Temu 关键词榜单预设](Temu关键词榜单预设.md)。\n4. 未指定站点或明确要求美国站时直接使用默认值；只有用户指定其他国家或地区时，才运行 `scripts/temu_site_list.py` 实时解析站点。\n5. 使用 `scripts/temu_keyword_search.py` 查询；服务端要求暂停查询时，按 [查询暂停与恢复流程](查询暂停与恢复流程.md) 提示并暂停。\n6. 恢复条件满足后原样重跑查询，取得关键词数据后再分析。\n7. 查询失败时，只向用户提示错误输出一级 `msg` 的中文文案，不展示错误 JSON、状态码、异常栈或内部字段。\n8. 核对分页范围、样本量、关键指标和更新时间后再分析；未读取全部分页时明确标为样本。\n\n## 查询策略\n\n- 关键词条件同时匹配英文关键词和中文关键词。查特定词时优先使用关键词，不自行翻译后替换用户输入。\n- 仅使用用户提供或当前上下文中已有可靠来源的一级或二级类目 ID，不根据类目名称猜测 ID。没有可信类目 ID 但已有关键词时，直接按用户原始关键词查询；必须严格限定类目时请用户提供类目 ID。\n- 查特定词时一般使用关键词条件；做品类词机会挖掘时一般使用类目条件。只有用户明确要在某品类内查特定词时才组合，并说明组合条件可能减少结果。\n- “市场年龄”使用该关键词下最早商品上架时间作为代理指标，不是关键词的创建时间。日期越新，表示该词对应市场可能更新。\n- 未指定排序时按问题选择一个主指标：热销优先总销量，蓝海优先蓝海指数，新词优先最早商品上架时间，近期增长优先月销量增长率或月销售额增长率。\n- 服务端为每个关键词返回 `linkUrl`，指向该关键词在极鲸云的 Temu 关键词详情页。每个被展示的关键词都必须把关键词名称写成 `[关键词](<linkUrl>)`；这条规则适用于表格、列表、排名、候选清单和正文，不因用户未主动要求链接或要求简洁结果而省略。\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- [站点与类目 ID](#站点与类目-id)\n- [区间筛选参数](#区间筛选参数)\n- [排序字段](#排序字段)\n- [响应与失败处理](#成功响应)\n\n## 脚本调用\n\n单页数量最大为 200。\n\n通过以下命令调用：\n\n```bash\npython3 scripts/temu_keyword_search.py \\\n  --param \"keyword=summer dress\" \\\n  --param \"siteId=48\" \\\n  --param \"size=20\" \\\n  --param \"sort=totalSold\" \\\n  --param \"order=desc\"\n```\n\n类目 ID 可重复传入：\n\n```bash\npython3 scripts/temu_keyword_search.py \\\n  --param \"catIds=10001\" \\\n  --param \"catIds=20002\" \\\n  --param \"sort=monthSoldRate\" \\\n  --param \"order=desc\"\n```\n\n服务端要求暂停查询时，按 [查询暂停与恢复流程](查询暂停与恢复流程.md) 提示用户；恢复条件满足后再次运行同一命令。\n\n## 基础参数\n\n| 参数 | 类型 | 默认值 | 说明 |\n| --- | --- | --- | --- |\n| `keyword` | string | 无 | 同时匹配英文关键词和中文关键词，最长 300 个字符 |\n| `catIds` | integer，可重复 | 无 | Temu 类目 ID，多个值匹配其中任一类目 |\n| `siteId` | integer | `48` | 极鲸云站点 ID；美国站直接使用默认值，其他国家或地区先实时解析站点 |\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- 只传入用户提供或当前上下文中已有可靠来源的类目 ID，不根据名称猜测。没有可信类目 ID 但已有关键词时，省略 `catIds` 并直接按关键词查询；必须严格限定类目时请用户提供类目 ID。\n\n## 区间筛选参数\n\n每项均支持 `Min` 和 `Max` 后缀：\n\n| 维度 | 最小值 | 最大值 |\n| --- | --- | --- |\n| 蓝海指数 | `dsrMin` | `dsrMax` |\n| 总销量 | `totalSoldMin` | `totalSoldMax` |\n| 平均价格 | `avgPriceMin` | `avgPriceMax` |\n| 总销售额 | `totalSalesMin` | `totalSalesMax` |\n| 市场时间 | `firstOnSaleTimeMin` | `firstOnSaleTimeMax` |\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市场时间使用 ISO 8601 日期时间，它代表该关键词下最早商品的上架时间，不是关键词创建时间。增长率的查询和响应均使用小数；例如用户要求增长率至少 20%，请求值使用 `0.2`。商品数和店铺数的周期值是变化量，可能为负数。平均价格和所有销售额使用当前查询站点币种。\n\n## 排序字段\n\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:19.677Z | auto geekbi-temu-keyword-search-skill 0.1.0 – Initial Release - Provides Temu keyword search and analysis based on authentic GeekBI data. - Supports searching for specific keywords, hot keywords, blue ocean keywords, new keywords, and market opportunity analysis. - Ensures s","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":646,"uniquenessScore":64,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-10T02:49:22.144Z","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-10T02:49:22.144Z","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-10T09:50:39.118Z","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"}]}}}