Bricklink

核心用法

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

核心功能

BrickLink Skill 是一套面向乐高（LEGO）积木交易平台的官方 Store API 命令行工具，专为 BrickLink 卖家设计。它完整封装了 BrickLink API v1 的核心能力，涵盖订单管理（查询、更新状态、发送 Drive Thru 邮件）、店铺库存（批量读写、价格调整、上下架）、目录数据（零件/套装/人仔信息、颜色、类别、价格指南）以及评价反馈等模块。Skill 采用 Python 3 纯标准库实现，零第三方依赖，代码结构清晰，具备完善的路径防护与输入验证机制。

显著优点

1. 功能全面且专业：覆盖 BrickLink 卖家日常运营的核心场景，从订单处理到库存定价，支持批量操作与 JSON 文件导入，大幅提升运营效率。
2. 安全性卓越：通过 OAuth 1.0 签名认证与官方 API 通信，HTTPS 加密传输；内置 _pathguard.py 模块严格限制文件操作范围，防止目录遍历攻击。
3. 零依赖轻量：仅依赖 Python 3 标准库，无供应链攻击风险，部署简单。
4. 隐私友好：仅读取必要的环境变量凭证，不收集、不上报任何用户数据。

潜在局限

• 仅限卖家操作：订单状态更新、归档等功能仅支持店铺订单（direction=out），买家侧订单（direction=in）无法通过 API 修改，需登录官网处理。
• 需手动配置 OAuth：需自行在 BrickLink 开发者后台申请 Consumer Key/Secret 并获取 Token，初次配置门槛略高。
• 无图形界面：纯 CLI 工具，对非技术用户不够友好。

适合人群

• 活跃于 BrickLink 平台的中小型积木卖家，需批量管理库存与订单
• 希望自动化定价分析（价格指南查询）的运营人员
• 具备基础技术能力、偏好命令行效率的高级用户

常规风险

• API 凭证泄露风险：需妥善保管 BRICKLINK_CONSUMER_KEY 等环境变量，避免硬编码或误提交至版本控制。
• 误操作风险：库存删除、订单状态更新等操作不可逆，建议先在测试环境验证批量脚本。
• API 速率限制：BrickLink 官方 API 存在调用频率限制，高频操作可能触发限流。