SuperAPI AI 工具集

zach-lingxing-mcp

通用与其它

查看项目

更新于 10-16 09:30

技能介绍

用途:把领星 ERP OpenAPI 接入为 MCP 服务,并完成配置与故障排查。因领星 OpenAPI 有 IP 白名单限制,本地环境无法直接访问;本机直连已停用,需部署固定出口网关并把 EIP 加入白名单后才可使用。未部署前如需亚马逊经营数据,应优先改用 Amazon SP-API(MCP: amazon-api)。该公开版 Skill 自包含,不依赖私有工作区文件或内部协议。

主要能力:配置固定出口网关上的领星 MCP;配置带 Bearer 的团队 HTTP 版;配置 Tailscale 与 SSH 隧道访问;列出可调用的 lingxing_* 工具;排查环境变量、Bearer、权限、授权有效期和 IP 白名单问题。工具覆盖健康检查、卖家与市场、店铺销售、ASIN 日列表与表现、订单、促销(秒杀/管理/VIP 折扣/优惠券/每日促销解析)、广告账户与 SP/SD/SB 广告、利润(卖家/ASIN/父 ASIN)、货源、FBA、补货、报表导出、ASIN 广告与周度汇总、实验及冒烟检查等。

使用方式:相关文件位于 mcp-servers/lingxing-openapi/ 下的 server.py、http_server.py、README.md、deploy/,以及 lib/lingxing_openapi/mcp.py。环境变量包括 LINGXING_APP_ID、LINGXING_APP_SECRET、LINGXING_TOKEN_CACHE_FILE、LINGXING_MCP_BEARER_TOKEN、LINGXING_MCP_HOST、LINGXING_MCP_PORT。常用命令: python3 mcp-servers/lingxing-openapi/server.py python3 mcp-servers/lingxing-openapi/http_server.py --host 127.0.0.1 --port 8099 python3 skills/zach-lingxing-openapi-client/scripts/smoke_check.py 各 deploy 脚本可用 --help 查看用法。

排错原则:先跑 lingxing_health_check 检查环境变量与 token,再跑 lingxing_smoke_check 检查 SellerLists -> StoreSales -> Orderlists -> promotionListingList;403 时回领星后台检查授权有效期、接口权限和 IP 白名单;HTTP 模式报 missing_or_invalid_bearer 时先只查 Bearer Token。

限制与边界:risk-level 为 low,只做 MCP 服务配置与排查,不写入业务数据。上游为 zach-lingxing-openapi-client(API 鉴权底座),下游为依赖领星 MCP 工具的其他 Skill。完成后报告 DONE / DONE_WITH_CONCERNS / BLOCKED / NEEDS_CONTEXT。具体收费、价格等信息暂未提供。