Linkly CLI

Linkly CLI to narzędzie wiersza poleceń do zarządzania kontem Linkly z terminala. Twórz linki skrócone, pobieraj analitykę kliknięć, zarządzaj domenami niestandardowymi, obsługuj webhooki i eksportuj dane — bez opuszczania powłoki ani pisania kodu API.

Zbudowany na bazie Linkly API i działa na macOS, Linux i Windows.

Instalacja

CLI wymaga Node.js w wersji 20 lub nowszej. Zainstaluj go globalnie za pomocą npm:

npm install -g @linkly-link-shortener/cli

To dodaje polecenie linkly do Twojego systemu. Potwierdź, że działa:

linkly --help

Logowanie

CLI obsługuje dwa sposoby logowania. Musisz to zrobić tylko raz — Twoje poświadczenia są bezpiecznie zapisane na Twojej maszynie i ponownie używane przy każdym uruchomieniu.

Aby zalogować się za pomocą klucza API, uruchom:

linkly auth login --api-key

Zostaniesz poproszony o wklejenie klucza API, który możesz znaleźć w ustawieniach konta Linkly.

Aby zalogować się za pomocą OAuth, uruchom:

linkly auth login

To otwiera Twoją przeglądarkę, abyś mógł zatwierdzić dostęp — nie ma klucza API do skopiowania.

Sprawdź swój status lub wyloguj się w dowolnym momencie:

linkly auth status

linkly auth logout

Tworzenie i zarządzanie linkami

Twórz, wyszukuj, sprawdzaj, aktualizuj i usuwaj linki skrócone:

linkly links create --url https://example.com --name "Spring promo"

linkly links list --search promo

linkly links get 12345

linkly links update 12345 --url https://example.com/new

linkly links delete 12345

Analityka kliknięć

Wyświetl sumy kliknięć pogrupowane według kraju, przeglądarki, platformy i innych — lub jako szereg czasowy w zakresie dat:

linkly analytics by country

linkly analytics timeseries --start 2026-01-01 --end 2026-01-31

Domeny niestandardowe

Wyświetl listę swoich domen niestandardowych lub dodaj nową:

linkly domains list

linkly domains create links.example.com

Kody QR i eksport danych

Pobierz kod QR linku lub eksportuj swoje linki i dane kliknięć jako CSV lub JSON:

linkly links qr 12345 --output qr.png

linkly links export --format csv --output links.csv

linkly analytics export --format csv --output clicks.csv

Webhooki

Subskrybuj adres URL, aby otrzymywać zdarzenia kliknięcia w czasie rzeczywistym dla jednego linku lub całego obszaru roboczego:

linkly webhooks add https://example.com/hook --link 12345

Praca z wieloma obszarami roboczymi

Jeśli Twoje konto ma więcej niż jeden obszar roboczy, ustaw domyślny:

linkly workspaces list

linkly workspaces use 42

Możesz również wskazać konkretny obszar roboczy dla jednego polecenia za pomocą opcji --workspace.

Wyjście JSON dla skryptów

Dodaj --json do dowolnego polecenia, aby uzyskać surową odpowiedź API zamiast sformatowanej tabeli — przydatne do przesyłania do narzędzi takich jak jq:

linkly links list --json

Uzyskiwanie pomocy

Każde polecenie ma wbudowaną pomoc. Uruchom linkly --help, aby uzyskać przegląd, lub dodaj --help do dowolnego polecenia, aby zobaczyć jego opcje i przykłady:

linkly links create --help

Używanie CLI z agentami AI

Asystenci kodowania, którzy mogą uruchamiać polecenia powłoki — takie jak Claude Code lub Cursor — mogą bezpośrednio obsługiwać Linkly CLI.

• Dodaj --json do dowolnego polecenia, aby uzyskać surową odpowiedź API zamiast sformatowanej tabeli.
• Uruchom linkly schema, aby wydrukować pełne drzewo poleceń — każde polecenie, argument i opcję — jako JSON, aby asystent mógł odkryć, co CLI potrafi robić.
• Dodaj --help do dowolnego polecenia, aby zobaczyć jego opcje i przykłady.

Jeśli Twój asystent AI nie może uruchamiać poleceń powłoki, zamiast tego użyj Serwera Linkly MCP — łączy asystentów takich jak Claude i ChatGPT bezpośrednio z Twoim kontem Linkly.

Powiązane artykuły

• Linkly API
• Analytics API
• QR Code Generator API
• Webhooki
• Serwer Linkly MCP