用途：在 Temu 平台按选品、类目、销量、价格、评分、履约方式或上架活跃度等条件检索、筛选和排序商品。适用于按价格/销量/评论/评分/上架日期/标签/履约模式寻找选品思路，查询半托管商品或特定区域机会，以及为产品想法寻找可比商品。单元分析对象是单个商品；若需卖家/店铺排名应改用 ecommerce.temu-store-query，且不适用于 TikTok Shop、Amazon 商品、专利检索或 listing 关键词优化。
主要能力：调用 EHunt 商品数据（经 Nexscope 代理网关，路由 /api/v1/tools/research/ehunt/temu/productQuery）。支持分页（page 从 1 开始，pageSize 默认 20、最大 100）；*Begin/*End 成对范围参数（价格、评分、评论、总/周/日销量、发布时间）；categoryHome（前台类目 ID）与 categoryBackend（后台类目 ID）；isLocal（0 全托管、1 半托管）与 region；soldOut（0 在售、1 下架）；tags 与 customTags（逗号分隔）；sortBy 为“字段-方向”字符串，如 order_week-0（默认周销量降序）、price-0、order_total-0、rating-0。用户给类目名称时，先调用类目搜索脚本解析为 ID。
用法：脚本 scripts/ehunt_temu_product_query.py 为 CLI 调试工具，向代理网关 POST JSON。响应较大时可用：python scripts/response_io.py run --script scripts/ehunt_temu_product_query.py --out-dir <DIR> '<params>'，再用 python scripts/response_io.py read <file> --fields "<paths>"（或 --path "<JMESPath>"）投影字段，支持 --limit/--offset 与 --format json|jsonl|csv|table。输出默认含查询假设与筛选、商品表（标题/ID、站点区域、类目、价格、销量、营收、评分、评论、标签、履约模式、上架状态）、关键观察与建议下一步。
限制：需环境变量 NEXSCOPE_PROXY_BASE 与 NEXSCOPE_API_KEY，认证与路由由网关处理；若响应含根级 code 字段，以实际响应判断成功。持久化文件可能含 PII、价格或认证敏感数据，勿提交、勿放入 git 工作树，任务结束需清理，文件不会自动删除；预览仅为截断的 schema 与样本，字段级判断须读取持久化文件。参数细节见 references/api.md。