BrickLink店铺API工具

技能简介

BrickLink Store API helper/CLI 是一个基于 Python 的命令行工具，用于对接 BrickLink 平台（全球最大的乐高零件与套装交易市场）的官方 API。该工具完整实现 OAuth 1.0 请求签名，支持店铺订单管理、库存读写、目录查询、价格指南获取、评价反馈及推送通知等功能。

能做什么

• 查询与管理店铺订单（列表、详情、状态更新、付款状态、发货标记）
• 读写店铺库存（批量创建、更新、删除库存批次）
• 检索乐高目录数据（分类、颜色、零件/套装/人仔信息）
• 获取价格指南与市场统计（新旧件价格、销售记录）
• 处理买家评价与回复（查看、发布、回复反馈）
• 接收未读推送通知
• 生成订单 HTML 预览报告

使用说明

环境准备

1. 确保系统已安装 Python 3
2. 在 BrickLink 开发者中心申请 API 凭证，获取 Consumer Key 与 Consumer Secret
3. 完成 OAuth 授权流程，获取 Token Value 与 Token Secret

安装步骤

# 克隆仓库
git clone https://github.com/odrobnik/bricklink-skill.git
cd bricklink-skill

# 安装依赖（如有 requirements.txt）
pip install -r requirements.txt

# 或直接使用脚本
chmod +x scripts/bricklink.py

配置环境变量

export BRICKLINK_CONSUMER_KEY="your_consumer_key"
export BRICKLINK_CONSUMER_SECRET="your_consumer_secret"
export BRICKLINK_TOKEN_VALUE="your_token_value"
export BRICKLINK_TOKEN_SECRET="your_token_secret"

常用命令示例

# 列出收到的订单
python3 scripts/bricklink.py get-orders --direction in

# 获取特定订单详情
python3 scripts/bricklink.py get-order 12345678

# 更新订单状态（仅卖家订单）
python3 scripts/bricklink.py update-order-status 12345678 "SHIPPED"

# 列出店铺库存
python3 scripts/bricklink.py get-inventories

# 创建库存批次
python3 scripts/bricklink.py create-inventory --item-type PART --item-no 3001 --color-id 15 --quantity 10 --unit-price 0.25 --new-or-used N

# 获取零件价格指南
python3 scripts/bricklink.py get-price-guide PART 3001 --color-id 15 --guide-type sold

输入与输出

见下方输入与输出表格。

风险提示

• 订单修改功能仅限卖家订单（direction=out），买家无法通过 API 修改购入订单状态
• 批量创建库存时 JSON 文件须存放于工作目录或 /tmp 目录
• API 调用受 BrickLink 速率限制，频繁请求可能导致临时封禁
• OAuth 凭证泄露将导致店铺数据暴露，请妥善保管环境变量
• 价格指南数据仅供参考，实际交易价格以市场为准

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/odrobnik/bricklink/SKILL.md
来源类型：GitHub 开源项目