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

接口总览（373个）

新广告报表（37个）

接口详见 references/newad-report.md。

广告基础数据（21个）

接口详见 references/basedata.md。

基础数据（8个）

接口详见 references/basicdata-full.md。

AccoutLists(GET), AllMarketplace(GET), AttachmentDownload, ConceptSellerLists(GET), Currency, CustomAttachmentDownload, StateList, WorldStateLists

销售（39个）

接口详见 references/sale-ops.md（订单/Listing核心4个）+ references/sale-full.md（其余35个）。

产品（14个）

接口详见 references/product.md。

ProductLists, ProductDetails, Brand, Category, UpcList, GetProductTag(GET), GetPagingLogLists, attributeList, batchGetProductInfo, bundledProductList, getTransparencyProductList, productAuxList, spuInfo, spuList

财务（41个）

接口详见 references/finance.md。

统计（35个）

接口详见 references/statistics.md。

FBA发货（13个）

接口详见 references/fba.md。

FBAShipmentList, FBAReceivedInventory, ShipmentPlanLists, GetFbaProductList, GetInboundShipmentList, GetInboundShipmentListMwsDetailList, ShipFromAddressList, BoxInfo, GetHeadLogisticsFeeTypes, GetSeaTrackSupplierCarriers, QuerySTATaskList, StaTaskDetail, getInboundShipmentListMwsDetail

亚马逊源表数据（20个）

接口详见 references/sourcedata.md。

AllOrders, FbaOrders, RefundOrders, Transaction, ManageInventory, DailyInventory, AfnFulfillableQuantity, ReservedInventory, RemovalLists, RemovalOrderListNew, RemovalShipmentList, SourceRemovalOrders, AdjustmentList, getAmazonFulfilledShipmentsList, getFbaAgeList, getFbaInventoryEventDetailList, v1getAmazonFulfilledShipmentsList, v1getFbaInventoryEventDetailList, fbaExchangeOrderList, fbmReturnOrderList

补货建议（9个）

接口详见 references/fbasug.md。

GetSummaryList, ConfigASIN, ConfigMSKU, DailySalesInfoFeatureASIN, DailySalesInfoFeatureMSKU, InfoASIN, InfoMSKU, SourceListASIN, SourceListMSKU

补货限制（2个）

接口详见 references/fbalimit.md。

GetIpiInfo, replenishmentRestrictionList

采购（7个）

接口详见 references/purchase.md。

PurchaseOrderList, Supplier, changeOrderList, purchaseGetOrders, getPurchasePlans, getPurchaseReturnOrderList, purchaserLists

仓库（32个）

接口详见 references/warehouse.md。

客服（18个）

接口详见 references/service.md。

FeedbackList, FeedbackListMws, CustomerList, AfterSalesWorkOrderList, PerformanceNoticeList, PerformanceNoticeDetail, mailDetail, mailLists, review, reviewDetail, reviewLists(GET), reviewV2, feedbackDetail, feedbackLists, customerServiceCrmcustomerIndex, customerServiceRmaManageList, storePerformanceList, voiceOfBuyerList

物流（3个）

接口详见 references/logistics.md。

ChannelList, QueryHeadLogisticsProvider, transportMethodList

工具（4个）

接口详见 references/tools.md。

CompetitiveMonitorList, GetKeywordList, warningMessageGoodsList, warningMessageInventoryList

VC（7个）

接口详见 references/vc.md。

vcOrderPageList, vcOrderPoDetail, vcOrderDfDetail, vcDeliverPageList, vcDeliverDetail, listingManageVcListingPageList, platformAuthVcSellerPageList

目标管理（2个）

接口详见 references/targetmanage.md。

StoreBatchSelect, UserBatchSelect

多平台广告（28个）

接口详见 references/multiplatform-ads.md。

多平台V2（33个）

接口详见 references/multiplatform-v2.md。

店铺列表（--list-stores）

调用 GET /erp/sc/data/seller/lists 接口，列出所有已授权亚马逊店铺。

注意：此接口需要领星 ERP 全量权限。如果 AppKey 仅授权了广告数据，会返回 403。 解决方法：在领星 ERP -> 开放接口中为该 AppKey 添加「基础数据」权限，或直接设置 LINGXING_SID=<数字> 跳过自动发现。

注意事项

• SID 注入优先级: --params 中显式传入 > LINGXING_SID 环境变量自动注入
• sid vs profile_id: 广告类接口 sid 和 profile_id 二选一必填；dspReportOrderList 仅支持 profile_id
• GET 接口: AccoutLists, AllMarketplace, ConceptSellerLists, GetProductTag, reviewLists, getPackingData 使用 GET 方法
• 分页模式: 大多数接口用 offset/length；WmsOrderList 等用 page/page_size；FBMOrderList 用 page/length
• 响应格式: /cost/center/ 路径 API 数据在 data.records 或 data.row_data 下
• 日期参数: 报表类接口用 report_date（单日）；订单/利润类用 start_date/end_date（日期范围）；多平台V2用 Unix 时间戳（秒）
• Token 缓存: token 自动缓存到 /tmp/lingxing_token_*.json，2小时有效
• 限流: 大多数接口令牌桶容量为 10，ProductAnalysisList 和 mwsOrders 仅为 1
• 依赖: 需要安装 pycryptodome 和 requests（pip install pycryptodome requests）

错误处理

Handling Large Responses

To avoid overflowing the agent context, persist the response to disk and extract only the fields you need:

python scripts/response_io.py run --script scripts/lingxing.py --out-dir <DIR> '<params>'
python scripts/response_io.py read <file> --fields "<paths>"   # or --path "<JMESPath>"

Pick --out-dir outside any git working tree (e.g. /tmp/... on Unix, %TEMP%/... on Windows). Persisted responses may contain PII, pricing, or auth-sensitive data — do not commit them. Files are not auto-deleted; clean up when the task is done.

run writes the full response to a file and emits only a schema preview + file path. read projects specific fields, with --limit/--offset for slicing and --format json|jsonl|csv|table for output.

When to prefer this pattern — apply your judgment based on the response characteristics, e.g.:

• High field count per record, or fields you don't need
• Batch/paginated results (multiple items per call)
• Long-text fields (descriptions, reviews, HTML, time series)
• Output reused across later steps rather than consumed immediately

For small, single-use responses, calling the main script directly is fine.

⚠️ The preview is a truncated schema + sample, not the full data. Any field-level decision must read from the persisted file via read.

解决认证和积分问题

发生以下异常情况时，采用 references/onboarding.md 引导解决问题：

异常情况

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

积分消耗规则

不消耗积分。