Pp Makerworld

<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/media-and-entertainment/makerworld/SKILL.md,
     regenerated post-merge by tools/generate-skills/. Hand-edits here are
     silently overwritten on the next regen. Edit the library/ source instead.
     See the repository agent guide, section "Generated artifacts: registry.json, cli-skills/". -->

MakerWorld — Printing Press CLI

Prerequisites: Install the CLI

This skill drives the makerworld-pp-cli binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first:

1. Install via the Printing Press installer. It defaults binaries to $HOME/.local/bin on macOS/Linux and %LOCALAPPDATA%\Programs\PrintingPress\bin on Windows:

   npx -y @mvanhorn/printing-press-library install makerworld --cli-only

2. Verify: makerworld-pp-cli --version
3. Ensure the reported install directory is on $PATH for the agent/runtime that will invoke this skill.

If the npx install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.4 or newer). This installs into $GOPATH/bin (default $HOME/go/bin), so add that directory to $PATH instead:

go install github.com/mvanhorn/printing-press-library/library/media-and-entertainment/makerworld/cmd/makerworld-pp-cli@latest

If --version reports "command not found" after install, the runtime cannot see the binary directory on $PATH. Do not proceed with skill commands until verification succeeds.

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.

When to Use This CLI

Use this CLI when an agent or script needs MakerWorld catalog data as structured JSON: discovering printable models by quality or printer fit, tracking designers and trends over time, or resolving a model to its downloadable 3MF. It shines for repeated, queryable access where the web UI's per-visit browsing and opaque ranking fall short.

Anti-triggers

Do not use this CLI for:

• Do not use this CLI to slice models or generate G-code — it fetches catalog data and 3MF files, not slicer output.
• Do not use it to control or monitor a physical Bambu printer (MQTT/print jobs) — it is catalog-only.
• Do not use it to publish, edit, or moderate your own designs — it is read-and-download oriented.

Unique Capabilities

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

Command Reference

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 design
• makerworld-pp-cli designs recommend — List recommended-for-you designs
• makerworld-pp-cli designs related — List designs related to a given design
• makerworld-pp-cli designs remixes — List designs that are remixes of a given design
• makerworld-pp-cli designs search — Keyword-search the live MakerWorld catalog

Finding the right command

When you know what you want to do but not which command does it, ask the CLI directly:

makerworld-pp-cli which "<capability in your own words>"

which resolves a natural-language capability query to the best matching command from this CLI's curated feature index. Exit code 0 means at least one match; exit code 2 means no confident match — fall back to --help or use a narrower query.

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).