用途：查询西柚找词（西柚洞察）的亚马逊 ASIN 与关键词数据，经 LinkFox 工具网关转发至西柚 OpenAPI（https://openapi.xiyouzhaoci.com），用于反查流量词、竞品分析与选词辅助。
主要能力：提供 ASIN 维度与关键词维度的流量、排名、ABA、竞争度数据。典型接口包括 asinTraffic（批量 ASIN 近 7 天流量得分）、asinInfo、asinResearchPeriod/asinResearchMonthly（ASIN 反查关键词）、searchTermAnalysisPeriod（词下 ASIN 分析）、searchTermInfo（ABA、竞争度、CPC）、searchTermAbaWeeklyTrend、asinSearchTermTrafficTrend、asinSearchTermRankTrendDaily/Hourly、asinTrafficScoreTrend、asinBsrTrend、asinOrdersTrend、asinVariations 等 17 个接口，完整清单见 --list-apis 与 references/api.md。
支持站点：country 用 2 位大写代码，US、CA、MX、BR、UK、DE、ES、IT、FR、JP、AU、SA、AE，默认 US；asinSearchTermRankTrendHourly 仅支持 US、UK、DE。
使用方式：调用 API 端点 POST /xiyou，或运行 python scripts/xiyou.py '<JSON 参数>' [--inline]。须同时配置三组环境变量：LINKFOXAGENT_API_KEY、XIYOU_CLIENT_ID（16 位）、XIYOU_CLIENT_SECRET（24 位），脚本会自动注入后两者，调用时不要在 --params 重复传 clientId/clientSecret。密钥仅通过环境变量提供，勿提交到 Git 或写入聊天记录。查询可用 asin、searchTerm、country、startDate/endDate、startMonth/endMonth、page/pageSize、sortField/sortOrder 等参数。
输出与成本：完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/ 下的 JSON 文件；响应 ≤8 KB 打印完整 JSON，>8 KB 仅打印摘要，--inline 可强制全量打印。本工具消耗积分，失败或空结果不得自动换词、翻页或试探，继续检索前应先告知用户可能产生额外消耗。
限制：须同时具备 LinkFox Key 与西柚 Client 凭证；批量 ASIN 的 entities 最多 100 个，searchTerms 逗号分隔最多 100 个词；不适用于非亚马逊平台、Jungle Scout/卖家精灵等其它数据源、SP-API 订单库存、Temu/Shopee 选品。