linkfox-lingxing-erp

领星 ERP OpenAPI（LinkFox 包装版）

本 skill 是 LinkFox 对领星（Lingxing）官方开放能力的包装：name 为 linkfox-lingxing-erp，内容与领星侧 OpenAPI 文档及 scripts/lingxing.py 保持一致，由 LinkFox 仓库统一版本管理；认证与请求仍发往 领星官方域名。速查见 references/api.md。

查询领星 ERP 全模块数据，支持 373 个接口，覆盖广告、销售、产品、财务、统计、FBA、仓库、采购、客服、多平台等全业务线。

环境变量配置

export LINGXING_APP_ID=your_app_id
export LINGXING_APP_SECRET=your_app_secret

# 可选：设置默认店铺 SID，无需每次在 --params 中传入
export LINGXING_SID=your_sid

在领星 ERP -> 开放接口菜单中获取 AppID 和 AppSecret。

使用方式

以下命令均在 本 skill 根目录（含 SKILL.md 与 scripts/ 的目录）下执行。

# 列出所有已授权亚马逊店铺，获取 SID
python3 scripts/lingxing.py --list-stores

# 查看所有支持的接口
python3 scripts/lingxing.py --api help

# 基础调用
python3 scripts/lingxing.py --api <接口名> --params '<JSON参数>'

# 自动翻页获取全部数据
python3 scripts/lingxing.py --api <接口名> --params '<JSON参数>' --all

# 自定义翻页大小
python3 scripts/lingxing.py --api <接口名> --params '<JSON参数>' --all --page-size 50

输出为 JSON 到 stdout，翻页进度输出到 stderr。

调用示例

# 第一步：查询店铺列表获取 SID
python3 scripts/lingxing.py --list-stores
export LINGXING_SID=813

# 广告报表
python3 scripts/lingxing.py \
  --api spCampaignReports \
  --params '{"report_date": "2024-01-01"}'

# 亚马逊订单（自动翻页）
python3 scripts/lingxing.py \
  --api mwsOrders \
  --params '{"start_date": "2024-01-01", "end_date": "2024-01-31"}' --all

# 亚马逊 Listing
python3 scripts/lingxing.py \
  --api mwsListing \
  --params '{"sid": "813", "is_pair": 1, "is_delete": 0}' --all

# 产品列表
python3 scripts/lingxing.py \
  --api ProductLists --params '{"offset": 0, "length": 20}'

# 利润报表（ASIN维度）
python3 scripts/lingxing.py \
  --api profitAsin \
  --params '{"sids": "813", "start_date": "2024-01-01", "end_date": "2024-01-31"}'

# ASIN日销量
python3 scripts/lingxing.py \
  --api AsinDailyLists \
  --params '{"sid": 813, "start_date": "2024-01-01", "end_date": "2024-01-07"}' --all

# FBA发货单列表
python3 scripts/lingxing.py \
  --api FBAShipmentList \
  --params '{"sid": 813}' --all

# 亚马逊源表-全部订单
python3 scripts/lingxing.py \
  --api AllOrders \
  --params '{"sid": 813, "start_date": "2024-01-01", "end_date": "2024-01-31"}' --all

# 仓库列表
python3 scripts/lingxing.py \
  --api WarehouseLists --params '{"offset": 0, "length": 50}'

# Review列表（v2，支持更多筛选）
python3 scripts/lingxing.py \
  --api reviewV2 --params '{"sid": 813, "offset": 0, "length": 20}'

# 多平台订单（V2）
python3 scripts/lingxing.py \
  --api MultiPlatOrderV2 \
  --params '{"start_date": 1704067200, "end_date": 1706745600}' --all

# TikTok广告主列表
python3 scripts/lingxing.py \
  --api queryAdvertiserList \
  --params '{"length": 100}'

# 补货建议汇总
python3 scripts/lingxing.py \
  --api GetSummaryList \
  --params '{"sid_list": [813]}' --all