find-stl

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.

1. Zainstaluj skill w swoim środowisku, upewniając się, że masz dostęp do skryptu scripts/find_stl.py i zainstalowane wymagane zależności Pythona.

2. Wyszukaj model, uruchamiając polecenie search z nazwą części lub koncepcji – na przykład python3 scripts/find_stl.py search "iphone 15 pro dock" --limit 10. Parametr --limit określa maksymalną liczbę wyników; domyślnie zwracane są pierwsze 10 modeli z Printables.

3. Przejrzyj wyniki wyszukiwania i wybierz model, który Cię interesuje. Zanotuj jego identyfikator (ID) – będzie potrzebny do pobrania plików.

4. Pobierz model i wszystkie powiązane pliki, używając polecenia fetch z ID modelu i ścieżką wyjściową – na przykład python3 scripts/find_stl.py fetch 1059554 --outdir out/models. Skrypt automatycznie pobierze wszystkie dostępne pliki (w tym pakiet ZIP, jeśli istnieje) i rozwiąże czasowo ograniczone linki pobierania za pośrednictwem API Printables.

5. Po pobraniu sprawdź wygenerowany plik manifest.json w katalogu wyjściowym – zawiera on URL źródła, nazwę autora, identyfikator licencji, listę plików i ich hasze kontrolne. Zachowaj te informacje do cytowania i drukowania.

6. Użyj pobranego folderu z modelami do dalszych procesów – drukowania, wyceny lub integracji z innymi narzędziami.