乐高 BrickLink 店铺 API 全能助手

BrickLink 官方 API 的 Python CLI 工具，支持店铺订单管理、库存读写、价格查询与反馈处理，需 OAuth 1.0 密钥配置。

基本信息

• 技能名称?Bricklink
• 中文名称?乐高 BrickLink 店铺 API 全能助手
• 作者?odrobnik
• 分类?专业技能
• 版本?1.4.2
• 标签?e-commerce, lego, inventory-management, api-client, oauth, cli-tool, bricklink, marketplace

使用方法

使用说明
核心用法
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 速率限制，影响正常业务
合规风险 ：自动化反馈发布需遵守平台评价政策，避免滥用导致账号受限