核心用法
BrickLink Skill 是一个基于 Python 的命令行工具,封装了 BrickLink Store API 的全部功能,采用 OAuth 1.0 签名认证。用户需配置四组环境变量(Consumer Key/Secret、Token Value/Secret)后,通过 bricklink.py 脚本执行各类操作。
读取操作涵盖:订单查询(支持方向、状态筛选)、订单详情/商品/消息/反馈获取、通知列表、分类与颜色目录、店铺库存查询(多维度过滤)、商品目录查询(PART/SET/MINIFIG 等)、价格指南统计、套装拆解与包含关系查询。
写入操作涵盖:订单字段更新(物流、备注、成本)、状态流转(订单状态/支付状态)、Drive Thru 邮件发送、反馈发布与回复、库存批量创建(JSON 文件或参数)、库存更新与删除。
实用工具提供订单详情 HTML 渲染功能,便于本地查看或归档。
显著优点
- 功能完整:覆盖 BrickLink Store API v1 全部端点,包括较少使用的推送通知与价格指南
- 批量操作友好:支持 JSON 文件批量导入库存,适合大规模店铺管理
- 认证封装完善:内置 OAuth 1.0 签名逻辑,用户无需手动计算 HMAC-SHA1
- 输出灵活:提供 HTML 渲染等增值功能,弥补官方 API 返回纯 JSON 的局限
潜在缺点与局限性
- 认证门槛高:需自行申请 BrickLink API 权限并妥善保管四组密钥,新手配置成本较高
- 买家功能受限:API 限制买家无法修改订单状态或归档订单,必须通过网页端操作
- 生态依赖:完全依赖 BrickLink 平台政策,API 费率限制或接口变更可能影响使用
- 无图形界面:纯 CLI 工具,对非技术用户不够友好
适合人群
- 运营 BrickLink 店铺的中大型卖家,需自动化库存与订单管理
- 熟悉 Python/CLI 的技术用户,追求效率而非界面体验
- 需要批量价格监控或库存同步的第三方工具开发者
常规风险
- 密钥泄露风险:环境变量或配置文件若未加密,Consumer Secret 与 Token Secret 泄露可导致店铺数据被篡改
- 误操作风险:
delete-inventory与update-order-status等命令不可逆,批量脚本需充分测试 - API 限流:高频调用可能触发 BrickLink 速率限制,影响正常业务
- 合规风险:自动化反馈发布需遵守平台评价政策,避免滥用导致账号受限