核心功能
BrickLink Skill 是面向乐高(LEGO)二手交易平台的官方 API 封装工具,基于 OAuth 1.0 认证协议,为 BrickLink 店铺卖家提供完整的命令行操作能力。
主要能力
订单管理:支持查询进出订单详情、订单商品批次、消息记录与关联评价。卖家可更新订单状态(仅限出向订单)、支付状态、物流追踪信息,并发送 "Drive Thru" 邮件通知买家。
库存操作:完整的 CRUD 能力,支持按类型、状态、分类、颜色筛选库存批次,可单条创建或批量导入 JSON 文件更新库存,包括数量、单价、新旧状态等字段。
目录与定价:访问 BrickLink 完整商品目录,查询分类、颜色、套装/零件/人仔详情,获取价格指南(Price Guide)统计、已知颜色列表,以及套装拆解(subsets)与包含关系(supersets)查询。
评价系统:查看收发评价、针对订单发布评价、回复收到的评价。
实用工具:内置 HTML 订单详情渲染与可打印发票生成功能,支持内联图片输出。
显著优点
- 官方 API 封装:直接对接 BrickLink 官方 Store API,数据权威可靠
- 完整卖家工作流:覆盖从库存上架、订单处理到发货开票的全链路
- 批量操作支持:JSON 文件批量导入,适合大规模库存管理
- OAuth 1.0 安全认证:标准签名机制,密钥不泄露
局限性与风险
- 权限受限:订单修改仅限"出向订单"(卖家角色),买家无法通过 API 修改订单状态
- 认证门槛:需手动申请 BrickLink 开发者账号并配置四组 OAuth 密钥
- Python 依赖:运行环境要求 Python 3,对非技术用户不够友好
- API 速率限制:BrickLink 官方存在调用频率限制,高频操作可能触发限流
适合人群
- BrickLink 平台活跃卖家,需批量管理库存与订单
- 希望自动化店铺运营、生成发票与报表的用户
- 具备基础命令行操作能力的技术型卖家
安全提示
OAuth 密钥需妥善保管,避免硬编码或提交至版本控制。建议通过环境变量注入,生产环境定期轮换密钥。