用途:面向 Shopee(虾皮)联盟营销 AMS(Affiliate Marketing Solutions)模块,覆盖 36 个 API,用于管理开放推广(Open Campaign)与定向推广(Targeted Campaign)、达人(Affiliate)列表、佣金建议与效果报表。
主要能力:Open Campaign 商品查询与批量增删、设置编辑;Targeted Campaign 创建、编辑达人/商品列表、终止、设置与效果查询;达人推荐与查询、达人效果;店铺/商品/内容/转化等效果报表;店铺与商品建议佣金率;自动添加新品开关;校验列表与报告等。
使用方式:先运行 python scripts/check_auth_dependency.py,exit code 42 时需先安装 linkfox-shopee-store-auth 并授权店铺;本技能不实现授权/令牌逻辑。调用端点 POST /shopee/developerProxy,传入 shopId(或 merchantId),path 须为 api/v2/ams/...,由服务端解析 token 转发。脚本用法:python scripts/<脚本名>.py '<JSON 参数>' [--inline];通用入口 ams_api.py(JSON 含 api 字段)。GET 业务参数放 JSON 顶层,POST 复杂接口传 body;先看 developerProxy.httpStatus 再读 *Response 字段。
输出与限制:完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/ 下 JSON 文件,禁止写入 /tmp;响应 ≤8 KB 打印完整 JSON,>8 KB 只输出摘要,--inline 强制全量打印。失败或空结果不得自动换关键词、翻页或连续试探,需继续检索应先向用户说明额外消耗。未配置 LINKFOX_AGENT_API_KEY 或 LINKFOXAGENT_API_KEY、响应 401/402、提示算力或余额不足时,按 references/onboarding.md 处理。本技能不消耗算力。AMS 为联盟营销/达人带货,站内 CPC 广告见 linkfox-shopee-store-ads;店铺授权、商品 listing、店铺视频、订单分别由同系列其他技能负责。