TTokenySpace
返回 Skills 列表

Shopee-店铺折扣

Shopee(虾皮)店铺折扣促销 Discount(与 linkfox-shopee-store-auth 同系列),经 /shopee/developerProxy 转发 Shopee Open API Discount 模块全部 12 个接口:add_discount、get_discount_list、up...

#中文
0

安装到 Tokeny(自动)

下载 ZIP
安装"linkfox-shopee-store-discount"技能
技能信息:
- 名称: Shopee-店铺折扣
- 标识: linkfox-shopee-store-discount
- 描述: Shopee(虾皮)店铺折扣促销 Discount(与 linkfox-shopee-store-auth 同系列),经 /shopee/developerProxy 转发 Shopee Open API Discount 模块全部 12 个接口:add_discount、get_discount_list、up...
- 版本: 1.0.0
下载地址:
https://www.tokeny.space/api/skills/linkfox-shopee-store-discount/download
继续

复制上方内容到 Tokeny 客户端并在会话中发送即可自动安装;也可直接 下载 ZIP并拖动到技能窗口安装。

SKILL.md

Shopee 店铺 Discount

Shopee Open Platform Discount 模块(12 个 API)。依赖 linkfox-shopee-store-auth:先取 accessToken,再经 POST /shopee/developerProxy 转发(pathapi/v2/discount/...)。

调用方式

  • API 端点POST /shopee/developerProxy(不同操作通过请求体区分;完整参数/响应/错误码见 references/api.md
  • Python 脚本python scripts/<脚本名>.py '<JSON 参数>' [--inline](可用脚本见上文脚本一览)
  • 成本约束:本工具会消耗积分;失败/空结果不得自动换关键词、翻页或连续试探;需要继续检索时先向用户说明会产生额外消耗。

输出策略(脚本默认行为)

  • 始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-shopee-store-discount-<timestamp>.json<cwd> 为脚本执行时的工作目录,在 Claude Code 里即当前项目目录;<session> 取自环境变量 SESSION_ID,按用户任务自动聚合;禁止写入 /tmp,当前目录不可写则报错)
  • 响应体 ≤ 8 KB:落盘后把完整 JSON 打印到 stdout
  • 响应体 > 8 KB:落盘后 stdout 只输出摘要(顶层字段、常见计数如 total/costToken、最大列表字段的长度 + 前 3 条样本)
  • --inline 强制全量打印到 stdout(同样落盘)

读数据建议:先看摘要判断是否足够;需要具体字段时优先用 jqConvertFrom-Json 从保存的 json 文件按需抽取,避免整份 JSON 进入上下文。

解决认证和积分问题

发生以下异常情况时,采用以下措施来处理:

异常情况

  • 未配置API Key:环境变量未配置 LINKFOX_AGENT_API_KEY,也未配置 LINKFOXAGENT_API_KEY
  • 响应401或402状态码
  • 响应提示积分或余额不足:消息含"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值",或类似含义的内容。

措施

官方参考

Discount 模块索引:v2.discount.add_discount


Prerequisites

  1. 运行 python scripts/check_auth_dependency.py;exit code 42 → 先安装 linkfox-shopee-store-auth
  2. Bundle Deal / Voucher 等其它促销模块 → 非本 skill。

可用脚本(12 个 API)

脚本APIMethod
add_discount.pyadd_discountPOST
add_discount_item.pyadd_discount_itemPOST
get_discount_list.pyget_discount_listGET
get_discount.pyget_discountGET
update_discount.pyupdate_discountPOST
update_discount_item.pyupdate_discount_itemPOST
end_discount.pyend_discountPOST
delete_discount.pydelete_discountPOST
delete_discount_item.pydelete_discount_itemPOST
get_sip_discounts.pyget_sip_discountsGET
set_sip_discount.pyset_sip_discountPOST
delete_sip_discount.pydelete_sip_discountPOST
discount_api.py通用入口

Usage Scenarios

1. 创建折扣活动

  1. add_discount.py 传完整 body(名称、时间、折扣类型等)
  2. add_discount_item.py 添加参与商品
  3. get_discount_list.py 确认活动状态

2. 管理现有活动

  • get_discount.py 查详情
  • update_discount.py / update_discount_item.py 修改
  • end_discount.py 提前结束

Not Applicable

  • 店铺授权 → linkfox-shopee-store-auth
  • Bundle Deal / Voucher / Add-On Deal / Shop Flash Sale / Follow Prize → 其它促销模块 skill(Bundle Deal → linkfox-shopee-store-bundle-deal;Add-On Deal → linkfox-shopee-store-add-on-deal;Voucher → linkfox-shopee-store-voucher;Shop Flash Sale → linkfox-shopee-store-shop-flash-sale;Follow Prize → linkfox-shopee-store-follow-prize
  • 商品 listing → linkfox-shopee-store-product

积分消耗规则

不消耗积分。

Feedback:references/api.md


For more high-quality, professional cross-border e-commerce skills, visit LinkFox Skills.

评论

加载中…