{"id":"30896a3d-ec44-498f-9c2b-4d49395ee249","entityType":"agent","slug":"clawhub-linkfox-ai-linkfox-temu-product-query","name":"Temu商品查询","canonicalUrl":"https://www.xpersona.co/agent/clawhub-linkfox-ai-linkfox-temu-product-query","canonicalPath":"/agent/clawhub-linkfox-ai-linkfox-temu-product-query","generatedAt":"2026-10-10T21:52:27.303Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-10T16:03:43.108Z","emptyReason":null},"description":"按多维度筛选 Temu 商品（关键词/商品 ID/店铺 ID、前后台类目、价格、评分、评论、总/周/日销量、上架时间、全托管/半托管、半托管地区、标签等）。当用户提到 Temu 商品、Temu 选品、拼多多跨境、Temu 爆款、Temu 半托管、全托管商品、Temu product query、temu items 时触发。即使用户未提及工具名，只要在 Temu 上搜商品、看销量/评分/价格或筛品，也应触发此技能。 Skill: Temu商品查询 Owner: linkfox-ai Summary: 按多维度筛选 Temu 商品（关键词/商品 ID/店铺 ID、前后台类目、价格、评分、评论、总/周/日销量、上架时间、全托管/半托管、半托管地区、标签等）。当用户提到 Temu 商品、Temu 选品、拼多多跨境、Temu 爆款、Temu 半托管、全托管商品、Temu product query、temu items 时触发。即使用户未提及工具名，只要在 Temu 上搜商品、看销量/评分/价格或筛品，也应触发此技能。 Tags: latest:1.0.9 Version history: v1.0.9 | 2026-08-14T15:18:07.419Z | user Update from 1.0.8 to 1.0.9 v1.0.8 | 2026-08-07T11:21:25.415Z | user Update from 1.0.7 to 1","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.3K downloads reported by the source. Last updated 10/10/2026.","installCommand":"clawhub skill install s171g8b6m2khwdy9ye8bxj0wx183vd4z:linkfox-temu-product-query","sourceUrl":"https://clawhub.ai/linkfox-ai/linkfox-temu-product-query","homepage":"https://clawhub.ai/linkfox-ai/skills/linkfox-temu-product-query","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/linkfox-ai/linkfox-temu-product-query","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/linkfox-ai/skills/linkfox-temu-product-query","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":63,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"按多维度筛选 Temu 商品（关键词/商品 ID/店铺 ID、前后台类目、价格、评分、评论、总/周/日销量、上架时间、全托管/半托管、半托管地区、标签等）。当用户提到 Temu 商品、Temu 选品、拼多多跨境、Temu 爆款、Temu 半托管、全托管商品、Temu product query、temu items 时"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-10T16:03:43.108Z","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-10T16:03:43.108Z","emptyReason":null},"stars":null,"forks":null,"downloads":1347,"packageName":null,"latestVersion":"1.0.9","tractionLabel":"1.3K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T16:03:43.108Z","emptyReason":null},"lastUpdatedAt":"2026-10-10T16:03:43.108Z","lastCrawledAt":"2026-10-10T16:03:43.108Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-11T16:03:43.108Z","lastVerifiedAt":null,"highlights":[{"version":"1.0.9","createdAt":"2026-08-14T15:18:07.419Z","changelog":"Update from 1.0.8 to 1.0.9","fileCount":7,"zipByteSize":19931},{"version":"1.0.8","createdAt":"2026-08-07T11:21:25.415Z","changelog":"Update from 1.0.7 to 1.0.8","fileCount":7,"zipByteSize":19953},{"version":"1.0.7","createdAt":"2026-07-13T12:40:04.113Z","changelog":"Update from 1.0.6 to 1.0.7","fileCount":5,"zipByteSize":11085},{"version":"1.0.6","createdAt":"2026-07-10T05:40:49.169Z","changelog":"Update from 1.0.5 to 1.0.6","fileCount":5,"zipByteSize":10121},{"version":"1.0.5","createdAt":"2026-07-09T05:45:17.605Z","changelog":"Update from 1.0.4 to 1.0.5","fileCount":5,"zipByteSize":10092},{"version":"1.0.4","createdAt":"2026-07-09T05:20:19.298Z","changelog":"Update from 1.0.3 to 1.0.4","fileCount":5,"zipByteSize":10496}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s171g8b6m2khwdy9ye8bxj0wx183vd4z:linkfox-temu-product-query","setupComplexity":"low","setupSteps":["Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.","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-linkfox-ai-linkfox-temu-product-query/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-temu-product-query/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-temu-product-query/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-temu-product-query/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-temu-product-query/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-temu-product-query/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-10T21:52:27.301Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-temu-product-query/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-temu-product-query/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-temu-product-query/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-temu-product-query/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-10T16:03:43.108Z","emptyReason":null},"readme":"Skill: Temu商品查询\n\nOwner: linkfox-ai\n\nSummary: 按多维度筛选 Temu 商品（关键词/商品 ID/店铺 ID、前后台类目、价格、评分、评论、总/周/日销量、上架时间、全托管/半托管、半托管地区、标签等）。当用户提到 Temu 商品、Temu 选品、拼多多跨境、Temu 爆款、Temu 半托管、全托管商品、Temu product query、temu items 时触发。即使用户未提及工具名，只要在 Temu 上搜商品、看销量/评分/价格或筛品，也应触发此技能。\n\nTags: latest:1.0.9\n\nVersion history:\n\nv1.0.9 | 2026-08-14T15:18:07.419Z | user\n\nUpdate from 1.0.8 to 1.0.9\n\nv1.0.8 | 2026-08-07T11:21:25.415Z | user\n\nUpdate from 1.0.7 to 1.0.8\n\nv1.0.7 | 2026-07-13T12:40:04.113Z | user\n\nUpdate from 1.0.6 to 1.0.7\n\nv1.0.6 | 2026-07-10T05:40:49.169Z | user\n\nUpdate from 1.0.5 to 1.0.6\n\nv1.0.5 | 2026-07-09T05:45:17.605Z | user\n\nUpdate from 1.0.4 to 1.0.5\n\nv1.0.4 | 2026-07-09T05:20:19.298Z | user\n\nUpdate from 1.0.3 to 1.0.4\n\nArchive index:\n\nArchive v1.0.9: 7 files, 19931 bytes\n\nFiles: references/api.md (5639b), references/onboarding.md (2046b), scripts/onboarding.py (24089b), scripts/temu_product_query.py (12673b), skill-card.md (2618b), SKILL.md (2402b), _meta.json (145b)\n\nFile v1.0.9:SKILL.md\n\n---\nname: linkfox-temu-product-query\ndescription: 按多维度筛选 Temu 商品（关键词/商品 ID/店铺 ID、前后台类目、价格、评分、评论、总/周/日销量、上架时间、全托管/半托管、半托管地区、标签等）。当用户提到 Temu 商品、Temu 选品、拼多多跨境、Temu 爆款、Temu 半托管、全托管商品、Temu product query、temu items 时触发。即使用户未提及工具名，只要在 Temu 上搜商品、看销量/评分/价格或筛品，也应触发此技能。\n---\n\n# Temu 商品查询\n\n## 要点\n\n- **分页**：`page` 从 1 起；`pageSize` 默认 20、最大 100（建议 ≤50）。\n- **区间入参**：`*Begin` / `*End` 成对出现（价格、评分、评论、总/周/日销量、上架时间），组成上游区间。\n- **类目**：`categoryHome` 前台类目 ID、`categoryBackend` 后台类目 ID；可先用 Temu 品类检索拿到 id。\n- **托管模式**：`isLocal`（0=全托管，1=半托管）；半托管可用 `region` 限定地区（多个逗号分隔）。\n- **上下架**：`soldOut`（0=上架，1=下架）。\n- **标签**：`tags` / `customTags` 多个用逗号分隔。\n- **排序**：`sortBy` 为「字段-方向」字符串，如 `order_week-0`（周销量降序，默认）、`price-0`、`order_total-0`、`rating-0`。\n\n## 脚本（可选）\n\n命令行调试：`python scripts/temu_product_query.py ''`（需 `LINKFOXAGENT_API_KEY`）。详见 [references/api.md](references/api.md) 末尾。\n\n## 参考\n\n入参/出参表见 [references/api.md](references/api.md)。\n\n## 解决认证和积分问题\n发生以下异常情况时，采用 references/onboarding.md 引导解决问题：\n\n### 异常情况\n- **未配置API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\n- **响应401或402状态码**\n- **响应提示积分或余额不足**：消息含\"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值\"，或类似含义的内容。\n\n## 积分消耗规则\n\n按动态规则计费：消耗积分 = 产品数量 × 1.8。按本页返回条数计费；翻到下一页，本质上是再发一次请求，再按下一页返回条数重新计算。\n\n> **重要**：本技能的服务按倍数动态计算，可能一次性消耗大量积分，必须提醒用户，由用户决定是否继续。\n\nFile v1.0.9:_meta.json\n\n{\n \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n \"slug\": \"linkfox-temu-product-query\",\n \"version\": \"1.0.9\",\n \"publishedAt\": 1786720687419\n}\n\nFile v1.0.9:references/api.md\n\n# Temu 商品查询 API 参考\n\n## 调用说明\n\n- **网关路由**：`POST ehunt/temu/productQuery`（完整：`${LINKFOX_TOOL_GATEWAY}/ehunt/temu/productQuery`）。\n- **MCP 展示名**：Temu 商品查询（确切工具名以当前环境下发的工具元数据为准）。\n- **鉴权**：请求头 `Authorization: `，api_key 从环境变量 `LINKFOX_AGENT_API_KEY` 或 `LINKFOXAGENT_API_KEY` 读取（如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理）。\n- **说明**：参数与返回结构以当前网关返回为准；若上游返回 JSON 根级 `code` 字段，成功值（`200`）以实网为准。无数据时网关可能抛错。\n\n## 请求参数（JSON）\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| searchKey | string, maxLen=500 | 否 | 关键词或商品 ID / 店铺 ID |\n| categoryHome | string | 否 | 前台类目 ID |\n| categoryBackend | string | 否 | 后台类目 ID |\n| priceBegin | number，≥0 | 否 | 价格区间起始（USD），组成上游 `price` |\n| priceEnd | number，≥0 | 否 | 价格区间结束（USD） |\n| ratingBegin | number (0~5) | 否 | 评分区间起始，组成上游 `rating` |\n| ratingEnd | number (0~5) | 否 | 评分区间结束 |\n| reviewsBegin | integer，≥0 | 否 | 评论数区间起始，组成 `reviews` |\n| reviewsEnd | integer，≥0 | 否 | 评论数区间结束 |\n| salesTotalBegin | integer，≥0 | 否 | 总销量区间起始，组成 `sales_total` |\n| salesTotalEnd | integer，≥0 | 否 | 总销量区间结束 |\n| salesWeeklyBegin | integer，≥0 | 否 | 周销量区间起始，组成 `sales_weekly` |\n| salesWeeklyEnd | integer，≥0 | 否 | 周销量区间结束 |\n| salesDailyBegin | integer，≥0 | 否 | 日销量区间起始，组成 `sales_daily` |\n| salesDailyEnd | integer，≥0 | 否 | 日销量区间结束 |\n| publishTimeBegin | string (YYYY-MM-DD) | 否 | 上架日期区间起始，组成 `publish_time` |\n| publishTimeEnd | string (YYYY-MM-DD) | 否 | 上架日期区间结束 |\n| soldOut | integer | 否 | 是否下架：0=上架，1=下架 |\n| isLocal | integer | 否 | 是否半托管：0=全托管，1=半托管 |\n| region | string | 否 | 半托管地区，多个逗号分隔 |\n| tags | string | 否 | 商品标签，多个逗号分隔 |\n| customTags | string | 否 | 自定义标签，多个逗号分隔 |\n| sortBy | string | 否 | 排序字段+方向：`order_week-0`（周销量降序，默认）、`price-0`、`order_total-0`、`rating-0` 等 |\n| page | integer，≥1，默认 1 | 否 | 页码（从 1 开始） |\n| pageSize | integer，1~100，默认 20 | 否 | 每页条数，最大 100，建议不超过 50 |\n\n## 响应主要字段\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| total | integer | 本页返回条数 |\n| productNum | integer | 符合条件的商品总数（上游 `product_num`） |\n| products | array | Temu 商品列表 |\n| columns | array | 渲染的列 |\n| title | string | 标题（`Temu 商品查询`） |\n| sourceType | string | 来源类型：temu |\n| sourceTool | string | 工具类型：ehunt |\n| type | string | 渲染的样式：tableListWorkbenches |\n\n### `products[]` 元素\n\n| 字段 | 上游别名 | 说明 |\n|------|----------|------|\n| productId | `product_id` | 商品 ID |\n| productName | `product_name` | 商品名（英文） |\n| productNameCn | `product_name_cn` | 商品名（中文） |\n| logoUrl | `logo_url` | 主图 URL |\n| price | - | 价格 |\n| orderTotal | `order_total` | 总销量 |\n| orderWeek | `order_week` | 周销量 |\n| orderDay | `order_day` | 日销量 |\n| orderMonth | `order_month` | 月销量 |\n| rating | - | 评分 |\n| reviewNum | `review_num` | 评论数 |\n| publishTime | `publish_time` | 上架时间 |\n| soldOut | `sold_out` | 是否下架 |\n| isLocal | `is_local` | 是否半托管：0=全托管，1=半托管 |\n| localRegion | `local_region` | 半托管地区列表 |\n| storeId | `store_id` | 店铺 ID |\n| tags | - | 标签列表 |\n| customTags | `custom_tags` | 自定义标签 |\n| categoryHome | `category_home` | 前台类目 |\n| categoryBackend | `category_backend` | 后台类目 |\n\n## 脚本调试（可选）\n\n仓库内提供 **`scripts/temu_product_query.py`**（Python 3，仅标准库），向 LinkFox 工具网关 POST 与 MCP 入参一致的 JSON。\n\n- **网关**：`https://tool-gateway.linkfox.com`（可用 `LINKFOX_TOOL_GATEWAY_BASE` 覆盖根 URL）\n- **默认路径段**：`ehunt/temu/productQuery`（可用 `LINKFOX_EHUNT_TEMU_PRODUCT_QUERY_PATH` 覆盖，不含域名）\n- **鉴权**：环境变量 `LINKFOXAGENT_API_KEY`（与其他 `linkfox-*` skill 相同；如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理）\n\n```bash\nexport LINKFOXAGENT_API_KEY=\"\"\npython scripts/temu_product_query.py '{\"searchKey\": \"kitchen\", \"page\": 1, \"pageSize\": 20}'\n```\n\n若返回 404，说明部署上该工具的 HTTP 路径与默认不一致，请用 `listEnabledTool` 或运维确认实际 path 后设置 `LINKFOX_EHUNT_TEMU_PRODUCT_QUERY_PATH`。\n\n## Feedback API\n\n> 与上方工具网关 API 独立，勿混用 Base URL。\n\n- **POST** `https://skill-api.linkfox.com/api/v1/public/feedback`\n- **Content-Type:** `application/json`\n\n```json\n{\n \"skillName\": \"linkfox-temu-product-query\",\n \"sentiment\": \"POSITIVE\",\n \"category\": \"OTHER\",\n \"content\": \"Results were accurate, user was satisfied.\"\n}\n```\n\n**Field rules:**\n- `skillName`: 使用本 skill YAML frontmatter 中的 `name`\n- `sentiment`: `POSITIVE` / `NEUTRAL` / `NEGATIVE`\n- `category`: `BUG` / `COMPLAINT` / `SUGGESTION` / `OTHER`\n- `content`: 简述用户意图、实际结果与问题或好评原因\n\nFile v1.0.9:references/onboarding.md\n\n# 解决认证和积分问题\n\n调用本 skill 时若网关返回 **auth** 或 **billing** 错误，走本 skill 自带的 `scripts/onboarding.py` 完成引导。\n\n**auth 场景**：`errcode=401` 或消息含 `authorized error`/`鉴权失败`/`未授权`/`unauthorized`；或 `LINKFOX_AGENT_API_KEY` 与 `LINKFOXAGENT_API_KEY` 均为空。\n1. 若已配置 key → 先让用户重启会话（最常见误判），仍失败让用户重新取 key 或换手机号重注册\n2. 未配置 → 询问：自助去 https://agent.linkfox.com/ 取 key，或提供手机号让脚本注册\n3. 手机号路径：\n - `python scripts/onboarding.py send-code ` → 展示 JSON 里的 phone/agreements\n - 收到验证码后：`python scripts/onboarding.py login `（workbuddy 宿主加 `--channel workbuddy`）\n - 拿到 `api_key` 后把下面三平台配置转发给用户，提示重启会话生效：\n - Windows PowerShell（永久）：`setx LINKFOX_AGENT_API_KEY \"\"`\n - macOS zsh：`echo 'export LINKFOX_AGENT_API_KEY=\"\"' >> ~/.zshrc && source ~/.zshrc`\n - Linux bash：`echo 'export LINKFOX_AGENT_API_KEY=\"\"' >> ~/.bashrc && source ~/.bashrc`\n - 变量名 `LINKFOX_AGENT_API_KEY`（主推）或 `LINKFOXAGENT_API_KEY`（老规范）任一即可\n\n**billing 场景**：`errcode=402` 或消息含 `积分/余额/quota/insufficient/充值/套餐到期`。\n- `python scripts/onboarding.py list-plans` → 有 AskUserQuestion 就弹菜单，否则输出编号清单让用户选\n- 校验 `plan_id` ∈ 清单、支付方式 ∈ 该套餐 `available_methods`（通常 `wechat/alipay`）\n- `python scripts/onboarding.py order ` → 展示优先级 PNG > `pay_url` > `ascii_qr`（标注兜底）\n- 已付款可选调 `python scripts/onboarding.py query `，不主动轮询\n\n排除 `errcode=403`（无权限，不归入这两类）。所有子命令输出 stdout JSON，`error` 字段已含阶段前缀，透传给用户即可。完整用法：`python scripts/onboarding.py --help`。\n\nFile v1.0.9:skill-card.md\n\n## Description:\n\nQueries Temu products through LinkFox using keyword, product or store ID, category, price, rating, review, sales, listing-date, fulfillment, region, and tag filters.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[linkfox-ai](https://clawhub.ai/user/linkfox-ai)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal sellers, ecommerce analysts, and agents use this skill to search and compare Temu products by sales, rating, price, category, fulfillment mode, and listing metadata. It also guides LinkFox authentication and billing recovery when the query service cannot be used.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill sends Temu research queries and authorization credentials to LinkFox services.\n\nMitigation: Install only when LinkFox is trusted for the intended search data and use a scoped LinkFox API key where possible.\n\nRisk: Custom LINKFOX_* endpoint overrides could redirect requests away from the expected LinkFox hosts.\n\nMitigation: Allow endpoint overrides only for trusted HTTPS LinkFox hosts and review environment variables before use.\n\nRisk: Authentication and billing recovery can involve OTPs, API keys, plan selection, and payment order details.\n\nMitigation: Keep OTPs and API keys out of shared logs, verify plans and payment methods before ordering, and rotate any key that may have been exposed.\n\nRisk: Full product-query responses may be cached or written to local linkfox session files.\n\nMitigation: Review or delete local cache and session files after sensitive searches.\n\n## Reference(s):\n\n- [Temu Product Query API Reference](references/api.md)\n- [LinkFox Authentication and Billing Onboarding](references/onboarding.md)\n- [ClawHub Skill Page](https://clawhub.ai/linkfox-ai/skills/linkfox-temu-product-query)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, code, shell commands, configuration, guidance]\n\n**Output Format:** [Markdown guidance, shell commands, and JSON/API result summaries; full product-query responses may be saved as JSON files.]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [The query helper caches responses for up to 24 hours and writes full LinkFox API responses under a local linkfox session directory.]\n\n## Skill Version(s):\n\n1.0.9 (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\nArchive v1.0.8: 7 files, 19953 bytes\n\nFiles: references/api.md (5639b), references/onboarding.md (2046b), scripts/onboarding.py (24089b), scripts/temu_product_query.py (12673b), skill-card.md (2358b), SKILL.md (2402b), _meta.json (145b)\n\nFile v1.0.8:SKILL.md\n\n---\nname: linkfox-temu-product-query\ndescription: 按多维度筛选 Temu 商品（关键词/商品 ID/店铺 ID、前后台类目、价格、评分、评论、总/周/日销量、上架时间、全托管/半托管、半托管地区、标签等）。当用户提到 Temu 商品、Temu 选品、拼多多跨境、Temu 爆款、Temu 半托管、全托管商品、Temu product query、temu items 时触发。即使用户未提及工具名，只要在 Temu 上搜商品、看销量/评分/价格或筛品，也应触发此技能。\n---\n\n# Temu 商品查询\n\n## 要点\n\n- **分页**：`page` 从 1 起；`pageSize` 默认 20、最大 100（建议 ≤50）。\n- **区间入参**：`*Begin` / `*End` 成对出现（价格、评分、评论、总/周/日销量、上架时间），组成上游区间。\n- **类目**：`categoryHome` 前台类目 ID、`categoryBackend` 后台类目 ID；可先用 Temu 品类检索拿到 id。\n- **托管模式**：`isLocal`（0=全托管，1=半托管）；半托管可用 `region` 限定地区（多个逗号分隔）。\n- **上下架**：`soldOut`（0=上架，1=下架）。\n- **标签**：`tags` / `customTags` 多个用逗号分隔。\n- **排序**：`sortBy` 为「字段-方向」字符串，如 `order_week-0`（周销量降序，默认）、`price-0`、`order_total-0`、`rating-0`。\n\n## 脚本（可选）\n\n命令行调试：`python scripts/temu_product_query.py ''`（需 `LINKFOXAGENT_API_KEY`）。详见 [references/api.md](references/api.md) 末尾。\n\n## 参考\n\n入参/出参表见 [references/api.md](references/api.md)。\n\n## 解决认证和积分问题\n发生以下异常情况时，采用 references/onboarding.md 引导解决问题：\n\n### 异常情况\n- **未配置API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\n- **响应401或402状态码**\n- **响应提示积分或余额不足**：消息含\"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值\"，或类似含义的内容。\n\n## 积分消耗规则\n\n按动态规则计费：消耗积分 = 产品数量 × 1.8。按本页返回条数计费；翻到下一页，本质上是再发一次请求，再按下一页返回条数重新计算。\n\n> **重要**：本技能的服务按倍数动态计算，可能一次性消耗大量积分，必须提醒用户，由用户决定是否继续。\n\nFile v1.0.8:_meta.json\n\n{\n \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n \"slug\": \"linkfox-temu-product-query\",\n \"version\": \"1.0.8\",\n \"publishedAt\": 1786101685415\n}\n\nFile v1.0.8:references/api.md\n\n# Temu 商品查询 API 参考\n\n## 调用说明\n\n- **网关路由**：`POST ehunt/temu/productQuery`（完整：`${LINKFOX_TOOL_GATEWAY}/ehunt/temu/productQuery`）。\n- **MCP 展示名**：Temu 商品查询（确切工具名以当前环境下发的工具元数据为准）。\n- **鉴权**：请求头 `Authorization: `，api_key 从环境变量 `LINKFOX_AGENT_API_KEY` 或 `LINKFOXAGENT_API_KEY` 读取（如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理）。\n- **说明**：参数与返回结构以当前网关返回为准；若上游返回 JSON 根级 `code` 字段，成功值（`200`）以实网为准。无数据时网关可能抛错。\n\n## 请求参数（JSON）\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| searchKey | string, maxLen=500 | 否 | 关键词或商品 ID / 店铺 ID |\n| categoryHome | string | 否 | 前台类目 ID |\n| categoryBackend | string | 否 | 后台类目 ID |\n| priceBegin | number，≥0 | 否 | 价格区间起始（USD），组成上游 `price` |\n| priceEnd | number，≥0 | 否 | 价格区间结束（USD） |\n| ratingBegin | number (0~5) | 否 | 评分区间起始，组成上游 `rating` |\n| ratingEnd | number (0~5) | 否 | 评分区间结束 |\n| reviewsBegin | integer，≥0 | 否 | 评论数区间起始，组成 `reviews` |\n| reviewsEnd | integer，≥0 | 否 | 评论数区间结束 |\n| salesTotalBegin | integer，≥0 | 否 | 总销量区间起始，组成 `sales_total` |\n| salesTotalEnd | integer，≥0 | 否 | 总销量区间结束 |\n| salesWeeklyBegin | integer，≥0 | 否 | 周销量区间起始，组成 `sales_weekly` |\n| salesWeeklyEnd | integer，≥0 | 否 | 周销量区间结束 |\n| salesDailyBegin | integer，≥0 | 否 | 日销量区间起始，组成 `sales_daily` |\n| salesDailyEnd | integer，≥0 | 否 | 日销量区间结束 |\n| publishTimeBegin | string (YYYY-MM-DD) | 否 | 上架日期区间起始，组成 `publish_time` |\n| publishTimeEnd | string (YYYY-MM-DD) | 否 | 上架日期区间结束 |\n| soldOut | integer | 否 | 是否下架：0=上架，1=下架 |\n| isLocal | integer | 否 | 是否半托管：0=全托管，1=半托管 |\n| region | string | 否 | 半托管地区，多个逗号分隔 |\n| tags | string | 否 | 商品标签，多个逗号分隔 |\n| customTags | string | 否 | 自定义标签，多个逗号分隔 |\n| sortBy | string | 否 | 排序字段+方向：`order_week-0`（周销量降序，默认）、`price-0`、`order_total-0`、`rating-0` 等 |\n| page | integer，≥1，默认 1 | 否 | 页码（从 1 开始） |\n| pageSize | integer，1~100，默认 20 | 否 | 每页条数，最大 100，建议不超过 50 |\n\n## 响应主要字段\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| total | integer | 本页返回条数 |\n| productNum | integer | 符合条件的商品总数（上游 `product_num`） |\n| products | array | Temu 商品列表 |\n| columns | array | 渲染的列 |\n| title | string | 标题（`Temu 商品查询`） |\n| sourceType | string | 来源类型：temu |\n| sourceTool | string | 工具类型：ehunt |\n| type | string | 渲染的样式：tableListWorkbenches |\n\n### `products[]` 元素\n\n| 字段 | 上游别名 | 说明 |\n|------|----------|------|\n| productId | `product_id` | 商品 ID |\n| productName | `product_name` | 商品名（英文） |\n| productNameCn | `product_name_cn` | 商品名（中文） |\n| logoUrl | `logo_url` | 主图 URL |\n| price | - | 价格 |\n| orderTotal | `order_total` | 总销量 |\n| orderWeek | `order_week` | 周销量 |\n| orderDay | `order_day` | 日销量 |\n| orderMonth | `order_month` | 月销量 |\n| rating | - | 评分 |\n| reviewNum | `review_num` | 评论数 |\n| publishTime | `publish_time` | 上架时间 |\n| soldOut | `sold_out` | 是否下架 |\n| isLocal | `is_local` | 是否半托管：0=全托管，1=半托管 |\n| localRegion | `local_region` | 半托管地区列表 |\n| storeId | `store_id` | 店铺 ID |\n| tags | - | 标签列表 |\n| customTags | `custom_tags` | 自定义标签 |\n| categoryHome | `category_home` | 前台类目 |\n| categoryBackend | `category_backend` | 后台类目 |\n\n## 脚本调试（可选）\n\n仓库内提供 **`scripts/temu_product_query.py`**（Python 3，仅标准库），向 LinkFox 工具网关 POST 与 MCP 入参一致的 JSON。\n\n- **网关**：`https://tool-gateway.linkfox.com`（可用 `LINKFOX_TOOL_GATEWAY_BASE` 覆盖根 URL）\n- **默认路径段**：`ehunt/temu/productQuery`（可用 `LINKFOX_EHUNT_TEMU_PRODUCT_QUERY_PATH` 覆盖，不含域名）\n- **鉴权**：环境变量 `LINKFOXAGENT_API_KEY`（与其他 `linkfox-*` skill 相同；如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理）\n\n```bash\nexport LINKFOXAGENT_API_KEY=\"\"\npython scripts/temu_product_query.py '{\"searchKey\": \"kitchen\", \"page\": 1, \"pageSize\": 20}'\n```\n\n若返回 404，说明部署上该工具的 HTTP 路径与默认不一致，请用 `listEnabledTool` 或运维确认实际 path 后设置 `LINKFOX_EHUNT_TEMU_PRODUCT_QUERY_PATH`。\n\n## Feedback API\n\n> 与上方工具网关 API 独立，勿混用 Base URL。\n\n- **POST** `https://skill-api.linkfox.com/api/v1/public/feedback`\n- **Content-Type:** `application/json`\n\n```json\n{\n \"skillName\": \"linkfox-temu-product-query\",\n \"sentiment\": \"POSITIVE\",\n \"category\": \"OTHER\",\n \"content\": \"Results were accurate, user was satisfied.\"\n}\n```\n\n**Field rules:**\n- `skillName`: 使用本 skill YAML frontmatter 中的 `name`\n- `sentiment`: `POSITIVE` / `NEUTRAL` / `NEGATIVE`\n- `category`: `BUG` / `COMPLAINT` / `SUGGESTION` / `OTHER`\n- `content`: 简述用户意图、实际结果与问题或好评原因\n\nFile v1.0.8:references/onboarding.md\n\n# 解决认证和积分问题\n\n调用本 skill 时若网关返回 **auth** 或 **billing** 错误，走本 skill 自带的 `scripts/onboarding.py` 完成引导。\n\n**auth 场景**：`errcode=401` 或消息含 `authorized error`/`鉴权失败`/`未授权`/`unauthorized`；或 `LINKFOX_AGENT_API_KEY` 与 `LINKFOXAGENT_API_KEY` 均为空。\n1. 若已配置 key → 先让用户重启会话（最常见误判），仍失败让用户重新取 key 或换手机号重注册\n2. 未配置 → 询问：自助去 https://agent.linkfox.com/ 取 key，或提供手机号让脚本注册\n3. 手机号路径：\n - `python scripts/onboarding.py send-code ` → 展示 JSON 里的 phone/agreements\n - 收到验证码后：`python scripts/onboarding.py login `（workbuddy 宿主加 `--channel workbuddy`）\n - 拿到 `api_key` 后把下面三平台配置转发给用户，提示重启会话生效：\n - Windows PowerShell（永久）：`setx LINKFOX_AGENT_API_KEY \"\"`\n - macOS zsh：`echo 'export LINKFOX_AGENT_API_KEY=\"\"' >> ~/.zshrc && source ~/.zshrc`\n - Linux bash：`echo 'export LINKFOX_AGENT_API_KEY=\"\"' >> ~/.bashrc && source ~/.bashrc`\n - 变量名 `LINKFOX_AGENT_API_KEY`（主推）或 `LINKFOXAGENT_API_KEY`（老规范）任一即可\n\n**billing 场景**：`errcode=402` 或消息含 `积分/余额/quota/insufficient/充值/套餐到期`。\n- `python scripts/onboarding.py list-plans` → 有 AskUserQuestion 就弹菜单，否则输出编号清单让用户选\n- 校验 `plan_id` ∈ 清单、支付方式 ∈ 该套餐 `available_methods`（通常 `wechat/alipay`）\n- `python scripts/onboarding.py order ` → 展示优先级 PNG > `pay_url` > `ascii_qr`（标注兜底）\n- 已付款可选调 `python scripts/onboarding.py query `，不主动轮询\n\n排除 `errcode=403`（无权限，不归入这两类）。所有子命令输出 stdout JSON，`error` 字段已含阶段前缀，透传给用户即可。完整用法：`python scripts/onboarding.py --help`。\n\nFile v1.0.8:skill-card.md\n\n## Description:\n\n按多维度筛选 Temu 商品，包括关键词、商品 ID、店铺 ID、类目、价格、评分、评论、销量、上架时间、托管模式、地区和标签等。\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[linkfox-ai](https://clawhub.ai/user/linkfox-ai)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal users and developers use this skill to query and filter Temu product data for product research, ecommerce selection, and competitive analysis. It can also guide users through LinkFox API key setup or billing recovery when authentication or balance errors occur.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill contacts LinkFox services and can use LINKFOX_* environment overrides for service URLs.\n\nMitigation: Install only when LinkFox service access is expected, and run with trusted LINKFOX_* environment values.\n\nRisk: The onboarding flow can handle phone verification codes, API keys, billing plans, and payment ordering.\n\nMitigation: Review onboarding and billing steps before use, and treat verification codes, generated API keys, payment links, and order details as sensitive.\n\nRisk: The query script stores full product lookup responses in a local linkfox session directory.\n\nMitigation: Review stored response files for sensitive business data and apply local retention or cleanup controls appropriate for the workspace.\n\n## Reference(s):\n\n- [Temu 商品查询 API 参考](references/api.md)\n- [解决认证和积分问题](references/onboarding.md)\n- [ClawHub skill page](https://clawhub.ai/linkfox-ai/skills/linkfox-temu-product-query)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, shell commands, configuration, guidance]\n\n**Output Format:** [Markdown guidance with JSON API results and optional shell commands]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May store full API responses under a local linkfox session directory and summarize larger responses inline.]\n\n## Skill Version(s):\n\n1.0.8 (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\nArchive v1.0.7: 5 files, 11085 bytes\n\nFiles: references/api.md (5639b), scripts/temu_product_query.py (12673b), skill-card.md (2626b), SKILL.md (3019b), _meta.json (145b)\n\nFile v1.0.7:SKILL.md\n\n---\nname: linkfox-temu-product-query\ndescription: 按多维度筛选 Temu 商品（关键词/商品 ID/店铺 ID、前后台类目、价格、评分、评论、总/周/日销量、上架时间、全托管/半托管、半托管地区、标签等）。当用户提到 Temu 商品、Temu 选品、拼多多跨境、Temu 爆款、Temu 半托管、全托管商品、Temu product query、temu items 时触发。即使用户未提及工具名，只要在 Temu 上搜商品、看销量/评分/价格或筛品，也应触发此技能。\n---\n\n# Temu 商品查询\n\n## 要点\n\n- **分页**：`page` 从 1 起；`pageSize` 默认 20、最大 100（建议 ≤50）。\n- **区间入参**：`*Begin` / `*End` 成对出现（价格、评分、评论、总/周/日销量、上架时间），组成上游区间。\n- **类目**：`categoryHome` 前台类目 ID、`categoryBackend` 后台类目 ID；可先用 Temu 品类检索拿到 id。\n- **托管模式**：`isLocal`（0=全托管，1=半托管）；半托管可用 `region` 限定地区（多个逗号分隔）。\n- **上下架**：`soldOut`（0=上架，1=下架）。\n- **标签**：`tags` / `customTags` 多个用逗号分隔。\n- **排序**：`sortBy` 为「字段-方向」字符串，如 `order_week-0`（周销量降序，默认）、`price-0`、`order_total-0`、`rating-0`。\n\n## 脚本（可选）\n\n命令行调试：`python scripts/temu_product_query.py ''`（需 `LINKFOXAGENT_API_KEY`）。详见 [references/api.md](references/api.md) 末尾。\n\n## 参考\n\n入参/出参表见 [references/api.md](references/api.md)。\n\n## 解决认证和积分问题\n发生以下异常情况时，采用以下措施来处理：\n\n### 异常情况\n- **未配置API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\n- **响应401或402状态码**\n- **响应提示积分或余额不足**：消息含\"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值\"，或类似含义的内容。\n\n### 措施\n- 优先采用skill内的 onboarding.md 引导解决问题。\n- 如找不到 onboarding.md 文件，则加载 /linkfox-onboarding 这个skill并根据它的引导来处理。如未安装请先安装：\n - 下载 https://agent-files.linkfox.com/skills/linkfox-onboarding/release.zip，解压后安装这个skill。如需用户授权才可下载，要询问用户获得授权，你不能自己放弃下载。\n- 兜底措施：仅当前面两个措施经过所有努力都走不通时，才提示用户依据 https://skill.linkfox.com/linkfoxskills/guide.htm 指引获取API Key，或去 https://os.linkfox.com/ 补充积分。\n\n## 积分消耗规则\n\n按动态规则计费：消耗积分 = 产品数量 × 1.8。按本页返回条数计费；翻到下一页，本质上是再发一次请求，再按下一页返回条数重新计算。\n\n> **重要**：本技能的服务按倍数动态计算，可能一次性消耗大量积分，必须提醒用户，由用户决定是否继续。\n\nFile v1.0.7:_meta.json\n\n{\n \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n \"slug\": \"linkfox-temu-product-query\",\n \"version\": \"1.0.7\",\n \"publishedAt\": 1783946404113\n}\n\nFile v1.0.7:references/api.md\n\n# Temu 商品查询 API 参考\n\n## 调用说明\n\n- **网关路由**：`POST ehunt/temu/productQuery`（完整：`${LINKFOX_TOOL_GATEWAY}/ehunt/temu/productQuery`）。\n- **MCP 展示名**：Temu 商品查询（确切工具名以当前环境下发的工具元数据为准）。\n- **鉴权**：请求头 `Authorization: `，api_key 从环境变量 `LINKFOX_AGENT_API_KEY` 或 `LINKFOXAGENT_API_KEY` 读取（如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理）。\n- **说明**：参数与返回结构以当前网关返回为准；若上游返回 JSON 根级 `code` 字段，成功值（`200`）以实网为准。无数据时网关可能抛错。\n\n## 请求参数（JSON）\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| searchKey | string, maxLen=500 | 否 | 关键词或商品 ID / 店铺 ID |\n| categoryHome | string | 否 | 前台类目 ID |\n| categoryBackend | string | 否 | 后台类目 ID |\n| priceBegin | number，≥0 | 否 | 价格区间起始（USD），组成上游 `price` |\n| priceEnd | number，≥0 | 否 | 价格区间结束（USD） |\n| ratingBegin | number (0~5) | 否 | 评分区间起始，组成上游 `rating` |\n| ratingEnd | number (0~5) | 否 | 评分区间结束 |\n| reviewsBegin | integer，≥0 | 否 | 评论数区间起始，组成 `reviews` |\n| reviewsEnd | integer，≥0 | 否 | 评论数区间结束 |\n| salesTotalBegin | integer，≥0 | 否 | 总销量区间起始，组成 `sales_total` |\n| salesTotalEnd | integer，≥0 | 否 | 总销量区间结束 |\n| salesWeeklyBegin | integer，≥0 | 否 | 周销量区间起始，组成 `sales_weekly` |\n| salesWeeklyEnd | integer，≥0 | 否 | 周销量区间结束 |\n| salesDailyBegin | integer，≥0 | 否 | 日销量区间起始，组成 `sales_daily` |\n| salesDailyEnd | integer，≥0 | 否 | 日销量区间结束 |\n| publishTimeBegin | string (YYYY-MM-DD) | 否 | 上架日期区间起始，组成 `publish_time` |\n| publishTimeEnd | string (YYYY-MM-DD) | 否 | 上架日期区间结束 |\n| soldOut | integer | 否 | 是否下架：0=上架，1=下架 |\n| isLocal | integer | 否 | 是否半托管：0=全托管，1=半托管 |\n| region | string | 否 | 半托管地区，多个逗号分隔 |\n| tags | string | 否 | 商品标签，多个逗号分隔 |\n| customTags | string | 否 | 自定义标签，多个逗号分隔 |\n| sortBy | string | 否 | 排序字段+方向：`order_week-0`（周销量降序，默认）、`price-0`、`order_total-0`、`rating-0` 等 |\n| page | integer，≥1，默认 1 | 否 | 页码（从 1 开始） |\n| pageSize | integer，1~100，默认 20 | 否 | 每页条数，最大 100，建议不超过 50 |\n\n## 响应主要字段\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| total | integer | 本页返回条数 |\n| productNum | integer | 符合条件的商品总数（上游 `product_num`） |\n| products | array | Temu 商品列表 |\n| columns | array | 渲染的列 |\n| title | string | 标题（`Temu 商品查询`） |\n| sourceType | string | 来源类型：temu |\n| sourceTool | string | 工具类型：ehunt |\n| type | string | 渲染的样式：tableListWorkbenches |\n\n### `products[]` 元素\n\n| 字段 | 上游别名 | 说明 |\n|------|----------|------|\n| productId | `product_id` | 商品 ID |\n| productName | `product_name` | 商品名（英文） |\n| productNameCn | `product_name_cn` | 商品名（中文） |\n| logoUrl | `logo_url` | 主图 URL |\n| price | - | 价格 |\n| orderTotal | `order_total` | 总销量 |\n| orderWeek | `order_week` | 周销量 |\n| orderDay | `order_day` | 日销量 |\n| orderMonth | `order_month` | 月销量 |\n| rating | - | 评分 |\n| reviewNum | `review_num` | 评论数 |\n| publishTime | `publish_time` | 上架时间 |\n| soldOut | `sold_out` | 是否下架 |\n| isLocal | `is_local` | 是否半托管：0=全托管，1=半托管 |\n| localRegion | `local_region` | 半托管地区列表 |\n| storeId | `store_id` | 店铺 ID |\n| tags | - | 标签列表 |\n| customTags | `custom_tags` | 自定义标签 |\n| categoryHome | `category_home` | 前台类目 |\n| categoryBackend | `category_backend` | 后台类目 |\n\n## 脚本调试（可选）\n\n仓库内提供 **`scripts/temu_product_query.py`**（Python 3，仅标准库），向 LinkFox 工具网关 POST 与 MCP 入参一致的 JSON。\n\n- **网关**：`https://tool-gateway.linkfox.com`（可用 `LINKFOX_TOOL_GATEWAY_BASE` 覆盖根 URL）\n- **默认路径段**：`ehunt/temu/productQuery`（可用 `LINKFOX_EHUNT_TEMU_PRODUCT_QUERY_PATH` 覆盖，不含域名）\n- **鉴权**：环境变量 `LINKFOXAGENT_API_KEY`（与其他 `linkfox-*` skill 相同；如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理）\n\n```bash\nexport LINKFOXAGENT_API_KEY=\"\"\npython scripts/temu_product_query.py '{\"searchKey\": \"kitchen\", \"page\": 1, \"pageSize\": 20}'\n```\n\n若返回 404，说明部署上该工具的 HTTP 路径与默认不一致，请用 `listEnabledTool` 或运维确认实际 path 后设置 `LINKFOX_EHUNT_TEMU_PRODUCT_QUERY_PATH`。\n\n## Feedback API\n\n> 与上方工具网关 API 独立，勿混用 Base URL。\n\n- **POST** `https://skill-api.linkfox.com/api/v1/public/feedback`\n- **Content-Type:** `application/json`\n\n```json\n{\n \"skillName\": \"linkfox-temu-product-query\",\n \"sentiment\": \"POSITIVE\",\n \"category\": \"OTHER\",\n \"content\": \"Results were accurate, user was satisfied.\"\n}\n```\n\n**Field rules:**\n- `skillName`: 使用本 skill YAML frontmatter 中的 `name`\n- `sentiment`: `POSITIVE` / `NEUTRAL` / `NEGATIVE`\n- `category`: `BUG` / `COMPLAINT` / `SUGGESTION` / `OTHER`\n- `content`: 简述用户意图、实际结果与问题或好评原因\n\nFile v1.0.7:skill-card.md\n\n## Description:
\nFilters Temu products by keyword, product or store ID, category, price, rating, reviews, sales, listing date, fulfillment model, region, and tags.
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[linkfox-ai](https://clawhub.ai/user/linkfox-ai)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nExternal users and developers use this skill to query and compare Temu products for product research, using marketplace attributes, sales signals, and fulfillment details to narrow results.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: API credentials, Temu query content, and session metadata can be sent to a configurable LinkFox gateway.
\nMitigation: Install only if LinkFox is trusted for this data, and keep LINKFOX_TOOL_GATEWAY unset unless the destination is intentionally controlled.
\nRisk: Credential or billing failures can lead the workflow to request installation of a separate onboarding skill.
\nMitigation: Review the onboarding skill package before approving installation or use the documented LinkFox account and credit guidance instead.
\nRisk: Full query results may be saved locally and can fall back outside the current project directory.
\nMitigation: Run the helper from an appropriate workspace and review generated linkfox data files before sharing logs or archives.
\nRisk: Broad or repeated paginated queries can consume LinkFox credits based on returned product count.
\nMitigation: Confirm scope, page size, and pagination with the user before running high-volume queries.
\n\n\n## Reference(s):
\n- [Temu product query API reference](references/api.md)
\n- [ClawHub skill page](https://clawhub.ai/linkfox-ai/skills/linkfox-temu-product-query)
\n\n\n## Skill Output:
\n**Output Type(s):** [text, markdown, JSON, shell commands, configuration, guidance]
\n**Output Format:** [Markdown guidance with JSON API parameters and optional shell command output; helper script writes JSON result files.]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [Requires a LinkFox API key; paginated product queries may consume credits based on returned product count.]
\n\n## Skill Version(s):
\n1.0.7 (source: server release evidence)
\n\n## Ethical Considerations:
\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\nArchive v1.0.6: 5 files, 10121 bytes\n\nFiles: references/api.md (5551b), scripts/temu_product_query.py (12754b), skill-card.md (2207b), SKILL.md (1573b), _meta.json (145b)\n\nFile v1.0.6:SKILL.md\n\n---\nname: linkfox-temu-product-query\ndescription: 按多维度筛选 Temu 商品（关键词/商品 ID/店铺 ID、前后台类目、价格、评分、评论、总/周/日销量、上架时间、全托管/半托管、半托管地区、标签等）。当用户提到 Temu 商品、Temu 选品、拼多多跨境、Temu 爆款、Temu 半托管、全托管商品、Temu product query、temu items 时触发。即使用户未提及工具名，只要在 Temu 上搜商品、看销量/评分/价格或筛品，也应触发此技能。\n---\n\n# Temu 商品查询\n\n## 要点\n\n- **分页**：`page` 从 1 起；`pageSize` 默认 20、最大 100（建议 ≤50）。\n- **区间入参**：`*Begin` / `*End` 成对出现（价格、评分、评论、总/周/日销量、上架时间），组成上游区间。\n- **类目**：`categoryHome` 前台类目 ID、`categoryBackend` 后台类目 ID；可先用 Temu 品类检索拿到 id。\n- **托管模式**：`isLocal`（0=全托管，1=半托管）；半托管可用 `region` 限定地区（多个逗号分隔）。\n- **上下架**：`soldOut`（0=上架，1=下架）。\n- **标签**：`tags` / `customTags` 多个用逗号分隔。\n- **排序**：`sortBy` 为「字段-方向」字符串，如 `order_week-0`（周销量降序，默认）、`price-0`、`order_total-0`、`rating-0`。\n\n## 脚本（可选）\n\n命令行调试：`python scripts/temu_product_query.py ''`（需 `LINKFOXAGENT_API_KEY`）。详见 [references/api.md](references/api.md) 末尾。\n\n## 参考\n\n入参/出参表见 [references/api.md](references/api.md)。\n\nFile v1.0.6:_meta.json\n\n{\n \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n \"slug\": \"linkfox-temu-product-query\",\n \"version\": \"1.0.6\",\n \"publishedAt\": 1783662049169\n}\n\nFile v1.0.6:references/api.md\n\n# Temu 商品查询 API 参考\n\n## 调用说明\n\n- **网关路由**：`POST ehunt/temu/productQuery`（完整：`${LINKFOX_TOOL_GATEWAY}/ehunt/temu/productQuery`）。\n- **MCP 展示名**：Temu 商品查询（确切工具名以当前环境下发的工具元数据为准）。\n- **鉴权**：请求头 `Authorization: `，api_key 从环境变量 `LINKFOX_AGENT_API_KEY` 或 `LINKFOXAGENT_API_KEY` 读取。\n- **说明**：参数与返回结构以当前网关返回为准；若上游返回 JSON 根级 `code` 字段，成功值（`200`）以实网为准。无数据时网关可能抛错。\n\n## 请求参数（JSON）\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| searchKey | string, maxLen=500 | 否 | 关键词或商品 ID / 店铺 ID |\n| categoryHome | string | 否 | 前台类目 ID |\n| categoryBackend | string | 否 | 后台类目 ID |\n| priceBegin | number，≥0 | 否 | 价格区间起始（USD），组成上游 `price` |\n| priceEnd | number，≥0 | 否 | 价格区间结束（USD） |\n| ratingBegin | number (0~5) | 否 | 评分区间起始，组成上游 `rating` |\n| ratingEnd | number (0~5) | 否 | 评分区间结束 |\n| reviewsBegin | integer，≥0 | 否 | 评论数区间起始，组成 `reviews` |\n| reviewsEnd | integer，≥0 | 否 | 评论数区间结束 |\n| salesTotalBegin | integer，≥0 | 否 | 总销量区间起始，组成 `sales_total` |\n| salesTotalEnd | integer，≥0 | 否 | 总销量区间结束 |\n| salesWeeklyBegin | integer，≥0 | 否 | 周销量区间起始，组成 `sales_weekly` |\n| salesWeeklyEnd | integer，≥0 | 否 | 周销量区间结束 |\n| salesDailyBegin | integer，≥0 | 否 | 日销量区间起始，组成 `sales_daily` |\n| salesDailyEnd | integer，≥0 | 否 | 日销量区间结束 |\n| publishTimeBegin | string (YYYY-MM-DD) | 否 | 上架日期区间起始，组成 `publish_time` |\n| publishTimeEnd | string (YYYY-MM-DD) | 否 | 上架日期区间结束 |\n| soldOut | integer | 否 | 是否下架：0=上架，1=下架 |\n| isLocal | integer | 否 | 是否半托管：0=全托管，1=半托管 |\n| region | string | 否 | 半托管地区，多个逗号分隔 |\n| tags | string | 否 | 商品标签，多个逗号分隔 |\n| customTags | string | 否 | 自定义标签，多个逗号分隔 |\n| sortBy | string | 否 | 排序字段+方向：`order_week-0`（周销量降序，默认）、`price-0`、`order_total-0`、`rating-0` 等 |\n| page | integer，≥1，默认 1 | 否 | 页码（从 1 开始） |\n| pageSize | integer，1~100，默认 20 | 否 | 每页条数，最大 100，建议不超过 50 |\n\n## 响应主要字段\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| total | integer | 本页返回条数 |\n| productNum | integer | 符合条件的商品总数（上游 `product_num`） |\n| products | array | Temu 商品列表 |\n| columns | array | 渲染的列 |\n| title | string | 标题（`Temu 商品查询`） |\n| sourceType | string | 来源类型：temu |\n| sourceTool | string | 工具类型：ehunt |\n| type | string | 渲染的样式：tableListWorkbenches |\n\n### `products[]` 元素\n\n| 字段 | 上游别名 | 说明 |\n|------|----------|------|\n| productId | `product_id` | 商品 ID |\n| productName | `product_name` | 商品名（英文） |\n| productNameCn | `product_name_cn` | 商品名（中文） |\n| logoUrl | `logo_url` | 主图 URL |\n| price | - | 价格 |\n| orderTotal | `order_total` | 总销量 |\n| orderWeek | `order_week` | 周销量 |\n| orderDay | `order_day` | 日销量 |\n| orderMonth | `order_month` | 月销量 |\n| rating | - | 评分 |\n| reviewNum | `review_num` | 评论数 |\n| publishTime | `publish_time` | 上架时间 |\n| soldOut | `sold_out` | 是否下架 |\n| isLocal | `is_local` | 是否半托管：0=全托管，1=半托管 |\n| localRegion | `local_region` | 半托管地区列表 |\n| storeId | `store_id` | 店铺 ID |\n| tags | - | 标签列表 |\n| customTags | `custom_tags` | 自定义标签 |\n| categoryHome | `category_home` | 前台类目 |\n| categoryBackend | `category_backend` | 后台类目 |\n\n## 脚本调试（可选）\n\n仓库内提供 **`scripts/temu_product_query.py`**（Python 3，仅标准库），向 LinkFox 工具网关 POST 与 MCP 入参一致的 JSON。\n\n- **网关**：`https://tool-gateway.linkfox.com`（可用 `LINKFOX_TOOL_GATEWAY_BASE` 覆盖根 URL）\n- **默认路径段**：`ehunt/temu/productQuery`（可用 `LINKFOX_EHUNT_TEMU_PRODUCT_QUERY_PATH` 覆盖，不含域名）\n- **鉴权**：环境变量 `LINKFOXAGENT_API_KEY`（与其他 `linkfox-*` skill 相同；申请见 https://skill.linkfox.com/linkfoxskills/guide.htm ）\n\n```bash\nexport LINKFOXAGENT_API_KEY=\"\"\npython scripts/temu_product_query.py '{\"searchKey\": \"kitchen\", \"page\": 1, \"pageSize\": 20}'\n```\n\n若返回 404，说明部署上该工具的 HTTP 路径与默认不一致，请用 `listEnabledTool` 或运维确认实际 path 后设置 `LINKFOX_EHUNT_TEMU_PRODUCT_QUERY_PATH`。\n\n## Feedback API\n\n> 与上方工具网关 API 独立，勿混用 Base URL。\n\n- **POST** `https://skill-api.linkfox.com/api/v1/public/feedback`\n- **Content-Type:** `application/json`\n\n```json\n{\n \"skillName\": \"linkfox-temu-product-query\",\n \"sentiment\": \"POSITIVE\",\n \"category\": \"OTHER\",\n \"content\": \"Results were accurate, user was satisfied.\"\n}\n```\n\n**Field rules:**\n- `skillName`: 使用本 skill YAML frontmatter 中的 `name`\n- `sentiment`: `POSITIVE` / `NEUTRAL` / `NEGATIVE`\n- `category`: `BUG` / `COMPLAINT` / `SUGGESTION` / `OTHER`\n- `content`: 简述用户意图、实际结果与问题或好评原因\n\nFile v1.0.6:skill-card.md\n\n## Description:
\nQueries and filters Temu products by keyword, product or store ID, category, price, rating, reviews, sales, listing date, fulfillment mode, region, and tags.
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[linkfox-ai](https://clawhub.ai/user/linkfox-ai)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nTemu sellers, sourcing teams, and ecommerce analysts use this skill to retrieve filtered product lists and compare demand signals such as sales, reviews, price, rating, listing age, fulfillment mode, and region.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: Search filters and basic session context are sent to LinkFox when the skill queries Temu product data.
\nMitigation: Use the skill only when sharing that query context with LinkFox is acceptable, and avoid confidential sourcing research.
\nRisk: Full query results and cache entries may be saved locally under linkfox directories.
\nMitigation: Run the skill from an appropriate workspace and periodically delete local response files and caches if retention is not desired.
\n\n\n## Reference(s):
\n- [Temu 商品查询 API 参考](references/api.md)
\n- [ClawHub listing](https://clawhub.ai/linkfox-ai/skills/linkfox-temu-product-query)
\n- [LinkFox authorization guide](https://skill.linkfox.com/linkfoxskills/guide.htm)
\n\n\n## Skill Output:
\n**Output Type(s):** [JSON, Text, Files, Shell commands]
\n**Output Format:** [JSON responses and concise text summaries; large responses are saved to local JSON files.]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [Requires LINKFOX_AGENT_API_KEY or LINKFOXAGENT_API_KEY; paginated requests default to pageSize 20 and allow up to 100 results per page.]
\n\n## Skill Version(s):
\n1.0.6 (source: server release evidence)
\n\n## Ethical Considerations:
\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\nArchive v1.0.5: 5 files, 10092 bytes\n\nFiles: references/api.md (5551b), scripts/temu_product_query.py (12754b), skill-card.md (2205b), SKILL.md (1573b), _meta.json (145b)\n\nFile v1.0.5:SKILL.md\n\n---\nname: linkfox-temu-product-query\ndescription: 按多维度筛选 Temu 商品（关键词/商品 ID/店铺 ID、前后台类目、价格、评分、评论、总/周/日销量、上架时间、全托管/半托管、半托管地区、标签等）。当用户提到 Temu 商品、Temu 选品、拼多多跨境、Temu 爆款、Temu 半托管、全托管商品、Temu product query、temu items 时触发。即使用户未提及工具名，只要在 Temu 上搜商品、看销量/评分/价格或筛品，也应触发此技能。\n---\n\n# Temu 商品查询\n\n## 要点\n\n- **分页**：`page` 从 1 起；`pageSize` 默认 20、最大 100（建议 ≤50）。\n- **区间入参**：`*Begin` / `*End` 成对出现（价格、评分、评论、总/周/日销量、上架时间），组成上游区间。\n- **类目**：`categoryHome` 前台类目 ID、`categoryBackend` 后台类目 ID；可先用 Temu 品类检索拿到 id。\n- **托管模式**：`isLocal`（0=全托管，1=半托管）；半托管可用 `region` 限定地区（多个逗号分隔）。\n- **上下架**：`soldOut`（0=上架，1=下架）。\n- **标签**：`tags` / `customTags` 多个用逗号分隔。\n- **排序**：`sortBy` 为「字段-方向」字符串，如 `order_week-0`（周销量降序，默认）、`price-0`、`order_total-0`、`rating-0`。\n\n## 脚本（可选）\n\n命令行调试：`python scripts/temu_product_query.py ''`（需 `LINKFOXAGENT_API_KEY`）。详见 [references/api.md](references/api.md) 末尾。\n\n## 参考\n\n入参/出参表见 [references/api.md](references/api.md)。\n\nFile v1.0.5:_meta.json\n\n{\n \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n \"slug\": \"linkfox-temu-product-query\",\n \"version\": \"1.0.5\",\n \"publishedAt\": 1783575917605\n}\n\nFile v1.0.5:references/api.md\n\n# Temu 商品查询 API 参考\n\n## 调用说明\n\n- **网关路由**：`POST ehunt/temu/productQuery`（完整：`${LINKFOX_TOOL_GATEWAY}/ehunt/temu/productQuery`）。\n- **MCP 展示名**：Temu 商品查询（确切工具名以当前环境下发的工具元数据为准）。\n- **鉴权**：请求头 `Authorization: `，api_key 从环境变量 `LINKFOX_AGENT_API_KEY` 或 `LINKFOXAGENT_API_KEY` 读取。\n- **说明**：参数与返回结构以当前网关返回为准；若上游返回 JSON 根级 `code` 字段，成功值（`200`）以实网为准。无数据时网关可能抛错。\n\n## 请求参数（JSON）\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| searchKey | string, maxLen=500 | 否 | 关键词或商品 ID / 店铺 ID |\n| categoryHome | string | 否 | 前台类目 ID |\n| categoryBackend | string | 否 | 后台类目 ID |\n| priceBegin | number，≥0 | 否 | 价格区间起始（USD），组成上游 `price` |\n| priceEnd | number，≥0 | 否 | 价格区间结束（USD） |\n| ratingBegin | number (0~5) | 否 | 评分区间起始，组成上游 `rating` |\n| ratingEnd | number (0~5) | 否 | 评分区间结束 |\n| reviewsBegin | integer，≥0 | 否 | 评论数区间起始，组成 `reviews` |\n| reviewsEnd | integer，≥0 | 否 | 评论数区间结束 |\n| salesTotalBegin | integer，≥0 | 否 | 总销量区间起始，组成 `sales_total` |\n| salesTotalEnd | integer，≥0 | 否 | 总销量区间结束 |\n| salesWeeklyBegin | integer，≥0 | 否 | 周销量区间起始，组成 `sales_weekly` |\n| salesWeeklyEnd | integer，≥0 | 否 | 周销量区间结束 |\n| salesDailyBegin | integer，≥0 | 否 | 日销量区间起始，组成 `sales_daily` |\n| salesDailyEnd | integer，≥0 | 否 | 日销量区间结束 |\n| publishTimeBegin | string (YYYY-MM-DD) | 否 | 上架日期区间起始，组成 `publish_time` |\n| publishTimeEnd | string (YYYY-MM-DD) | 否 | 上架日期区间结束 |\n| soldOut | integer | 否 | 是否下架：0=上架，1=下架 |\n| isLocal | integer | 否 | 是否半托管：0=全托管，1=半托管 |\n| region | string | 否 | 半托管地区，多个逗号分隔 |\n| tags | string | 否 | 商品标签，多个逗号分隔 |\n| customTags | string | 否 | 自定义标签，多个逗号分隔 |\n| sortBy | string | 否 | 排序字段+方向：`order_week-0`（周销量降序，默认）、`price-0`、`order_total-0`、`rating-0` 等 |\n| page | integer，≥1，默认 1 | 否 | 页码（从 1 开始） |\n| pageSize | integer，1~100，默认 20 | 否 | 每页条数，最大 100，建议不超过 50 |\n\n## 响应主要字段\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| total | integer | 本页返回条数 |\n| productNum | integer | 符合条件的商品总数（上游 `product_num`） |\n| products | array | Temu 商品列表 |\n| columns | array | 渲染的列 |\n| title | string | 标题（`Temu 商品查询`） |\n| sourceType | string | 来源类型：temu |\n| sourceTool | string | 工具类型：ehunt |\n| type | string | 渲染的样式：tableListWorkbenches |\n\n### `products[]` 元素\n\n| 字段 | 上游别名 | 说明 |\n|------|----------|------|\n| productId | `product_id` | 商品 ID |\n| productName | `product_name` | 商品名（英文） |\n| productNameCn | `product_name_cn` | 商品名（中文） |\n| logoUrl | `logo_url` | 主图 URL |\n| price | - | 价格 |\n| orderTotal | `order_total` | 总销量 |\n| orderWeek | `order_week` | 周销量 |\n| orderDay | `order_day` | 日销量 |\n| orderMonth | `order_month` | 月销量 |\n| rating | - | 评分 |\n| reviewNum | `review_num` | 评论数 |\n| publishTime | `publish_time` | 上架时间 |\n| soldOut | `sold_out` | 是否下架 |\n| isLocal | `is_local` | 是否半托管：0=全托管，1=半托管 |\n| localRegion | `local_region` | 半托管地区列表 |\n| storeId | `store_id` | 店铺 ID |\n| tags | - | 标签列表 |\n| customTags | `custom_tags` | 自定义标签 |\n| categoryHome | `category_home` | 前台类目 |\n| categoryBackend | `category_backend` | 后台类目 |\n\n## 脚本调试（可选）\n\n仓库内提供 **`scripts/temu_product_query.py`**（Python 3，仅标准库），向 LinkFox 工具网关 POST 与 MCP 入参一致的 JSON。\n\n- **网关**：`https://tool-gateway.linkfox.com`（可用 `LINKFOX_TOOL_GATEWAY_BASE` 覆盖根 URL）\n- **默认路径段**：`ehunt/temu/productQuery`（可用 `LINKFOX_EHUNT_TEMU_PRODUCT_QUERY_PATH` 覆盖，不含域名）\n- **鉴权**：环境变量 `LINKFOXAGENT_API_KEY`（与其他 `linkfox-*` skill 相同；申请见 https://skill.linkfox.com/linkfoxskills/guide.htm ）\n\n```bash\nexport LINKFOXAGENT_API_KEY=\"\"\npython scripts/temu_product_query.py '{\"searchKey\": \"kitchen\", \"page\": 1, \"pageSize\": 20}'\n```\n\n若返回 404，说明部署上该工具的 HTTP 路径与默认不一致，请用 `listEnabledTool` 或运维确认实际 path 后设置 `LINKFOX_EHUNT_TEMU_PRODUCT_QUERY_PATH`。\n\n## Feedback API\n\n> 与上方工具网关 API 独立，勿混用 Base URL。\n\n- **POST** `https://skill-api.linkfox.com/api/v1/public/feedback`\n- **Content-Type:** `application/json`\n\n```json\n{\n \"skillName\": \"linkfox-temu-product-query\",\n \"sentiment\": \"POSITIVE\",\n \"category\": \"OTHER\",\n \"content\": \"Results were accurate, user was satisfied.\"\n}\n```\n\n**Field rules:**\n- `skillName`: 使用本 skill YAML frontmatter 中的 `name`\n- `sentiment`: `POSITIVE` / `NEUTRAL` / `NEGATIVE`\n- `category`: `BUG` / `COMPLAINT` / `SUGGESTION` / `OTHER`\n- `content`: 简述用户意图、实际结果与问题或好评原因\n\nFile v1.0.5:skill-card.md\n\n## Description:
\nQueries and filters Temu products by keyword, product or shop ID, category, price, rating, reviews, sales, listing date, fulfillment mode, region, tags, and sort order.
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[linkfox-ai](https://clawhub.ai/user/linkfox-ai)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nExternal users, marketplace operators, and ecommerce researchers use this skill to find and compare Temu products for sourcing and product research through LinkFox.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: Temu product research queries and session or app metadata are sent to LinkFox.
\nMitigation: Use the skill only for non-sensitive research in workspaces where LinkFox data sharing is acceptable.
\nRisk: Full API responses are saved locally under LinkFox directories.
\nMitigation: Control workspace access and clean saved response files when retained product research data is no longer needed.
\nRisk: The separate Feedback API can transmit user-context content.
\nMitigation: Use feedback submission only with explicit intent and avoid sending sensitive content.
\n\n\n## Reference(s):
\n- [Temu 商品查询 API 参考](references/api.md)
\n- [ClawHub skill page](https://clawhub.ai/linkfox-ai/skills/linkfox-temu-product-query)
\n\n\n## Skill Output:
\n**Output Type(s):** [Text, JSON, Files, Shell commands, Configuration, Guidance]
\n**Output Format:** [Markdown guidance with JSON parameters, shell command examples, and saved JSON API responses.]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [Full API responses are saved under LinkFox session directories; large responses are summarized unless inline output is requested.]
\n\n## Skill Version(s):
\n1.0.5 (source: server release evidence)
\n\n## Ethical Considerations:
\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\nArchive v1.0.4: 5 files, 10496 bytes\n\nFiles: references/api.md (5551b), scripts/temu_product_query.py (12801b), skill-card.md (2569b), SKILL.md (1996b), _meta.json (145b)\n\nFile v1.0.4:SKILL.md\n\n---\nname: linkfox-temu-product-query\ndescription: 通过 Temu 商品查询（网关路由 `ehunt/temu/productQuery`）按多维度筛选 Temu 商品（关键词/商品 ID/店铺 ID、前后台类目、价格、评分、评论、总/周/日销量、上架时间、全托管/半托管、半托管地区、标签等）。当用户提到 Temu 商品、Temu 选品、拼多多跨境、Temu 爆款、Temu 半托管、全托管商品、Temu product query、temu items 时触发。即使用户未提及工具名，只要在 Temu 上搜商品、看销量/评分/价格或筛品，也应触发此技能。\n---\n\n# Temu 商品查询（`ehunt/temu/productQuery`）\n\n在具备 LinkFox「第三方数据服务」MCP 时，对应网关路由 **`ehunt/temu/productQuery`** 调用（MCP 展示名：**Temu 商品查询**，确切工具名以当前环境下发的工具元数据为准）。鉴权与上游路由由网关处理；若响应含根级 `code` 字段，是否成功以实网为准。\n\n## 要点\n\n- **分页**：`page` 从 1 起；`pageSize` 默认 20、最大 100（建议 ≤50）。\n- **区间入参**：`*Begin` / `*End` 成对出现（价格、评分、评论、总/周/日销量、上架时间），组成上游区间。\n- **类目**：`categoryHome` 前台类目 ID、`categoryBackend` 后台类目 ID；可先用 Temu 品类检索拿到 id。\n- **托管模式**：`isLocal`（0=全托管，1=半托管）；半托管可用 `region` 限定地区（多个逗号分隔）。\n- **上下架**：`soldOut`（0=上架，1=下架）。\n- **标签**：`tags` / `customTags` 多个用逗号分隔。\n- **排序**：`sortBy` 为「字段-方向」字符串，如 `order_week-0`（周销量降序，默认）、`price-0`、`order_total-0`、`rating-0`。\n\n## 脚本（可选）\n\n命令行调试：`python scripts/temu_product_query.py ''`（需 `LINKFOXAGENT_API_KEY`）。详见 [references/api.md](references/api.md) 末尾。\n\n## 参考\n\n入参/出参表见 [references/api.md](references/api.md)。\n\nFile v1.0.4:_meta.json\n\n{\n \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n \"slug\": \"linkfox-temu-product-query\",\n \"version\": \"1.0.4\",\n \"publishedAt\": 1783574419298\n}\n\nFile v1.0.4:references/api.md\n\n# Temu 商品查询 API 参考\n\n## 调用说明\n\n- **网关路由**：`POST ehunt/temu/productQuery`（完整：`${LINKFOX_TOOL_GATEWAY}/ehunt/temu/productQuery`）。\n- **MCP 展示名**：Temu 商品查询（确切工具名以当前环境下发的工具元数据为准）。\n- **鉴权**：请求头 `Authorization: `，api_key 从环境变量 `LINKFOX_AGENT_API_KEY` 或 `LINKFOXAGENT_API_KEY` 读取。\n- **说明**：参数与返回结构以当前网关返回为准；若上游返回 JSON 根级 `code` 字段，成功值（`200`）以实网为准。无数据时网关可能抛错。\n\n## 请求参数（JSON）\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| searchKey | string, maxLen=500 | 否 | 关键词或商品 ID / 店铺 ID |\n| categoryHome | string | 否 | 前台类目 ID |\n| categoryBackend | string | 否 | 后台类目 ID |\n| priceBegin | number，≥0 | 否 | 价格区间起始（USD），组成上游 `price` |\n| priceEnd | number，≥0 | 否 | 价格区间结束（USD） |\n| ratingBegin | number (0~5) | 否 | 评分区间起始，组成上游 `rating` |\n| ratingEnd | number (0~5) | 否 | 评分区间结束 |\n| reviewsBegin | integer，≥0 | 否 | 评论数区间起始，组成 `reviews` |\n| reviewsEnd | integer，≥0 | 否 | 评论数区间结束 |\n| salesTotalBegin | integer，≥0 | 否 | 总销量区间起始，组成 `sales_total` |\n| salesTotalEnd | integer，≥0 | 否 | 总销量区间结束 |\n| salesWeeklyBegin | integer，≥0 | 否 | 周销量区间起始，组成 `sales_weekly` |\n| salesWeeklyEnd | integer，≥0 | 否 | 周销量区间结束 |\n| salesDailyBegin | integer，≥0 | 否 | 日销量区间起始，组成 `sales_daily` |\n| salesDailyEnd | integer，≥0 | 否 | 日销量区间结束 |\n| publishTimeBegin | string (YYYY-MM-DD) | 否 | 上架日期区间起始，组成 `publish_time` |\n| publishTimeEnd | string (YYYY-MM-DD) | 否 | 上架日期区间结束 |\n| soldOut | integer | 否 | 是否下架：0=上架，1=下架 |\n| isLocal | integer | 否 | 是否半托管：0=全托管，1=半托管 |\n| region | string | 否 | 半托管地区，多个逗号分隔 |\n| tags | string | 否 | 商品标签，多个逗号分隔 |\n| customTags | string | 否 | 自定义标签，多个逗号分隔 |\n| sortBy | string | 否 | 排序字段+方向：`order_week-0`（周销量降序，默认）、`price-0`、`order_total-0`、`rating-0` 等 |\n| page | integer，≥1，默认 1 | 否 | 页码（从 1 开始） |\n| pageSize | integer，1~100，默认 20 | 否 | 每页条数，最大 100，建议不超过 50 |\n\n## 响应主要字段\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| total | integer | 本页返回条数 |\n| productNum | integer | 符合条件的商品总数（上游 `product_num`） |\n| products | array | Temu 商品列表 |\n| columns | array | 渲染的列 |\n| title | string | 标题（`Temu 商品查询`） |\n| sourceType | string | 来源类型：temu |\n| sourceTool | string | 工具类型：ehunt |\n| type | string | 渲染的样式：tableListWorkbenches |\n\n### `products[]` 元素\n\n| 字段 | 上游别名 | 说明 |\n|------|----------|------|\n| productId | `product_id` | 商品 ID |\n| productName | `product_name` | 商品名（英文） |\n| productNameCn | `product_name_cn` | 商品名（中文） |\n| logoUrl | `logo_url` | 主图 URL |\n| price | - | 价格 |\n| orderTotal | `order_total` | 总销量 |\n| orderWeek | `order_week` | 周销量 |\n| orderDay | `order_day` | 日销量 |\n| orderMonth | `order_month` | 月销量 |\n| rating | - | 评分 |\n| reviewNum | `review_num` | 评论数 |\n| publishTime | `publish_time` | 上架时间 |\n| soldOut | `sold_out` | 是否下架 |\n| isLocal | `is_local` | 是否半托管：0=全托管，1=半托管 |\n| localRegion | `local_region` | 半托管地区列表 |\n| storeId | `store_id` | 店铺 ID |\n| tags | - | 标签列表 |\n| customTags | `custom_tags` | 自定义标签 |\n| categoryHome | `category_home` | 前台类目 |\n| categoryBackend | `category_backend` | 后台类目 |\n\n## 脚本调试（可选）\n\n仓库内提供 **`scripts/temu_product_query.py`**（Python 3，仅标准库），向 LinkFox 工具网关 POST 与 MCP 入参一致的 JSON。\n\n- **网关**：`https://tool-gateway.linkfox.com`（可用 `LINKFOX_TOOL_GATEWAY_BASE` 覆盖根 URL）\n- **默认路径段**：`ehunt/temu/productQuery`（可用 `LINKFOX_EHUNT_TEMU_PRODUCT_QUERY_PATH` 覆盖，不含域名）\n- **鉴权**：环境变量 `LINKFOXAGENT_API_KEY`（与其他 `linkfox-*` skill 相同；申请见 https://skill.linkfox.com/linkfoxskills/guide.htm ）\n\n```bash\nexport LINKFOXAGENT_API_KEY=\"\"\npython scripts/temu_product_query.py '{\"searchKey\": \"kitchen\", \"page\": 1, \"pageSize\": 20}'\n```\n\n若返回 404，说明部署上该工具的 HTTP 路径与默认不一致，请用 `listEnabledTool` 或运维确认实际 path 后设置 `LINKFOX_EHUNT_TEMU_PRODUCT_QUERY_PATH`。\n\n## Feedback API\n\n> 与上方工具网关 API 独立，勿混用 Base URL。\n\n- **POST** `https://skill-api.linkfox.com/api/v1/public/feedback`\n- **Content-Type:** `application/json`\n\n```json\n{\n \"skillName\": \"linkfox-temu-product-query\",\n \"sentiment\": \"POSITIVE\",\n \"category\": \"OTHER\",\n \"content\": \"Results were accurate, user was satisfied.\"\n}\n```\n\n**Field rules:**\n- `skillName`: 使用本 skill YAML frontmatter 中的 `name`\n- `sentiment`: `POSITIVE` / `NEUTRAL` / `NEGATIVE`\n- `category`: `BUG` / `COMPLAINT` / `SUGGESTION` / `OTHER`\n- `content`: 简述用户意图、实际结果与问题或好评原因\n\nFile v1.0.4:skill-card.md\n\n## Description:
\nTemu商品查询 helps agents query and filter Temu product listings through LinkFox by keyword, product or store ID, category, price, ratings, reviews, sales, listing status, fulfillment mode, region, tags, and sorting options.
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[linkfox-ai](https://clawhub.ai/user/linkfox-ai)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nExternal sellers, ecommerce analysts, and developers use this skill to ask an agent for Temu product research and filtering across sales, pricing, ratings, availability, fulfillment mode, and regional criteria.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: Temu product queries are sent to LinkFox and may include commercially sensitive search terms or product research intent.
\nMitigation: Use approved query terms, avoid secrets or sensitive business strategy in searches, and confirm LinkFox data handling is acceptable for the deployment.
\nRisk: The optional helper script saves full API responses locally and may create linkfox data or cache files outside the documented project directory.
\nMitigation: Run the script from an approved workspace, review generated linkfox data and cache paths, and periodically delete saved product data that is no longer needed.
\n\n\n## Reference(s):
\n- [Temu商品查询 API 参考](artifact/references/api.md)
\n- [ClawHub skill page](https://clawhub.ai/linkfox-ai/skills/linkfox-temu-product-query)
\n- [LinkFox authorization guide](https://skill.linkfox.com/linkfoxskills/guide.htm)
\n\n\n## Skill Output:
\n**Output Type(s):** [text, markdown, JSON, shell commands, configuration, files]
\n**Output Format:** [Markdown guidance with JSON API parameters and optional shell commands; the helper script prints JSON or summaries and writes full JSON responses to local files.]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [Uses LINKFOX_AGENT_API_KEY or LINKFOXAGENT_API_KEY for authentication; the helper script maintains a local 24-hour cache and stores response data under linkfox session directories.]
\n\n## Skill Version(s):
\n1.0.4 (source: server release evidence)
\n\n## Ethical Considerations:
\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.
","readmeExcerpt":"Skill: Temu商品查询 Owner: linkfox-ai Summary: 按多维度筛选 Temu 商品（关键词/商品 ID/店铺 ID、前后台类目、价格、评分、评论、总/周/日销量、上架时间、全托管/半托管、半托管地区、标签等）。当用户提到 Temu 商品、Temu 选品、拼多多跨境、Temu 爆款、Temu 半托管、全托管商品、Temu product query、temu items 时触发。即使用户未提及工具名，只要在 Temu 上搜商品、看销量/评分/价格或筛品，也应触发此技能。 Tags: latest:1.0.9 Version history: v1.0.9 | 2026-08-14T15:18:07.419Z | user Update from 1.0.8 to 1.0.9 v1.0.8 | 2026-08-07T11:21:25.415Z | user Update from 1.0.7 to 1","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"export LINKFOXAGENT_API_KEY=\"\"\npython scripts/temu_product_query.py '{\"searchKey\": \"kitchen\", \"page\": 1, \"pageSize\": 20}'"},{"language":"json","snippet":"{\n \"skillName\": \"linkfox-temu-product-query\",\n \"sentiment\": \"POSITIVE\",\n \"category\": \"OTHER\",\n \"content\": \"Results were accurate, user was satisfied.\"\n}"},{"language":"bash","snippet":"export LINKFOXAGENT_API_KEY=\"\"\npython scripts/temu_product_query.py '{\"searchKey\": \"kitchen\", \"page\": 1, \"pageSize\": 20}'"},{"language":"json","snippet":"{\n \"skillName\": \"linkfox-temu-product-query\",\n \"sentiment\": \"POSITIVE\",\n \"category\": \"OTHER\",\n \"content\": \"Results were accurate, user was satisfied.\"\n}"},{"language":"bash","snippet":"export LINKFOXAGENT_API_KEY=\"\"\npython scripts/temu_product_query.py '{\"searchKey\": \"kitchen\", \"page\": 1, \"pageSize\": 20}'"},{"language":"json","snippet":"{\n \"skillName\": \"linkfox-temu-product-query\",\n \"sentiment\": \"POSITIVE\",\n \"category\": \"OTHER\",\n \"content\": \"Results were accurate, user was satisfied.\"\n}"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: linkfox-temu-product-query\ndescription: 按多维度筛选 Temu 商品（关键词/商品 ID/店铺 ID、前后台类目、价格、评分、评论、总/周/日销量、上架时间、全托管/半托管、半托管地区、标签等）。当用户提到 Temu 商品、Temu 选品、拼多多跨境、Temu 爆款、Temu 半托管、全托管商品、Temu product query、temu items 时触发。即使用户未提及工具名，只要在 Temu 上搜商品、看销量/评分/价格或筛品，也应触发此技能。\n---\n\n# Temu 商品查询\n\n## 要点\n\n- **分页**：`page` 从 1 起；`pageSize` 默认 20、最大 100（建议 ≤50）。\n- **区间入参**：`*Begin` / `*End` 成对出现（价格、评分、评论、总/周/日销量、上架时间），组成上游区间。\n- **类目**：`categoryHome` 前台类目 ID、`categoryBackend` 后台类目 ID；可先用 Temu 品类检索拿到 id。\n- **托管模式**：`isLocal`（0=全托管，1=半托管）；半托管可用 `region` 限定地区（多个逗号分隔）。\n- **上下架**：`soldOut`（0=上架，1=下架）。\n- **标签**：`tags` / `customTags` 多个用逗号分隔。\n- **排序**：`sortBy` 为「字段-方向」字符串，如 `order_week-0`（周销量降序，默认）、`price-0`、`order_total-0`、`rating-0`。\n\n## 脚本（可选）\n\n命令行调试：`python scripts/temu_product_query.py ''`（需 `LINKFOXAGENT_API_KEY`）。详见 [references/api.md](references/api.md) 末尾。\n\n## 参考\n\n入参/出参表见 [references/api.md](references/api.md)。\n\n## 解决认证和积分问题\n发生以下异常情况时，采用 references/onboarding.md 引导解决问题：\n\n### 异常情况\n- **未配置API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\n- **响应401或402状态码**\n- **响应提示积分或余额不足**：消息含\"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值\"，或类似含义的内容。\n\n## 积分消耗规则\n\n按动态规则计费：消耗积分 = 产品数量 × 1.8。按本页返回条数计费；翻到下一页，本质上是再发一次请求，再按下一页返回条数重新计算。\n\n> **重要**：本技能的服务按倍数动态计算，可能一次性消耗大量积分，必须提醒用户，由用户决定是否继续。"},{"path":"_meta.json","content":"{\n \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n \"slug\": \"linkfox-temu-product-query\",\n \"version\": \"1.0.9\",\n \"publishedAt\": 1786720687419\n}"},{"path":"references/api.md","content":"# Temu 商品查询 API 参考\n\n## 调用说明\n\n- **网关路由**：`POST ehunt/temu/productQuery`（完整：`${LINKFOX_TOOL_GATEWAY}/ehunt/temu/productQuery`）。\n- **MCP 展示名**：Temu 商品查询（确切工具名以当前环境下发的工具元数据为准）。\n- **鉴权**：请求头 `Authorization: `，api_key 从环境变量 `LINKFOX_AGENT_API_KEY` 或 `LINKFOXAGENT_API_KEY` 读取（如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理）。\n- **说明**：参数与返回结构以当前网关返回为准；若上游返回 JSON 根级 `code` 字段，成功值（`200`）以实网为准。无数据时网关可能抛错。\n\n## 请求参数（JSON）\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| searchKey | string, maxLen=500 | 否 | 关键词或商品 ID / 店铺 ID |\n| categoryHome | string | 否 | 前台类目 ID |\n| categoryBackend | string | 否 | 后台类目 ID |\n| priceBegin | number，≥0 | 否 | 价格区间起始（USD），组成上游 `price` |\n| priceEnd | number，≥0 | 否 | 价格区间结束（USD） |\n| ratingBegin | number (0~5) | 否 | 评分区间起始，组成上游 `rating` |\n| ratingEnd | number (0~5) | 否 | 评分区间结束 |\n| reviewsBegin | integer，≥0 | 否 | 评论数区间起始，组成 `reviews` |\n| reviewsEnd | integer，≥0 | 否 | 评论数区间结束 |\n| salesTotalBegin | integer，≥0 | 否 | 总销量区间起始，组成 `sales_total` |\n| salesTotalEnd | integer，≥0 | 否 | 总销量区间结束 |\n| salesWeeklyBegin | integer，≥0 | 否 | 周销量区间起始，组成 `sales_weekly` |\n| salesWeeklyEnd | integer，≥0 | 否 | 周销量区间结束 |\n| salesDailyBegin | integer，≥0 | 否 | 日销量区间起始，组成 `sales_daily` |\n| salesDailyEnd | integer，≥0 | 否 | 日销量区间结束 |\n| publishTimeBegin | string (YYYY-MM-DD) | 否 | 上架日期区间起始，组成 `publish_time` |\n| publishTimeEnd | string (YYYY-MM-DD) | 否 | 上架日期区间结束 |\n| soldOut | integer | 否 | 是否下架：0=上架，1=下架 |\n| isLocal | integer | 否 | 是否半托管：0=全托管，1=半托管 |\n| region | string | 否 | 半托管地区，多个逗号分隔 |\n| tags | string | 否 | 商品标签，多个逗号分隔 |\n| customTags | string | 否 | 自定义标签，多个逗号分隔 |\n| sortBy | string | 否 | 排序字段+方向：`order_week-0`（周销量降序，默认）、`price-0`、`order_total-0`、`rating-0` 等 |\n| page | integer，≥1，默认 1 | 否 | 页码（从 1 开始） |\n| pageSize | integer，1~100，默认 20 | 否 | 每页条数，最大 100，建议不超过 50 |\n\n## 响应主要字段\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| total | integer | 本页返回条数 |\n| productNum | integer | 符合条件的商品总数（上游 `product_num`） |\n| products | array | Temu 商品列表 |\n| columns | array | 渲染的列 |\n| title | string | 标题（`Temu 商品查询`） |\n| sourceType | string | 来源类型：temu |\n| sourceTool | string | 工具类型：ehunt |\n| type | string | 渲染的样式：tableListWorkbenches |\n\n### `products[]` 元素\n\n| 字段 | 上游别名 | 说明 |\n|------|----------|------|\n| productId | `product_id` | 商品 ID |\n| productName | `product_name` | 商品名（英文） |\n| productNameCn | `product_name_cn` | 商品名（中文） |\n| logoUrl | `logo_url` | 主图 URL |\n| price | - | 价格 |\n| orderTotal | `order_total` | 总销量 |\n| orderWeek | `order_week` | 周销量 |\n| orderDay | `order_day` | 日销量 |\n| orderMonth | `order_month` | 月销量 |\n| rating | - | 评分 |\n| reviewNum | `review_num` | 评论数 |\n| publishTime | `publish_time` | 上架时间 |\n| soldOut | `sold_out` | 是否下架 |\n| isLocal | `is_local` | 是否半托管：0=全托管，1=半托管 |\n| localRegion | `local_region` | 半托管地区列表 |\n| storeId | `store_id` | 店铺 ID |\n| tags | - | 标签列表 |\n| customTags | `custom_tags` | 自定义标签 |\n| categoryHome | `category_home` | 前台类目 |\n| categoryBackend | `category_backend` | 后台类目 |\n\n## 脚本调试（可选）\n\n仓库内提供 **`scripts/temu_product_query.py`**（Python 3，仅标准库），向 LinkFo"},{"path":"references/onboarding.md","content":"# 解决认证和积分问题\n\n调用本 skill 时若网关返回 **auth** 或 **billing** 错误，走本 skill 自带的 `scripts/onboarding.py` 完成引导。\n\n**auth 场景**：`errcode=401` 或消息含 `authorized error`/`鉴权失败`/`未授权`/`unauthorized`；或 `LINKFOX_AGENT_API_KEY` 与 `LINKFOXAGENT_API_KEY` 均为空。\n1. 若已配置 key → 先让用户重启会话（最常见误判），仍失败让用户重新取 key 或换手机号重注册\n2. 未配置 → 询问：自助去 https://agent.linkfox.com/ 取 key，或提供手机号让脚本注册\n3. 手机号路径：\n - `python scripts/onboarding.py send-code ` → 展示 JSON 里的 phone/agreements\n - 收到验证码后：`python scripts/onboarding.py login `（workbuddy 宿主加 `--channel workbuddy`）\n - 拿到 `api_key` 后把下面三平台配置转发给用户，提示重启会话生效：\n - Windows PowerShell（永久）：`setx LINKFOX_AGENT_API_KEY \"\"`\n - macOS zsh：`echo 'export LINKFOX_AGENT_API_KEY=\"\"' >> ~/.zshrc && source ~/.zshrc`\n - Linux bash：`echo 'export LINKFOX_AGENT_API_KEY=\"\"' >> ~/.bashrc && source ~/.bashrc`\n - 变量名 `LINKFOX_AGENT_API_KEY`（主推）或 `LINKFOXAGENT_API_KEY`（老规范）任一即可\n\n**billing 场景**：`errcode=402` 或消息含 `积分/余额/quota/insufficient/充值/套餐到期`。\n- `python scripts/onboarding.py list-plans` → 有 AskUserQuestion 就弹菜单，否则输出编号清单让用户选\n- 校验 `plan_id` ∈ 清单、支付方式 ∈ 该套餐 `available_methods`（通常 `wechat/alipay`）\n- `python scripts/onboarding.py order ` → 展示优先级 PNG > `pay_url` > `ascii_qr`（标注兜底）\n- 已付款可选调 `python scripts/onboarding.py query `，不主动轮询\n\n排除 `errcode=403`（无权限，不归入这两类）。所有子命令输出 stdout JSON，`error` 字段已含阶段前缀，透传给用户即可。完整用法：`python scripts/onboarding.py --help`。"},{"path":"skill-card.md","content":"## Description:\n\nQueries Temu products through LinkFox using keyword, product or store ID, category, price, rating, review, sales, listing-date, fulfillment, region, and tag filters.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[linkfox-ai](https://clawhub.ai/user/linkfox-ai)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal sellers, ecommerce analysts, and agents use this skill to search and compare Temu products by sales, rating, price, category, fulfillment mode, and listing metadata. It also guides LinkFox authentication and billing recovery when the query service cannot be used.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill sends Temu research queries and authorization credentials to LinkFox services.\n\nMitigation: Install only when LinkFox is trusted for the intended search data and use a scoped LinkFox API key where possible.\n\nRisk: Custom LINKFOX_* endpoint overrides could redirect requests away from the expected LinkFox hosts.\n\nMitigation: Allow endpoint overrides only for trusted HTTPS LinkFox hosts and review environment variables before use.\n\nRisk: Authentication and billing recovery can involve OTPs, API keys, plan selection, and payment order details.\n\nMitigation: Keep OTPs and API keys out of shared logs, verify plans and payment methods before ordering, and rotate any key that may have been exposed.\n\nRisk: Full product-query responses may be cached or written to local linkfox session files.\n\nMitigation: Review or delete local cache and session files after sensitive searches.\n\n## Reference(s):\n\n- [Temu Product Query API Reference](references/api.md)\n- [LinkFox Authentication and Billing Onboarding](references/onboarding.md)\n- [ClawHub Skill Page](https://clawhub.ai/linkfox-ai/skills/linkfox-temu-product-query)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, code, shell commands, configuration, guidance]\n\n**Output Format:** [Markdown guidance, shell commands, and JSON/API result summaries; full product-query responses may be saved as JSON files.]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [The query helper caches responses for up to 24 hours and writes full LinkFox API responses under a local linkfox session directory.]\n\n## Skill Version(s):\n\n1.0.9 (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."}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"按多维度筛选 Temu 商品（关键词/商品 ID/店铺 ID、前后台类目、价格、评分、评论、总/周/日销量、上架时间、全托管/半托管、半托管地区、标签等）。当用户提到 Temu 商品、Temu 选品、拼多多跨境、Temu 爆款、Temu 半托管、全托管商品、Temu product query、temu items 时触发。即使用户未提及工具名，只要在 Temu 上搜商品、看销量/评分/价格或筛品，也应触发此技能。 Skill: Temu商品查询 Owner: linkfox-ai Summary: 按多维度筛选 Temu 商品（关键词/商品 ID/店铺 ID、前后台类目、价格、评分、评论、总/周/日销量、上架时间、全托管/半托管、半托管地区、标签等）。当用户提到 Temu 商品、Temu 选品、拼多多跨境、Temu 爆款、Temu 半托管、全托管商品、Temu product query、temu items 时触发。即使用户未提及工具名，只要在 Temu 上搜商品、看销量/评分/价格或筛品，也应触发此技能。 Tags: latest:1.0.9 Version history: v1.0.9 | 2026-08-14T15:18:07.419Z | user Update from 1.0.8 to 1.0.9 v1.0.8 | 2026-08-07T11:21:25.415Z | user Update from 1.0.7 to 1","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":1147,"uniquenessScore":51,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-10T16:03:43.108Z","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-10T16:03:43.108Z","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-10T21:52:27.303Z","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"}]}}}