用途:查询 Shopee 店铺账户健康数据,覆盖 Account Health 模块全部 6 个 GET 接口,用于查看店铺健康概况、定位问题订单与 listing、查询扣分与处罚记录。
主要能力(脚本与 API):get_shop_performance.py(get_shop_performance)、get_metric_source_detail.py(get_metric_source_detail)、get_penalty_point_history.py(get_penalty_point_history)、get_punishment_history.py(get_punishment_history)、get_listings_with_issues.py(get_listings_with_issues)、get_late_orders.py(get_late_orders);另有通用入口 account_health_api.py。
使用方式:先运行 python scripts/check_auth_dependency.py,exit code 42 表示需先安装 linkfox-shopee-store-auth;由该 auth 技能定位 shopId。调用统一走 POST /shopee/developerProxy,传入 shopId(或 merchantId),path 须为 api/v2/account_health/...。脚本用法:python scripts/<脚本名>.py '<JSON 参数>' [--inline]。查处罚时 punishment_status 必填(1 进行中 / 2 已结束)。
输出策略:完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-shopee-store-account-health-<timestamp>.json,禁止写入 /tmp;响应 ≤8 KB 打印完整 JSON,>8 KB 只输出摘要,--inline 可强制全量打印。建议先用 jq 或 ConvertFrom-Json 从落盘文件按需抽取字段。
适用场景:查看店铺健康概况并按 metric_id 下钻失败指标;按 late_by_days 优先处理逾期订单;查询扣分与处罚历史;定位有问题的 listing。
限制:依赖 linkfox-shopee-store-auth 选店;未配置 LINKFOX_AGENT_API_KEY 或 LINKFOXAGENT_API_KEY、响应 401/402、提示算力或余额不足时,按 references/onboarding.md 处理。本工具不消耗算力,但会消耗算力资源用于检索,失败或空结果不得自动换关键词、翻页或连续试探。店铺授权、订单处理、商品 listing、店铺基础信息分别由其他技能负责。入参与响应细节见 references/apis/ 与 references/api.md。