SuperAPI AI 工具集

zach-lingxing-openapi-client

智能体与模型

查看项目

更新于 10-16 09:44

技能介绍

本 Skill 是自包含的领星 OpenAPI 接入底座,不依赖私有工作区文件或团队手册,可为领星 MCP 及其他 skill 提供共享服务层。

用途:统一处理领星 OpenAPI 的鉴权、签名与业务请求,供上游脚本或下游 MCP 复用。

主要能力:统一管理 access_token 获取与续约;按官方规则生成 sign(业务参数与 access_token/app_key/timestamp 三个公共参数一起签名,ASCII 排序,空字符串不参与而 null 参与,拼接后 MD5 32位大写,再用 appId 做 AES/ECB/PKCS5PADDING,作为 Query 参数传输时 URL encode);封装 GET/POST 业务请求;缓存关键官方文档到本地;运行最小烟测,确认 SellerLists → StoreSales → Orderlists → promotionListingList 链路可用;文档同步会保留 12 页兼容文件名并扩展更多 Amazon 相关只读页面。

使用方式:环境变量 LINGXING_APP_ID、LINGXING_APP_SECRET 必需,LINGXING_TOKEN_CACHE_FILE(默认 runtime/lingxing/token_cache.json)与 LINGXING_DOC_ACCESS_KEY 可选。脚本位于 skills/zach-lingxing-openapi-client/scripts/。同步文档:python3 skills/zach-lingxing-openapi-client/scripts/sync_docs.py,结果写入 references/openapi_docs/。烟测:export LINGXING_APP_ID="ak_xxx" 与 export LINGXING_APP_SECRET="xxx" 后运行 python3 skills/zach-lingxing-openapi-client/scripts/smoke_check.py。其他 skill 可导入 from lib.lingxing_openapi import LingxingOpenAPIClient, LingxingOpenAPIService。

适用场景:准备接入领星接口、编写依赖领星数据的新 skill、排查领星 OpenAPI 鉴权与请求问题。

限制:领星 OpenAPI 有 IP 白名单,本地环境无法直连;需部署固定出口网关并将 EIP 加入白名单。未部署前如需亚马逊经营数据,请优先改用 Amazon SP-API(MCP: amazon-api)。依赖 Python 3.11+ 与系统自带 openssl。风险等级 low,仅做接口接入与鉴权配置,不写入业务数据。完成后报告 DONE / DONE_WITH_CONCERNS / BLOCKED / NEEDS_CONTEXT。