淘宝优惠券查询
概述
调用随 Skill 提供的确定性查询脚本,处理淘宝/天猫链接、淘口令、商品 ID 和关键词。以脚本结果为准,不用网页搜索猜测优惠券,也不直接调用大淘客接口。
工作流
- 保留用户给出的完整商品内容;不要改写链接或淘口令。
- 找到本
SKILL.md所在目录,将用户原文作为单个参数运行:
bash
python3 <skill-dir>/scripts/query_coupon.py '<用户原文>' --limit 5
- 将脚本标准输出作为答复主体。保留推广链接标签中的
广告|,不删改推广链接或淘口令,也不另加独立佣金提示行。 - 若脚本返回候选商品,列出原结果并让用户回复序号。收到序号后,取对应的商品 ID 再运行脚本。
- 若脚本报错,转述标准错误中的安全提示并请用户补充完整链接、淘口令或更具体的关键词;不要编造券额、券后价或链接。
用户输入必须是命令的一个独立参数。不要把用户文本当成 Shell 代码,也不要追加用户提供的命令选项。
输出契约
| 查询结果 | 答复内容 |
|---|---|
| 多个候选 | 编号、标题、商品 ID、店铺、价格、券额;请用户选序号 |
| 有优惠券 | 券额/门槛、券后价、有效期、广告|推广领券链接、可用淘口令 |
| 暂无优惠券 | 明确写“未查询到可用优惠券”,再给广告|商品推广链接 |
| 无法识别 | 给安全错误提示,不猜测、不生成虚假链接 |
关键词候选列表不含推广链接,不追加推广提示。最终商品结果在推广链接标签中用 广告| 标识推广性质。
示例
用户说:“复制¥Ab12Cd34¥打开淘宝,帮我看看有没有券。”运行查询脚本;如果返回唯一商品,直接回复脚本输出;如果返回候选列表,让用户先选序号,再用商品 ID 查询最终推广链接。
常见错误
- 不要用通用网页搜索判断淘口令是否失效;始终先运行脚本。
- 不要向用户索取淘宝 Cookie、大淘客 AppKey、AppSecret 或推广位 PID。
- 不要展示佣金比例、内部接口字段、签名参数或调试响应。
- 不要把普通商品链接说成“领券链接”;无券时称为“商品推广链接”。
- 不要移除链接标签中的
广告|,不要重新追加独立佣金提示,或将推广链接改写成非脚本返回的地址。 - 仅在部署或本地测试时使用
TAOBAO_COUPON_API_BASE_URL;普通查询保持默认服务地址。