mcpField
L
linkfox-temu-store-query

linkfox-temu-store-query

github.com/linkfox-aiMarketing & growth113228 installsUpdated 2w ago
Repository

About linkfox-temu-store-query

A LinkFox skill for querying Temu shops through the third-party data service, with filters for sales, revenue, ratings, site, category and shop attributes. Results can be sorted and paginated; usage is billed dynamically by returned shop count.

Key features

  1. 01Filter shops by metric ranges
  2. 02Select country sites and categories
  3. 03Filter by fulfillment mode and opening date
  4. 04Sort and paginate results

Use cases

  1. 01Find shops within sales or revenue ranges
  2. 02Filter shops by country site or category
  3. 03Compare shops by ratings or product counts

MCP support

The skill uses the LinkFox third-party data service MCP gateway route `ehunt/temu/storeQuery`. The gateway handles authentication and upstream routing.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/linkfox-ai/linkfox-skills --skill linkfox-temu-store-query

After installing, type/linkfox-temu-store-queryin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
api.md
onboarding.md
scripts/
onboarding.py
temu_store_query.py

Details

From the project README

Temu 店铺查询

在具备 LinkFox「第三方数据服务」MCP 时,对应网关路由 ehunt/temu/storeQuery 调用(MCP 展示名:Temu 店铺查询,确切工具名以当前环境下发的工具元数据为准)。鉴权与上游路由由网关处理;若响应含根级 code 字段,是否成功以实网为准。

要点

  • 分页:page 从 1 起;pageSize 默认 20、最大 100。
  • 区间入参:*Min / *Max 成对出现(总/周/月销量、总/周/月销售额、评分、评论、粉丝、商品数),组成上游区间。
  • 站点:siteId 国家站点 ID,多个逗号分隔(如 211=美国、76=英国)。
  • 类目:category 后台类目 ID,多个逗号分隔。
  • 托管模式:isLocal(0=全托管,1=半托管,字符串)。
  • 开店时间:listedTimeBegin / listedTimeEnd(YYYY-MM-DD)。
  • 排序:sortBy 为「字段-方向」字符串,如 order_week_count-0(周销量降序,默认)、order_count-0、total_revenue-0、rating-0。

脚本(可选)

命令行调试:python scripts/temu_store_query.py '<JSON>'(需 LINKFOXAGENT_API_KEY)。详见 references/api.md 末尾。

参考

入参/出参表见 references/api.md。

解决认证和算力问题

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

异常情况
  • 未配置API Key:环境变量未配置 LINKFOX_AGENT_API_KEY,也未配置 LINKFOXAGENT_API_KEY。
  • 响应401或402状态码
  • 响应提示算力或余额不足:消息含"算力余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值",或类似含义的内容。

算力消耗规则

按动态规则计费:消耗算力 = 店铺数量 × 1.8。按本页返回条数计费;翻到下一页,本质上是再发一次请求,再按下一页返回条数重新计算。

重要:本技能的服务按倍数动态计算,可能一次性消耗大量算力,必须提醒用户,由用户决定是否继续。

Comments

Markdown supported