名称： bricklink
描述： "BrickLink 商店 API 辅助工具/命令行界面（支持 OAuth 1.0 请求签名）。涵盖订单、商店库存（读写）、目录、分类、颜色、反馈和推送通知。"
摘要： "BrickLink 商店 API 命令行工具：订单、库存、目录、价格、反馈。"
版本： 1.4.1
主页： https://github.com/odrobnik/bricklink-skill
元数据：
openclaw:
emoji: "🧱"
requires:
bins: ["python3"]
env: ["BRICKLINK_CONSUMER_KEY", "BRICKLINK_CONSUMER_SECRET", "BRICKLINK_TOKEN_VALUE", "BRICKLINK_TOKEN_SECRET"]

BrickLink

使用 scripts/bricklink.py。

设置

请参阅 SETUP.md 了解先决条件和设置说明。

命令

只读操作

• bricklink.py get-orders [--direction in|out] [--status ...] [--include-status ...] [--exclude-status ...] [--filed true|false] - 列出您收到或发出的订单。
• bricklink.py get-order <order_id> - 获取特定订单的详细信息。
• bricklink.py get-order-items <order_id> - 获取特定订单的物品批次。
• bricklink.py get-order-messages <order_id> - 获取与特定订单相关的消息。

• bricklink.py get-order-feedback <order_id> - 获取与特定订单相关的反馈。

• bricklink.py get-feedback [--direction in|out] - 列出您收到（in）或发布（out）的反馈。

• bricklink.py get-feedback-item <feedback_id> - 根据 ID 获取单个反馈条目。

• bricklink.py get-notifications - 列出未读的推送通知（/notifications）。

• bricklink.py get-categories - 列出所有目录分类。

• bricklink.py get-category <category_id> - 根据 ID 获取单个分类。

• bricklink.py get-colors - 列出所有目录颜色。

• bricklink.py get-color <color_id> - 根据 ID 获取单个颜色。

• bricklink.py get-inventories [--item-type ...] [--status ...] [--category-id ...] [--color-id ...] - 列出您的商店库存批次（支持包含/排除过滤器）。

• bricklink.py get-inventory <inventory_id> - 根据 ID 获取单个库存批次。

• bricklink.py get-item <type> <no> - 获取目录物品（零件/套装/人仔/…）。

• bricklink.py get-supersets <type> <no> [--color-id N] - 列出包含指定物品的物品。
• bricklink.py get-subsets <type> <no> [--color-id N] [--box true|false] [--instruction true|false] [--break-minifigs true|false] [--break-subsets true|false] - 将物品拆分为其包含的子物品。
• bricklink.py get-price-guide <type> <no> [--color-id N] [--guide-type stock|sold] [--new-or-used N|U] [--country-code XX] [--region ...] [--currency-code XXX] [--vat N|Y|O] - 获取价格指南统计数据。
• bricklink.py get-known-colors <type> <no> - 列出目录物品的已知颜色。

修改操作

注意： 订单修改命令（update-order、update-order-status、update-payment-status）仅适用于商店订单（direction=out，即您作为卖家）。对于购买订单（direction=in）会返回 404 错误——BrickLink API 不允许买家修改订单状态或归档收到的订单。此类操作请使用 BrickLink 网站。

• bricklink.py update-order <order_id> [--remarks ...] [--is-filed true|false] [--shipping-...] [--cost-...] — 更新允许的订单字段（物流跟踪、备注、运费/成本字段）。仅限商店订单。
• bricklink.py update-order-status <order_id> <status> — 更新订单状态。仅限商店订单。
• bricklink.py update-payment-status <order_id> <payment_status> — 更新订单的付款状态。仅限商店订单。

• bricklink.py send-drive-thru <order_id> [--mail-me] — 为订单发送“Drive Thru”邮件。

• bricklink.py post-feedback --order-id N --rating 0|1|2 [--comment ...] - 为订单发布新反馈。

• bricklink.py reply-feedback <feedback_id> --reply "..." - 回复您收到的反馈。

• bricklink.py create-inventory [--item-type ... --item-no ... --color-id N --quantity N --unit-price ... --new-or-used N|U ...] - 通过命令行参数创建单个库存批次。

• bricklink.py create-inventory --file batch.json - 从已验证的 JSON 文件批量创建多个库存批次（仅限工作区或 /tmp 目录）。
• bricklink.py update-inventory <inventory_id> [--quantity N --unit-price ... --new-or-used N|U --remarks ...] - 更新库存批次。
• bricklink.py delete-inventory <inventory_id> - 删除库存批次。

实用工具

• bricklink.py order-detail-html <order_id> [--out path] [--inline-images] - 获取订单及物品信息，并渲染为紧凑的 HTML 视图（类似于 BrickLink 的 orderDetail.asp 页面）。