linkfox-amazon-alexa-search
通过亚马逊前台 Alexa 购物助手进行自然语言导购问答,获取回答、分组推荐商品、ASIN、链接及追问建议。适用于有预算或用途要求的商品推荐、比较已有推荐、结合具体页面提问和持续追问,无需明确提及 Alexa。不适用于完整搜索结果提取、历史关键词统计、已知 ASIN 的完整详情、逐条评论分析或图片找同款。
SKILL.mdskills/linkfox-amazon-alexa-search/SKILL.md
GitHub亚马逊 Alexa 购物助手
适用范围
适用
用户希望在亚马逊前台用自然语言提出购物需求,获得推荐并继续追问时,使用本技能。
场景速查
| 用户表达 | 查询场景 |
|---|---|
| 用 Alexa 帮我推荐跑步耳机 | 自然语言导购问答。 |
| 在亚马逊找适合某用途、某预算的商品 | 结合用途、预算和功能要求推荐。 |
| 顺便再追问一下,接着问 | 总结已有回答,再发起追问。 |
| 基于这个页面或分类推荐商品 | 结合具体页面上下文提问。 |
| 对比 Alexa 给的前两个推荐 | 根据已有推荐开展比较。 |
| Alexa 还能继续问什么 | 展示返回的追问建议。 |
边界
完整 SERP、排名和广告标记使用前台搜索技能;历史搜索词及搜索量趋势使用 ABA 数据技能;已知 ASIN 的完整详情、A+ 和五点描述使用商品详情技能;逐条评论情感分析使用评论技能;图片找同款使用以图搜图技能。对扁平商品表做聚合统计也不属于本技能范围。
前置条件
先确定用户的购物问题;将用户已提供的站点、使用场景、预算和硬性功能要求纳入问题,不要求每次补齐这些条件。已有回答或具体页面时保留相关上下文。参数与使用限制见 references/api.md。
查询流程
- 将站点、用途、预算和硬性要求放在问题开头,让 Alexa 优先理解用户意图。
- 用户追问时,先总结上一轮回答的关键结论、推荐商品和 ASIN,再拼接新问题;上下文传递方式和长度限制见
references/api.md,不要假设 Alexa 记得上次回答。 - 用户围绕某个具体页面提问时,结合页面上下文;常规导购直接提问。页面与输出格式的选择要求见接口定义。
- 仅展示回答时选择可读报告;后续需要提取 ASIN、价格或追问内容时选择结构化结果。
- 调用后先判断响应状态,再展示导购回答、推荐商品组和可继续追问的问题。出现空结果或错误时,按接口定义解释原因;继续检索须遵守成本约束。
执行方式
- 直接调用接口:接口端点、完整参数、响应和错误码见
references/api.md。 - 脚本调用(推荐):
python scripts/amazon_alexa_search.py '<JSON 参数>' [--inline]。 - 成本约束:本工具按对话轮次计费,具体规则见“算力消耗预估”。同一会话、同一参数组合默认只调用一次,脚本提供 24 小时本地缓存。失败或空结果时,不得自动更换关键词、翻页或修改邮编连续试探;需要继续检索时,先向用户说明额外消耗。
输出策略
- 始终保存完整响应,目标路径为
<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-amazon-alexa-search-<timestamp>.json。<cwd>为脚本运行时的工作目录,<session>优先取环境变量SESSION_ID,用于聚合同一任务的数据。禁止写入/tmp,当前目录不可写时应报错。 - 响应体不超过 8 KB:保存后,将完整 JSON 打印到标准输出。
- 响应体超过 8 KB:保存后,标准输出仅展示摘要,包括顶层字段、常见计数(如
total、costToken)、最大列表字段的长度和前 3 条样本。 - 添加
--inline可强制全量打印到标准输出,同时仍保存文件。
先通过摘要判断数据是否足够。需要具体字段时,优先使用 jq 或 ConvertFrom-Json 从保存的 JSON 文件按需提取,避免将整份响应载入上下文。
执行规则
算力消耗预估
按对话轮次动态计费,预估 13 算力/轮(¥0.13/轮)。
重要:本技能的服务按倍数动态计算,可能一次性消耗大量算力,必须提醒用户,由用户决定是否继续。
声明:算力消耗以实际扣除为准;如因需要调整算力消耗标准,恕不另行通知。最终解释权归 LinkFox 官方所有。
用户会因算力消耗而支付费用。需要高频调用或用户对消耗量预期不足时,提醒用户,并由用户决定是否继续。
解决认证和算力问题
出现以下情况时,按 references/onboarding.md 的指引处理:
- 未配置接口密钥:
LINKFOX_AGENT_API_KEY和LINKFOXAGENT_API_KEY均为空。 - 响应状态码为
401或402。 - 响应提示算力或余额不足、计费不足、配额超限、套餐到期或需要充值。英文错误消息也按其含义判断。
约束与建议
- 理解会话含义:Alexa 给出的是对话式回答和少量精选推荐。每次请求是新会话,追问由本技能总结上下文后重新提问;这不是完整搜索结果提取或扁平表聚合分析工具。
- 保留报告结构:可读报告直接按返回的问题标题、回答、商品组和追问结构呈现。
- 展示商品分组:保留推荐分组,展示商品标题、ASIN、价格、评分、评价数量和商品链接;存在截图或简述时按需展示,不补造缺失信息。
- 展示追问建议:列出 Alexa 返回的可继续追问问题。用户选择后,按查询流程总结当前回答,再发起新的追问。
- 说明结果时效:回答会随时间、流量及上下文变化,同样问题可能得到不同推荐;用户关心时间时,注明回答反映调用时的情况,缓存命中时说明复用了保存结果。
- 解释空结果与业务错误:按
references/api.md判断并展示可用错误消息;可建议简化问题或结合具体页面重问,遵守成本约束,不自动连续试探。
使用示例
单轮购物推荐
{"prompts": ["best wireless earbuds for running on Amazon US under $100"]}
总结上下文后追问
先询问电热水壶推荐:
{"prompts": ["best electric kettle on Amazon US"]}
若上一轮实际返回以下商品,可总结后追问(商品和价格仅为示例,实际使用响应中的值):
{"prompts": ["上轮推荐:Cosori 电热水壶(B07T1KY5TZ,$35.99,4.7星)和 Mueller Ultra 电热水壶(B09KC7D3HR,$29.97,4.5星)。请比较二者的噪声和烧水时间。"]}
结合具体页面提问
{"prompts": ["这个页面有哪些热门推荐?"], "url": "https://www.amazon.com/s?k=electric+kettle"}
获取结构化推荐
{"prompts": ["best gift ideas for a 10-year-old who likes science"], "format": "json"}
使用反馈
当技能有BUG,或技能描述有错误/疏漏/歧义/表述模糊,或技能结果与用户预期不符,或用户表达不满/赞扬,或发现其他可改进之处时,按 references/api.md#Feedback 的指引反馈,不要打断用户当前流程。
更多优质、专业的跨境电商技能,请访问 LinkFox Skill。