instapaper

Use when operating the instapaper-cli (ip) tool or troubleshooting it: authenticating, listing/exporting/importing bookmarks, bulk mutations, folders/highlights/text, choosing output formats (ndjson/json/plain), cursor-based sync, and interpreting stderr-json/exit codes for automation.

1. Zainstaluj instapaper-cli. Uruchom go install github.com/vburojevic/instapaper-cli/cmd/ip@latest lub użyj Homebrew: brew tap vburojevic/tap && brew install instapaper-cli. Upewnij się, że polecenie ip jest dostępne w PATH.

2. Skonfiguruj uwierzytelnianie. Ustaw zmienne środowiskowe INSTAPAPER_CONSUMER_KEY i INSTAPAPER_CONSUMER_SECRET lub przekaż je podczas logowania. Użyj flagi --password-stdin zamiast przechowywania hasła w tekście. Sprawdź konfigurację poleceniem ip doctor --json lub ip auth status przed długimi operacjami.

3. Wybierz format wyjścia do automatyzacji. Domyślnie --ndjson (streaming, jeden obiekt na linię) — najlepszy do przetwarzania dużych zbiorów. Użyj --json dla pojedynczych obiektów lub kompaktowych tablic. Użyj --plain dla stabilnego, liniowego tekstu. Dodaj --stderr-json dla strukturalnych błędów i --progress-json dla długotrwałych operacji.

4. Czytaj dane deterministycznie. Użyj ip list lub ip export z flagami --cursor i --cursor-dir do synchronizacji przyrostowej lub --since/--until do ograniczenia zakresu. Flaga --updated-since przydaje się do inkrementalnego sync. Użyj --select do filtrowania po stronie klienta, jeśli API tego nie wspiera.

5. Mutuj dane bezpiecznie. Zawsze testuj operacje z --dry-run lub --idempotent. Do akcji masowych użyj --ids lub --stdin i rozważ --batch. Usunięcia wymagają jawnych flag potwierdzenia.

6. Zarządzaj folderami, wyróżnieniami i tekstem. Użyj ip folders list/add/delete/order do zarządzania folderami, ip highlights list/add/delete do wyróżnień oraz ip text do pobrania HTML artykułu.