用途
linkfox-amazon-search 用于模拟真实用户在亚马逊前台进行搜索，获取实时搜索结果页数据，帮助亚马逊卖家了解关键词下的商品排名、价格、评分、评论数、品牌、配送信息及广告标识等。
主要能力
该技能返回来自亚马逊前台的实时搜索结果页（SERP）数据，包含商品列表及其在搜索页中的位置、价格、评分、评论数、品牌、配送信息和 sponsored 广告标识。它强调与 ABA 数据的区别：ABA 数据是聚合的历史搜索词分析数据，而本工具返回的是用户在亚马逊当前搜索某关键词时实际看到的商品列表。
支持的站点包括美国、英国、德国、法国、意大利、西班牙、日本、加拿大、澳大利亚、巴西、印度、荷兰、瑞典、波兰、新加坡、沙特阿拉伯、阿联酋、墨西哥、土耳其、比利时、中国、埃及等亚马逊域名。未指定时默认使用 amazon.com。
使用方式
可通过两种方式调用：
- API 端点：POST /amazon/search（完整参数、响应与错误码见 references/api.md）
- Python 脚本：python scripts/amazon_search.py '<JSON 参数>' [--inline]
主要参数包括：keyword（搜索关键词，需翻译为目标站点语言）、amazonDomain（站点域名，默认 amazon.com）、node（分类节点 ID）、language（语言区域代码，如 en_US、de_DE、ja_JP）、sort（排序方式）、page（页码，从 1 开始，每页约 20 条结果）、deliveryZip（配送邮编）、device（设备类型：desktop、mobile 或 tablet，默认 desktop）。
排序可选值：relevanceblender（相关性，默认）、price-asc-rank（价格从低到高）、price-desc-rank（价格从高到低）、review-rank（平均客户评分）、date-desc-rank（最新上架）、exact-aware-popularity-rank（畅销）。
脚本默认会将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-amazon-search-<timestamp>.json；响应体小于等于 8 KB 时打印完整 JSON 到 stdout，大于 8 KB 时仅输出摘要（顶层字段、常见计数、最大列表字段长度及前 3 条样本）。加 --inline 可强制全量打印（同样落盘）。建议先看摘要，再用 jq 或 ConvertFrom-Json 从保存的 JSON 文件中按需抽取具体字段，避免整份 JSON 进入上下文。
适用场景
适用于需要实时亚马逊搜索结果的查询，例如：在亚马逊搜索某商品、查询某关键词下出现哪些商品、查询自己的 ASIN 在某关键词下的排名位置、查看某关键词的头部结果、了解某关键词的价格区间、分析某关键词的广告商品、监控某关键词的新品、在德国/日本/英国等站点搜索、发现某关键词的畅销商品、对比移动端与桌面端的搜索结果等。
不适用于：历史搜索词量或排名趋势（应使用 ABA 数据）、广告活动管理或出价优化、商品评论分析或情感分析、销量估算或收入分析、listing 优化或文案建议、库存或供应链数据。
限制
该工具仅返回实时搜索结果，不提供历史数据。每次调用模拟一次真实搜索请求，应避免过度频繁调用。每页返回约 20 条商品结果。结果质量取决于是否使用了目标站点的正确语言关键词。发生未配置 API Key、响应 401/402 状态码、提示算力或余额不足等异常时，需参照 references/onboarding.md 引导解决。
算力与成本
每次调用消耗 15 算力，用户会因算力消耗而支付费用。当需要高频调用本技能，或用户对算力消耗量预期不足时，务必提醒用户，由用户决定是否继续。同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败或空结果时不得自动更换关键词、翻页或修改邮编连续试探；需要继续检索时应先向用户说明会产生额外消耗。
展示规则
应以结构化表格展示搜索结果，突出位置、ASIN、标题、价格、评分、评论数、品牌等关键字段；明确标注 sponsored 广告商品与自然结果；按站点使用正确货币符号格式化价格；提醒用户位置反映的是搜索页上的实际排名；结果跨多页时告知用户总结果数并建议是否获取更多页；查询失败时根据错误响应解释原因并建议调整参数；如有图片链接可提及，但除非用户要求，不要内联渲染。