bricklink

BrickLink

Use scripts/bricklink.py.

Auth config

Option A (recommended): environment variables

• BRICKLINK_CONSUMER_KEY
• BRICKLINK_CONSUMER_SECRET
• BRICKLINK_TOKEN_VALUE
• BRICKLINK_TOKEN_SECRET

Option B: local config JSON (recommended for convenience)

Create ~/clawd/bricklink/config.json. If that file exists, --config is optional.

Option C: parse the saved registration HTML

• bricklink.py --creds-html "/path/to/BrickLink API Consumer Registration | BrickLink.html" ...

Commands

Read-only

• bricklink.py get-orders [--direction in|out] [--status ...] [--include-status ...] [--exclude-status ...] [--filed true|false] — Lists orders you received or placed.

• bricklink.py get-order <order_id> — Fetches details for a specific order.

• bricklink.py get-order-items <order_id> — Fetches the item batches for a specific order.

• bricklink.py get-order-messages <order_id> — Fetches messages associated with a specific order.

• bricklink.py get-order-feedback <order_id> — Fetches feedback associated with a specific order.

• bricklink.py get-feedback [--direction in|out] — Lists feedback you received (in) or posted (out).

• bricklink.py get-feedback-item <feedback_id> — Fetches a single feedback entry by id.

• bricklink.py get-notifications — Lists unread push notifications (/notifications).

• bricklink.py get-categories — Lists all catalog categories.

• bricklink.py get-category <category_id> — Fetches a single category by id.

• bricklink.py get-colors — Lists all catalog colors.

• bricklink.py get-color <color_id> — Fetches a single color by id.

• bricklink.py get-inventories [--item-type ...] [--status ...] [--category-id ...] [--color-id ...] — Lists your store inventory lots (supports include/exclude filters).

• bricklink.py get-inventory <inventory_id> — Fetches a single inventory lot by id.

• bricklink.py get-item <type> <no> — Fetches a catalog item (PART/SET/MINIFIG/…).

• bricklink.py get-supersets <type> <no> [--color-id N] — Lists items that contain the specified item.

• bricklink.py get-subsets <type> <no> [--color-id N] [--box true|false] [--instruction true|false] [--break-minifigs true|false] [--break-subsets true|false] — Parts out an item into its included items.

• 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] — Fetches price guide statistics.

• bricklink.py get-known-colors <type> <no> — Lists known colors for a catalog item.

Mutating (require --yes)

• bricklink.py update-order <order_id> --yes [--json body.json] [--remarks ...] [--is-filed true|false] [--shipping-...] [--cost-...] — Updates allowed order fields (tracking, remarks, shipping/cost fields).

• bricklink.py update-order-status <order_id> <status> --yes — Updates the status of an order.

• bricklink.py update-payment-status <order_id> <payment_status> --yes — Updates the payment status of an order.

• bricklink.py send-drive-thru <order_id> [--mail-me] --yes — Sends a “Drive Thru” email for an order.

• bricklink.py post-feedback --yes [--json body.json] [--order-id N --rating 0|1|2 --comment ...] — Posts new feedback for an order.

• bricklink.py reply-feedback <feedback_id> --yes [--json body.json] [--reply ...] — Replies to feedback you received.

• bricklink.py create-inventory --yes [--json body.json] [--item-type ... --item-no ... --color-id N --quantity N --unit-price ... --new-or-used N|U ...] — Creates a single inventory lot.

• bricklink.py create-inventories --yes [--json body.json] [--item-type ... --item-no ... --color-id N --quantity N --unit-price ... --new-or-used N|U ...] — Creates multiple inventory lots in one request.

• bricklink.py update-inventory <inventory_id> --yes [--json body.json] [--quantity N --unit-price ... --new-or-used N|U --remarks ...] — Updates an inventory lot.

• bricklink.py delete-inventory <inventory_id> --yes — Deletes an inventory lot.

Utilities

• bricklink.py order-detail-html <order_id> [--out path] [--inline-images] — Fetches order+items and renders a compact HTML view (similar to BrickLink orderDetail.asp).