← Back to Skills Marketplace
odrobnik

Bricklink

by Oliver Drobnik · GitHub ↗ · v1.4.2
cross-platform ✓ Security Clean
2456
Downloads
1
Stars
2
Active Installs
14
Versions
Install in OpenClaw
/install bricklink
Description
BrickLink Store API helper/CLI (OAuth 1.0 request signing). Covers orders, store inventory (read + write), catalog, categories, colors, feedback, and push no...
README (SKILL.md)

BrickLink

Use scripts/bricklink.py.

Setup

See SETUP.md for prerequisites and setup instructions.

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 \x3Corder_id> - Fetches details for a specific order.

  • bricklink.py get-order-items \x3Corder_id> - Fetches the item batches for a specific order.

  • bricklink.py get-order-messages \x3Corder_id> - Fetches messages associated with a specific order.

  • bricklink.py get-order-feedback \x3Corder_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 \x3Cfeedback_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 \x3Ccategory_id> - Fetches a single category by id.

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

  • bricklink.py get-color \x3Ccolor_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 \x3Cinventory_id> - Fetches a single inventory lot by id.

  • bricklink.py get-item \x3Ctype> \x3Cno> - Fetches a catalog item (PART/SET/MINIFIG/…).

  • bricklink.py get-supersets \x3Ctype> \x3Cno> [--color-id N] - Lists items that contain the specified item.

  • bricklink.py get-subsets \x3Ctype> \x3Cno> [--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 \x3Ctype> \x3Cno> [--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 \x3Ctype> \x3Cno> - Lists known colors for a catalog item.

Mutating

Note: Order mutations (update-order, update-order-status, update-payment-status) only work for store orders (direction=out, where you are the seller). Purchases (direction=in) return 404 — the BrickLink API does not allow buyers to modify order status or file/archive incoming orders. Use the BrickLink website for those.

  • bricklink.py update-order \x3Corder_id> [--remarks ...] [--is-filed true|false] [--shipping-...] [--cost-...] — Updates allowed order fields (tracking, remarks, shipping/cost fields). Store orders only.

  • bricklink.py update-order-status \x3Corder_id> \x3Cstatus> — Updates the status of an order. Store orders only.

  • bricklink.py update-payment-status \x3Corder_id> \x3Cpayment_status> — Updates the payment status of an order. Store orders only.

  • bricklink.py send-drive-thru \x3Corder_id> [--mail-me] — Sends a "Drive Thru" email for an order.

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

  • bricklink.py reply-feedback \x3Cfeedback_id> --reply "..." - Replies to feedback you received.

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

  • bricklink.py create-inventory --file batch.json - Creates multiple inventory lots from a validated JSON file (workspace or /tmp only).

  • bricklink.py update-inventory \x3Cinventory_id> [--quantity N --unit-price ... --new-or-used N|U --remarks ...] - Updates an inventory lot.

  • bricklink.py delete-inventory \x3Cinventory_id> - Deletes an inventory lot.

Utilities

  • bricklink.py order-detail-html \x3Corder_id> [--out path] [--inline-images] - Fetches order+items and renders a compact HTML view (similar to BrickLink orderDetail.asp).
Usage Guidance
This skill appears coherent with its BrickLink CLI purpose. Before installing: (1) Only provide your BrickLink OAuth consumer key/secret and token value/secret (do not supply unrelated credentials). (2) Be aware the tool will look for a config file in your workspace (workspace/bricklink/config.json) or use environment variables — verify which path it will read and keep secrets in a safe place. (3) The repo contains a helper/README that mentions parsing a downloaded HTML consumer-registration file; if you use that option, only point it at files you trust (it will read local content to extract secrets). (4) The script contacts api.bricklink.com and img.bricklink.com (expected). If you need stronger assurance, review the full scripts/bricklink.py before use or run the CLI in an isolated environment.
Capability Analysis
Type: OpenClaw Skill Name: bricklink Version: 1.4.2 The OpenClaw AgentSkills skill bundle for BrickLink is classified as benign. The Python script `scripts/bricklink.py` correctly implements OAuth 1.0 for API authentication, loading credentials securely from environment variables or a workspace-specific `config.json`. Crucially, file input (`create-inventory --file`) and output (`order-detail-html --out`) operations are rigorously sanitized by `scripts/_pathguard.py` and `_load_batch_file` to prevent path traversal, restricting access to the workspace or `/tmp` directories. All network requests are directed to legitimate BrickLink API and image domains, and the `SKILL.md` documentation contains no prompt injection attempts or malicious instructions for the AI agent.
Capability Assessment
✓ Purpose & Capability
Name/description (BrickLink CLI, OAuth 1.0 signing, store/inventory/orders) align with the included Python script and the required OAuth env vars. The required binaries (python3) and four OAuth env vars are exactly what a BrickLink API helper needs.
ℹ Instruction Scope
Runtime instructions stay on-task (calling BrickLink store APIs, rendering HTML, reading a local config or environment variables). The CLI can read a workspace config file (workspace/bricklink/config.json) or environment variables; references include a notes file about parsing a downloaded consumer-registration HTML file (a helper to extract OAuth secrets). That behavior (parsing a local HTML file) is expected for convenience but means the CLI may read a local file you point it at — only supply files you trust.
✓ Install Mechanism
Instruction-only skill (no external installer). Code is included in the repository as Python scripts; no downloads or remote installers are invoked by the skill metadata.
✓ Credentials
The four required environment variables are the OAuth consumer and token secrets expected for BrickLink API access. The scripts also consult benign environment variables for workspace detection (BRICKLINK_WORKSPACE / OPENCLAW_WORKSPACE / PWD / TMPDIR) but do not request unrelated credentials.
✓ Persistence & Privilege
The skill is not marked always:true and is user-invocable. It does not request persistent/system-wide privileges or modify other skills; autonomous invocation (disable-model-invocation=false) is the platform default and not in itself a problem.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install bricklink
  3. After installation, invoke the skill by name or use /bricklink
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.4.2
fix: use /Users/oliver/clawd for workspace root to preserve symlink paths
v1.4.1
- Removed the `--yes` confirmation flag from all mutating commands for a simpler workflow. - Updated mutating command syntax and options for clarity and consistency. - Added documentation for batch inventory creation with a JSON file (`--file batch.json`). - Cleaned up feedback posting and replying command examples. - No changes to core features or API coverage.
v1.4.0
Version 1.4.0 - Bump version number to 1.4.0. - No new features or command changes listed in SKILL.md. - Maintenance update.
v1.3.3
Remove invented sensitivity metadata field
v1.3.2
Declare missing dependencies, env vars, and sensitivity in metadata
v1.3.1
Rename .clawdhubignore to .clawhubignore
v1.3.0
Refactor: move setup/prerequisites to SETUP.md, keep SKILL.md lean
v1.2.3
Document API restriction: order mutations only work for store orders (seller), not purchases (buyer)
v1.2.2
Declare OAuth env vars in requires.env metadata
v1.2.1
- Added scripts/_pathguard.py utility module. - Minor updates to scripts/bricklink.py. - Version bump to 1.2.1.
v1.2.0
Security hardening: removed --base (credential relay risk), --creds-html (arbitrary file read), --config (arbitrary path). Config now only from workspace/bricklink/config.json.
v1.1.2
Fix SKILL.md version sync
v1.1.1
Remove private invoice template from published package
v1.1.0
Add invoice template, migrate metadata to openclaw format
Metadata
Slug bricklink
Version 1.4.2
License —
All-time Installs 2
Active Installs 2
Total Versions 14
Frequently Asked Questions

What is Bricklink?

BrickLink Store API helper/CLI (OAuth 1.0 request signing). Covers orders, store inventory (read + write), catalog, categories, colors, feedback, and push no... It is an AI Agent Skill for Claude Code / OpenClaw, with 2456 downloads so far.

How do I install Bricklink?

Run "/install bricklink" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Bricklink free?

Yes, Bricklink is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Bricklink support?

Bricklink is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Bricklink?

It is built and maintained by Oliver Drobnik (@odrobnik); the current version is v1.4.2.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 Comments