核心功能
BrickLink 技能是 BrickLink 官方 Store API 的 Python CLI 封装,提供完整的 OAuth 1.0 请求签名与接口调用能力。覆盖六大核心模块:
订单管理:支持查询进出向订单详情、订单商品批次、消息记录与反馈信息;卖家可更新订单状态、支付状态、发送 Drive Thru 邮件(需 --yes 确认)。
库存操作:支持店铺库存的批量查询、单条 CRUD 操作,包括创建多库存批次、更新数量/价格/状态、删除库存等。
目录与价格:查询分类、颜色、套装/零件/人仔详情,获取 Price Guide 价格统计(新旧成色、区域、货币筛选),以及套装拆解(subset)与包含关系(superset)查询。
反馈与通知:双向反馈查询与主动发布,支持回复收到的评价;读取未读推送通知。
实用工具:order-detail-html 可将订单渲染为紧凑 HTML 视图,便于离线查阅或打印。
显著优点
- 官方 API 对接:直接调用 BrickLink 官方 Store API,数据实时准确,非爬虫方案
- 完整 OAuth 1.0 实现:自动处理签名与认证,降低开发门槛
- 读写全覆盖:从只读查询到库存 mutation 操作,满足卖家自动化需求
- 批量操作支持:
create-inventories支持单请求批量创建库存 - 安全确认机制:所有修改操作强制
--yes参数,防止误操作
局限性与风险
- 权限受限:订单 mutation 仅限卖家身份(direction=out),买家无法通过 API 修改订单状态,需回官网操作
- OAuth 1.0 配置复杂:需手动申请 Consumer Key/Secret 与 Token,配置门槛较高
- 无内置频率控制:高并发调用可能触发 API 限流,需用户自行管理
- Python 依赖:要求本地 Python 3 环境,无独立二进制分发
适合人群
BrickLink 活跃卖家、乐高零件/套装分销商、需要批量同步库存或自动化订单处理的店铺运营者。
常规风险
API 凭证泄露可能导致店铺数据被篡改或订单状态被恶意更新;建议将凭证存储于环境变量而非代码仓库,并限制 Token 权限范围。