Back to Details

linkfox-ehunt-shopify-product-query

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

EHunt Shopify 商品查询（
ehunt/shopify/productQuery
）

EHunt Shopify 商品查询（
ehunt/shopify/productQuery
）

在具备 LinkFox「第三方数据服务」MCP 时，对应网关路由 
ehunt/shopify/productQuery
 调用（MCP 展示名：Shopify 商品查询，确切工具名以当前环境下发的工具元数据为准）。鉴权与上游路由由网关处理；若响应含根级 
code
字段，是否成功以实网为准。
当拥有 LinkFox「第三方数据服务」MCP 时，可调用对应网关路由 
ehunt/shopify/productQuery
（MCP 展示名称：Shopify 商品查询，具体工具名称以当前环境下发的工具元数据为准）。鉴权与上游路由由网关负责处理；若响应包含根级 
code
字段，是否调用成功以实际网络情况为准。

要点

要点

  • 分页：
    page
    从 1 起；
    pageSize
    默认 20、最大 100（建议 ≤50）。
  • 区间入参：
    *Min
    / 
    *Max
    成对出现，组成上游区间；只填一侧时上游为「起始~」或「~结束」。
  • 排序：
    sortBy
    为整数枚举（默认 
    14
    =周销量降序，另含价格/广告数/竞争度/销售额等多种取值，详见 
    references/api.md
    ）。
  • 布尔类筛选：
    facebookAd
    （1=有广告）、
    hasSupplier
    （1=有货源，0=无）、
    showDeleted
    （1=含已下架）均为整数开关。
  • 发货国家：
    country
    传两位国家代码（如 
    US
    ）。
  • 分页：
    page
    从1开始；
    pageSize
    默认值为20，最大值为100（建议设置≤50）。
  • 区间入参：
    *Min
    / 
    *Max
    需成对传入，组成上游查询区间；仅填写一侧时，上游查询范围为「起始值~」或「~结束值」。
  • 排序：
    sortBy
    为整数枚举类型（默认值 
    14
    =周销量降序，还包含价格/广告数量/竞争度/销售额等多种取值，详情请见 
    references/api.md
    ）。
  • 布尔类筛选：
    facebookAd
    （1=有广告）、
    hasSupplier
    （1=有货源，0=无货源）、
    showDeleted
    （1=包含已下架商品）均为整数开关参数。
  • 发货国家：
    country
    参数传入两位国家代码（例如 
    US
    ）。

脚本（可选）

脚本（可选）

命令行调试：
python scripts/ehunt_shopify_product_query.py '<JSON>'
（需 
LINKFOXAGENT_API_KEY
）。详见 references/api.md 末尾。
命令行调试：
python scripts/ehunt_shopify_product_query.py '<JSON>'
（需要配置 
LINKFOXAGENT_API_KEY
）。详情请查看 references/api.md 末尾内容。

参考

参考

入参/出参表见 references/api.md。
<!-- LF_LARGE_RESPONSE_BLOCK -->
入参/出参表请查看 references/api.md。
<!-- LF_LARGE_RESPONSE_BLOCK -->

Handling Large Responses

处理大响应数据

To avoid overflowing the agent context, persist the response to disk and extract only the fields you need:
python scripts/response_io.py run --script scripts/ehunt_shopify_product_query.py --out-dir <DIR> '<params>'
python scripts/response_io.py read <file> --fields "<paths>"   # or --path "<JMESPath>"
Pick 
--out-dir
outside any git working tree (e.g. 
/tmp/...
on Unix, 
%TEMP%/...
on Windows). Persisted responses may contain PII, pricing, or auth-sensitive data — do not commit them. Files are not auto-deleted; clean up when the task is done.
run
writes the full response to a file and emits only a schema preview + file path. 
read
projects specific fields, with 
--limit/--offset
for slicing and 
--format json|jsonl|csv|table
for output.
When to prefer this pattern — apply your judgment based on the response characteristics, e.g.:
  • High field count per record, or fields you don't need
  • Batch/paginated results (multiple items per call)
  • Long-text fields (descriptions, reviews, HTML, time series)
  • Output reused across later steps rather than consumed immediately
For small, single-use responses, calling the main script directly is fine.
⚠️ The preview is a truncated schema + sample, not the full data. Any field-level decision must read from the persisted file via 
read
.
<!-- /LF_LARGE_RESPONSE_BLOCK -->
为避免超出 Agent 上下文限制，请将响应数据持久化到磁盘，并仅提取所需字段：
python scripts/response_io.py run --script scripts/ehunt_shopify_product_query.py --out-dir <DIR> '<params>'
python scripts/response_io.py read <file> --fields "<paths>"   # 或使用 --path "<JMESPath>"
请将 
--out-dir
设置在任何 Git 工作区之外（例如 Unix 系统的 
/tmp/...
，Windows 系统的 
%TEMP%/...
）。持久化的响应数据可能包含个人身份信息（PII）、定价或敏感鉴权数据——请勿将其提交到版本库。文件不会自动删除，任务完成后请自行清理。
run
命令会将完整响应写入文件，仅输出 schema 预览 + 文件路径。
read
命令可提取指定字段，支持通过 
--limit/--offset
进行切片，以及通过 
--format json|jsonl|csv|table
指定输出格式。
何时优先使用此方式——根据响应数据的特性判断，例如：
  • 每条记录字段数量多，或包含不需要的字段
  • 批量/分页结果（单次调用返回多个条目）
  • 长文本字段（描述、评论、HTML、时间序列等）
  • 输出结果需在后续步骤中重复使用，而非立即消耗
对于小型、单次使用的响应数据，直接调用主脚本即可。
⚠️ 预览内容是截断的 schema + 示例，并非完整数据。任何字段级别的操作都必须通过 
read
命令从持久化文件中读取。
<!-- /LF_LARGE_RESPONSE_BLOCK -->