淘宝查券

要解决的具体问题

在淘宝、天猫找优惠券时，常见做法是把链接或淘口令丢给网页搜索，靠摘要猜测券额、券后价和有效期。这类判断很容易失真：淘口令可能被改写，搜索结果可能来自其他商品，券额和门槛也可能凭经验估算。对需要稳定输出的自动化流程来说，缺一个可复用、可预期的查询边界。

核心能力与工作方式

淘宝查券 只维护一条确定性路径：把用户提供的完整商品内容交给随 Skill 提供的查询脚本，脚本标准输出就是答复主体。输入可以是淘宝/天猫链接、淘口令、商品 ID 或关键词；技能不改写链接或淘口令，也不把用户文本当 Shell 代码执行。

关键步骤很直接：先完整保留用户原文，再在 SKILL.md 所在目录运行脚本，并把用户文本作为单个参数传入。若脚本返回多个候选商品，会列出编号、标题、商品 ID、店铺、价格、券额，让用户回复序号；收到序号后，再用对应商品 ID 查询最终推广链接。若脚本直接返回结果，就保留脚本输出中的券额/门槛、券后价、有效期、广告｜推广领券链接和可用淘口令。

输出契约与适用边界

查询结果按脚本返回内容分四类：多个候选时只展示候选列表并请用户选序号；有优惠券时展示券额/门槛、券后价、有效期和推广领券链接；暂无优惠券时明确写「未查询到可用优惠券」，再给 广告｜商品推广链接；无法识别时只给安全错误提示，不猜测、不生成虚假链接。关键词候选列表不含推广链接，也不追加独立佣金提示。

注意点包括：不要用通用网页搜索判断淘口令是否失效，也不要直接调用大淘客接口；不要向用户索取淘宝 Cookie、大淘客 AppKey、AppSecret 或推广位 PID；不要展示佣金比例、内部接口字段、签名参数或调试响应；不要把普通商品链接说成「领券链接」，也不要移除推广链接标签中的 广告｜。普通查询保持默认服务地址，TAOBAO_COUPON_API_BASE_URL 仅用于部署或本地测试。