---
name: find-stl
description: "Search and download ready-to-print 3D model files (STL/3MF/ZIP) for a concept or specific part by querying Printables (first). Use when an agent needs to find an existing model, capture license/attribution, download the source files, and output a local folder + manifest for quoting/printing."
---

# find-stl

This skill provides a deterministic pipeline:
- search Printables for models
- select a candidate
- download model files
- write a `manifest.json` (source URL, author, license id, files, hashes)

## Quick start

### Search

```bash
python3 scripts/find_stl.py search "iphone 15 pro dock" --limit 10
```

### Fetch

```bash
python3 scripts/find_stl.py fetch 1059554 --outdir out/models
```

By default, fetch downloads **all model files** (a ZIP pack) when available.

## Notes

- Printables download links are time-limited; this script resolves them via Printables GraphQL (`getDownloadLink`).
- Always preserve license + attribution in the manifest.

## Resources

- `scripts/find_stl.py`