find-stl

Skill do wyszukiwania i pobierania plików modeli 3D (STL, 3MF, ZIP) z platformy Printables. Wpisz nazwę części lub koncepcji, a narzędzie automatycznie wyszuka pasujące modele, pobierze pliki źródłowe i utworzy manifest zawierający informacje o autorze, licencji i haszach plików. Idealny dla agentów, które muszą znaleźć gotowe projekty do druku lub cytowania. Obsługuje pobieranie całych pakietów ZIP, gdy są dostępne.

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.