Linkfox Geekbi Temu Shop

Temu Shop Discovery & Benchmarking

This skill searches public Temu marketplace shops for competitor discovery and store-level benchmarking. Use only the endpoints needed for the user's request, and read references/api.md for the complete request and response contract.

The site-list and category-list endpoints are helper capabilities for shop search. A request solely for site or category metadata must not auto-select this skill. If the user explicitly invokes this skill, or the skill is already active, either helper may be called independently.

Endpoints

/geekbi/temu/mallSearch

Request

• regionId selects the marketplace. Resolve it from a non-null positive sites[].regionId; never substitute siteId.
• catIds is an integer array of shop category IDs. Populate it only from valid categories[].catId values.
• Shop search returns paginated items[]. The default marketplace is regionId: 211 (United States), with page: 1 and size: 20.
• regionId, page, and size select the marketplace and page. size is 1–200 and page * size must not exceed 10,000.
• keyword matches the shop name. catIds is an integer array, not a comma-separated string.
• Range filters use paired *Min / *Max fields for mallSold, mallSales, mallStar, reviewNum, goodsNum, followerNum, and avgPrice. Never make a minimum greater than its maximum.
• mallStarMin/Max must remain within 0–5. hostingMode is 1 (full-managed) or 2 (semi-managed).
• mallOpenTimeMin/Max use ISO-8601 date-time strings. If both are supplied, both must parse and the minimum must not exceed the maximum.
• order is asc or desc. Use a sort field only after the API or an established workflow confirms it.

Response

/geekbi/temu/siteList

Request

• Site list takes {}. Reuse only a non-null positive sites[].regionId, never siteId.

Response

/geekbi/temu/categoryList

Request

• parentCatId drills into the category tree. Omit it for top-level categories, then reuse a returned catId to fetch children.
• Category list takes {} for top-level categories or {"parentCatId": <catId>} for children. Reuse only a non-null valid catId.

Response

Shared Workflow Rules

• Use site/category helpers only when the user has not already supplied a valid ID. Do not run a paid search merely to answer a helper-only request.
• Stop and explain when no valid helper ID is returned; do not guess an ID or launch the shop search with a mismatched site/category.

Business fields may be absent or null. Preserve the runtime JSON type and do not replace missing values with zero.

调用方式

• API 端点：POST /geekbi/temu/mallSearch、POST /geekbi/temu/siteList 或 POST /geekbi/temu/categoryList（完整参数/响应/错误码见 references/api.md）
• Python 脚本：python scripts/geekbi_temu_mall_search.py '<JSON 参数>' [--inline]、python scripts/geekbi_temu_site_list.py '{}' [--inline] 或 python scripts/geekbi_temu_category_list.py '<JSON 参数>' [--inline]
• 成本约束：店铺搜索消耗 15 算力/次，站点/品类列表不消耗算力；同一端点同一参数组合使用 24h 本地缓存，同一会话默认只调用一次。--inline 不绕过缓存；--no-cache 会跳过缓存读写并强制真实请求，付费端点可能再次扣算力，免费辅助端点仅强制刷新。失败、空结果或瞬时错误不得自动重试，也不得自动换关键词、翻页、改站点或筛选条件连续试探；需要继续付费检索时先向用户说明会产生额外消耗。

输出策略（脚本默认行为）：

• 始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-geekbi-temu-shop-<timestamp>.json；<cwd> 为脚本执行时的当前工作目录，<session> 取自环境变量 SESSION_ID，未设置时自动生成。当前目录不可写时直接报错，不回退到用户目录或系统临时目录。
• 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout
• 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层状态字段、常见业务计数、忽略 columns 后最大业务列表的长度 + 前 3 条样本）
• 加 --inline 强制全量打印到 stdout（同样落盘）

读数据建议：先看摘要判断是否足够；需要具体字段时优先用 jq或ConvertFrom-Json 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。

解决认证和算力问题

发生以下异常情况时，采用 references/onboarding.md 引导解决问题：

异常情况

• 未配置 API Key：环境变量未配置 LINKFOX_AGENT_API_KEY 或兼容键 LINKFOXAGENT_API_KEY。
• 响应 401 或 402 状态码。
• 响应提示算力或余额不足：消息含“算力余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值”或类似含义。

Usage Examples

# Resolve regionId (use sites[].regionId, not siteId)
python scripts/geekbi_temu_site_list.py '{}'

# Browse top-level categories, then fetch one node's children
python scripts/geekbi_temu_category_list.py '{}'
python scripts/geekbi_temu_category_list.py '{"parentCatId":1}'

# Verified non-empty US shop search
python scripts/geekbi_temu_mall_search.py '{"regionId":211,"page":1,"size":3,"mallStarMin":4}'