Every MakerWorld model, searchable offline — plus trend deltas, designer-watch, and multi-tag discovery no scraper or the web UI offers.
A fast, agent-native CLI over MakerWorld's public catalog. Browse, search, and inspect 3D models from the terminal, mirror them into a local SQLite database for offline full-text search, then run queries the platform never exposes: what is newly rising (movers), which tracked designers shipped (designers deltas), and which models match a precise tag combination (tags). Reads need no account; an optional token unlocks 3MF downloads and your favorites.
Authentication
Browsing, search, and model details work with no credentials against Bambu Lab's public API. To download 3MF files or read your favorites, set MAKERWORLD_TOKEN to a Bambu Cloud token (the same JWT the Bambu Handy app uses).
Quick Start
# Health check — confirms the CLI and API host are reachable; needs no auth.
makerworld-pp-cli doctor --dry-run
# See what is trending right now, straight from the public API.
makerworld-pp-cli designs list --nav Trending --limit 10
# Keyword-search the live catalog (designs search).
makerworld-pp-cli designs search "articulated dragon" --limit 10
# Mirror a slice of the catalog into local SQLite for offline search and deltas.
makerworld-pp-cli sync --resources designs --max-pages 5
# Surface high-quality models from your local mirror.
makerworld-pp-cli discover --sort quality --limit 20
Unique Features
These capabilities aren't available in any other tool for this API.
Local state that compounds
-
discover — Find models that are both highly rated and printable on your setup, ranked by a composite quality score from your local mirror; constrain with --printable, --no-ams, --material, or --max-weight.
Reach for this when an agent needs models filtered by real quality and printer fit, not just popularity.
makerworld-pp-cli discover --sort quality --no-ams --limit 20 --agent
-
designers deltas — See which tracked designers posted new models or climbed in rank since your last sync.
Use this to answer 'what changed for the creators I follow' without re-scanning every profile.
makerworld-pp-cli designers deltas --limit 50 --agent
-
movers — Rank models by the biggest jump in likes, downloads, or prints between your two most recent syncs.
Pick this over 'browse --nav Trending' when the question is what is rising right now, not what is popular overall.
makerworld-pp-cli movers --metric downloads --limit 25 --agent
Service-specific structure
-
tags — List the most common tags across your synced catalog, or find models matching ALL of several tags at once.
Use this to narrow to models matching a precise combination of tags, not just one.
makerworld-pp-cli tags toy fidget --limit 15 --agent
Recipes
Inspect a model's printer requirements (deeply nested — narrow with --select)
makerworld-pp-cli designs get 2865269 --agent --select title,downloadCount,instances.weight,instances.needAms,instances.materialCnt
Pull just the fields that decide whether a model fits your printer, instead of the full multi-KB design payload.
Find newly-rising household models
makerworld-pp-cli movers --metric downloads --limit 15 --agent
Rank models by download growth between your two most recent syncs.
Track what your favorite designers shipped
makerworld-pp-cli designers deltas --limit 30 --agent
Roll up new uploads and rank rises across all synced designers.
Only models printable without AMS
makerworld-pp-cli discover keychain --printable --no-ams --limit 20 --agent
Constrain discovery to single-material models that print on a base machine (no AMS).
Usage
Run makerworld-pp-cli --help for the full command reference and flag list.
Commands
categories
List MakerWorld navigation categories
makerworld-pp-cli categories - List navigation categories and their keys
designers
Look up a designer's published models
makerworld-pp-cli designers - List a designer's published designs by their numeric user ID
designs
Browse, search, and inspect MakerWorld designs (3D models)
makerworld-pp-cli designs get - Get full detail for one design (instances, creator, tags, counts)makerworld-pp-cli designs list - List designs by navigation category (Trending, For You, or a category key)makerworld-pp-cli designs ratings - List comments and star ratings for a designmakerworld-pp-cli designs recommend - List recommended-for-you designsmakerworld-pp-cli designs related - List designs related to a given designmakerworld-pp-cli designs remixes - List designs that are remixes of a given designmakerworld-pp-cli designs search - Keyword-search the live MakerWorld catalog
Output Formats
# Human-readable table (default in terminal, JSON when piped)
makerworld-pp-cli categories
# JSON for scripting and agents
makerworld-pp-cli categories --json
# Filter to specific fields
makerworld-pp-cli categories --json --select id,name,status
# Dry run — show the request without sending
makerworld-pp-cli categories --dry-run
# Agent mode — JSON + compact + no prompts in one flag
makerworld-pp-cli categories --agent
Agent Usage
This CLI is designed for AI agent consumption:
- Non-interactive - never prompts, every input is a flag
- Pipeable -
--json output to stdout, errors to stderr
- Filterable -
--select id,name returns only fields you need
- Previewable -
--dry-run shows the request without sending
- Read-only by default - this CLI does not create, update, delete, publish, send, or mutate remote resources
- Offline-friendly - sync/search commands can use the local SQLite store when available
- Agent-safe by default - no colors or formatting unless
--human-friendly is set
Exit codes: 0 success, 2 usage error, 3 not found, 5 API error, 7 rate limited, 10 config error.
Health Check
makerworld-pp-cli doctor
Verifies configuration and connectivity to the API.
Configuration
Config file: ~/.config/makerworld-pp-cli/config.toml
Static request headers can be configured under headers; per-command header overrides take precedence.
Troubleshooting
Not found errors (exit code 3)
- Check the resource ID is correct
- Run the
list command to see available items
API-specific
- the live keyword search returns no results for a query — Some queries are rank-gated; retry with: designs search --order-by hotScore, or sync then use offline FTS: search .
- movers or designers deltas returns empty — These need at least two syncs to diff. Run 'sync' again later, then re-run.
- download fails with 401/403 — Set MAKERWORLD_TOKEN to a current Bambu Cloud JWT; tokens expire after ~90 days.