Install
openclaw skills install linkfox-lingxing-erpLinkFox 包装的领星(Lingxing)ERP 技能「linkfox-lingxing-erp」:由 LinkFox Skills 仓库收录分发,封装领星官方 OpenAPI 文档与脚本用法,底层仍直连 openapi.lingxing.com(非 LinkFox 自建网关)。覆盖约 373 个接口场景,含...
openclaw skills install linkfox-lingxing-erp本 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
接口详见 references/newad-report.md。
| 分组 | 接口 |
|---|---|
| SP报表(8) | spCampaignReports, campaignPlacementReports, spAdGroupReports, spProductAdReports, spKeywordReports, spTargetReports, asinReports, queryWordReports |
| SB报表(8) | hsaCampaignReports, hsaCampaignPlacementReports, hsaAdGroupReports, listHsaTargetingReport, hsaQueryWordReports, hsaPurchasedAsinReports, listHsaProductAdReport, listHsaKeywordPlacementReport |
| SD报表(6) | sdCampaignReports, sdAdGroupReports, sdProductAdReports, sdTargetReports, sdAsinReports, sdMatchTargetReports |
| SP小时(5) | spCampaignHourData, spAdPlacementHourData, spAdGroupHourData, spAdvertiseHourData, spTargetHourData |
| SB小时(4) | sbCampaignHourData, sbAdGroupHourData, sbTargetHourData, sbAdPlacementHourData |
| SD小时(4) | sdCampaignHourData, sdAdGroupHourData, sdAdvertiseHourData, sdTargetHourData |
| 其他(2) | dspReportOrderList, ProductAnalysisList |
接口详见 references/basedata.md。
| 分组 | 接口 |
|---|---|
| 账号(1) | dspAccountList |
| 组合(1) | portfolios |
| SP(6) | spCampaigns, spAdGroups, spProductAds, spKeywords, spTargets, spNegativeTargetsOrKeywords |
| SB(6) | hsaCampaigns, hsaAdGroups, hsaProductAds, sbTargeting, hsaNegativeKeywords, hsaNegativeTargets, sbDivideAsinReports |
| SD(5) | sdCampaigns, sdAdGroups, sdProductAds, sdTargets, sdNegativeTargets |
| 报表下载(1) | abaReport |
接口详见 references/basicdata-full.md。
AccoutLists(GET), AllMarketplace(GET), AttachmentDownload, ConceptSellerLists(GET), Currency, CustomAttachmentDownload, StateList, WorldStateLists
接口详见 references/sale-ops.md(订单/Listing核心4个)+ references/sale-full.md(其余35个)。
| 分组 | 接口 |
|---|---|
| 订单(7) | mwsOrders, OrderDetail, FBMOrderList, FBMOrderDetail, MCFOrderList, RefundOrder, afterSaleList |
| Listing(5) | mwsListing, sale_ProductList, QueryProductList, GetPrices, listingOperateLogPageList |
| 退货(3) | orderReturnInformation, ProductInformation, LogisticsInformation |
| 促销(12) | promotionListingList, promotionListingDetailCoupon/Manage/PrimeDiscount/SecKill, promotionalActivitiesCouponList/ManageList/SecKillList/VipDiscountList, promotionCouponAllDetailBatch/ManagementAllDetailBatch/PrimeDiscountAllDetailBatch/SecKillAllDetailBatch |
| 运营(7) | scOrderSetRemark, adjustPriceAdjustPriceManual, fbaFeeDifferenceList/MskuList, globalTagPageList, queryListingRelationTagList, GetFulfillmentResult |
| 刊登(5) | PublishManageCategoryRoot/Children, PublishManageGetProductType, GetMerchantShippingGroup |
接口详见 references/product.md。
ProductLists, ProductDetails, Brand, Category, UpcList, GetProductTag(GET), GetPagingLogLists, attributeList, batchGetProductInfo, bundledProductList, getTransparencyProductList, productAuxList, spuInfo, spuList
接口详见 references/finance.md。
| 分组 | 接口 |
|---|---|
| 利润报表(7) | profitAsin, profitAsinSon, profitSettlement, FianceProfitMsku, OrderProfitListMSKU, ProfitMsku |
| 结算(6) | SettlementReport, SettlementExportUrlGet, settlementSummaryList, settlementTransactionList, CostStream, summaryQuery |
| BD报表(7) | bdASIN, bdMSKU, bdOrder, bdParentASIN, bdSKU, bdSeller, bdSellerSummary |
| 发票(3) | InvoiceList, InvoiceDetail, InvoiceCampaignList |
| 费用管理(2) | feeManagementList, feeManagementType |
| 资金池(6) | requestFundsPoolCustomFeeList/InboundList/LogisticsList/OtherFeeList/PrepayList/PurchaseList |
| 应收(3) | receivableReportList, reportListDetail, reportListDetailInfo |
| 其他(7) | QueryReceiptFundsList, RequestFundsOrderList, centerOdsDetailQuery, profitReportOrderTranscationList, lazadaPayoutList, lazadaSettlementList, shopeeAdjustmentList/IncomeList/PayoutList |
接口详见 references/statistics.md。
| 分组 | 接口 |
|---|---|
| 销量(4) | AsinDailyLists, AsinList, AsinListNew, StoreSales |
| FBA仓储(5) | FBAStorageFeeLongTerm, FBAStorageFeeMonth, FbaStockReportList, FbaStockAggregateListNew, FbaStockDetailListNew |
| 本地仓(4) | LocalAggregateList/New, LocalDetailList/New |
| 海外仓(4) | OverseasAggregateList/New, OverseasDetailList/New |
| 新版统计(4) | statisticsOpenASIN/MSKU/Parent/Seller |
| 其他(14) | MonthRefund, ProfitMsku, ReimbursementList, ReturnOrderAnalysisLists, PurchaseReportBuyerList/ProductList/SupplierList, performanceTrendByHour, operateLogList/V2List, PlatformStatisticsSaleStatPageListV2, AmazonReportExportTask, reportCreate/QueryReportExportTask |
接口详见 references/fba.md。
FBAShipmentList, FBAReceivedInventory, ShipmentPlanLists, GetFbaProductList, GetInboundShipmentList, GetInboundShipmentListMwsDetailList, ShipFromAddressList, BoxInfo, GetHeadLogisticsFeeTypes, GetSeaTrackSupplierCarriers, QuerySTATaskList, StaTaskDetail, getInboundShipmentListMwsDetail
接口详见 references/sourcedata.md。
AllOrders, FbaOrders, RefundOrders, Transaction, ManageInventory, DailyInventory, AfnFulfillableQuantity, ReservedInventory, RemovalLists, RemovalOrderListNew, RemovalShipmentList, SourceRemovalOrders, AdjustmentList, getAmazonFulfilledShipmentsList, getFbaAgeList, getFbaInventoryEventDetailList, v1getAmazonFulfilledShipmentsList, v1getFbaInventoryEventDetailList, fbaExchangeOrderList, fbmReturnOrderList
接口详见 references/fbasug.md。
GetSummaryList, ConfigASIN, ConfigMSKU, DailySalesInfoFeatureASIN, DailySalesInfoFeatureMSKU, InfoASIN, InfoMSKU, SourceListASIN, SourceListMSKU
接口详见 references/fbalimit.md。
GetIpiInfo, replenishmentRestrictionList
接口详见 references/purchase.md。
PurchaseOrderList, Supplier, changeOrderList, purchaseGetOrders, getPurchasePlans, getPurchaseReturnOrderList, purchaserLists
接口详见 references/warehouse.md。
| 分组 | 接口 |
|---|---|
| 仓库/库存(11) | WarehouseLists, WarehouseStatement/New, InventoryDetails, inventoryBinDetails, wareHouseBinStatement, warehouseBin, FBAStock, FBAStock_v2, AwdWarehouseDetail |
| 批次(2) | GetBatchDetailList, GetBatchStatementList |
| 收货(4) | GetReceiveGoodRecords, PurchaseReceiptOrderList, ReceiptOrderQcList, getPackingData(GET) |
| WMS(2) | WmsOrderList, WmsOrderDetail |
| 海外仓(2) | OverseaWarehouseMatchList, OverSeasStockDetail |
| 调拨/调整/盘点(3) | getStorageAdjustOrderList, getStorageAllocationList, checkGetOrderList/Detail |
| 入库/出库(4) | inboundgetOrders, outboundgetOrders, listInbound, matchSkuList |
| 其他(4) | getProcessOrderLists, ReturnList, removalInboundList, qualityInspectionOrderDetail |
接口详见 references/service.md。
FeedbackList, FeedbackListMws, CustomerList, AfterSalesWorkOrderList, PerformanceNoticeList, PerformanceNoticeDetail, mailDetail, mailLists, review, reviewDetail, reviewLists(GET), reviewV2, feedbackDetail, feedbackLists, customerServiceCrmcustomerIndex, customerServiceRmaManageList, storePerformanceList, voiceOfBuyerList
接口详见 references/logistics.md。
ChannelList, QueryHeadLogisticsProvider, transportMethodList
接口详见 references/tools.md。
CompetitiveMonitorList, GetKeywordList, warningMessageGoodsList, warningMessageInventoryList
接口详见 references/vc.md。
vcOrderPageList, vcOrderPoDetail, vcOrderDfDetail, vcDeliverPageList, vcDeliverDetail, listingManageVcListingPageList, platformAuthVcSellerPageList
接口详见 references/targetmanage.md。
StoreBatchSelect, UserBatchSelect
接口详见 references/multiplatform-ads.md。
| 分组 | 接口 |
|---|---|
| TikTok(9) | queryCommonAdvertiserList, queryGmvStoreList, queryTiktokAdGroupList/AdList/CampaignList, queryAdvertiserList, queryGmvAdvertiserReportList/CampaignReportList/ItemGroupReportList |
| Walmart(19) | queryAdGroupSvList, queryCampaignSpList, queryGroupSpList, queryPageTypeSPList, queryReportPageTypeSvList, reportAdGroupSbList, reportAdItemSbList/SpList/SvList, reportCampaignSbList/SvList, reportKeywordSbList/SpList/SvList, reportPageTypeSbList, reportPlatformSbList/SpList/SvList, reportSearchTrendsList |
接口详见 references/multiplatform-v2.md。
| 分组 | 接口 |
|---|---|
| 订单(3) | MultiPlatOrderV2, newPlatformOrderList |
| 店铺(1) | StoreInfoV2 |
| Listing(2) | PairListV2, addCargoGoodsList |
| 发货(4) | QueryShippingListV2, QueryShippingListPage, QueryWFSCargoPage/InventionPage |
| 平台订单(8) | AliexpressListV2, aliexpressList, eBayList, walmartList, TemuList, TikTokList, SheinList, ShopifyVariantList |
| 库存(6) | TemuCargo, CoupangStockList, FbsStockList, FbtStockList/Search, FullList, WayfairStockList |
| 利润(4) | profitReportMsku/Order/Seller/Sku |
| 其他(5) | WalmartPaymentQueryPage/Report, WalmartCommentList, LineList, addressReturnAddressList |
调用 GET /erp/sc/data/seller/lists 接口,列出所有已授权亚马逊店铺。
注意:此接口需要领星 ERP 全量权限。如果 AppKey 仅授权了广告数据,会返回 403。 解决方法:在领星 ERP -> 开放接口中为该 AppKey 添加「基础数据」权限,或直接设置
LINGXING_SID=<数字>跳过自动发现。
--params 中显式传入 > LINGXING_SID 环境变量自动注入/cost/center/ 路径 API 数据在 data.records 或 data.row_data 下report_date(单日);订单/利润类用 start_date/end_date(日期范围);多平台V2用 Unix 时间戳(秒)/tmp/lingxing_token_*.json,2小时有效pycryptodome 和 requests(pip install pycryptodome requests)| 场景 | 处理 |
|---|---|
| 环境变量未设置 | 脚本报错退出,提示设置 LINGXING_APP_ID/LINGXING_APP_SECRET |
| Token 获取失败 | 检查 AppID/AppSecret 是否正确,IP 是否在白名单内 |
| API 返回 code != 0 | 检查参数是否正确,参见错误信息 |
| --list-stores 返回 403 | AppKey 仅有广告权限;设置 LINGXING_SID 直接指定店铺 |
| 依赖未安装 | pip install pycryptodome requests |