Linkly CLI

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

Zbudowane na Linkly API i działające 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. Wystarczy to zrobić raz — Twoje dane logowania 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 swojego 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, przeszukuj, sprawdzaj, aktualizuj i usuwaj skróty linków:

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 nie tylko — lub jako szereg czasowy w wybranym zakresie dat:

linkly analytics by country

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

Domeny niestandardowe

Wylistuj swoje domeny niestandardowe 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

Webhoki

Subskrybuj adres URL, aby otrzymywać zdarzenia kliknięć 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ć określony obszar roboczy dla pojedynczego 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 potokowania do narzędzi takich jak jq:

linkly links list --json

Otrzymywanie 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 może zrobić.
• 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, użyj zamiast tego Linkly MCP Server — łączy asystentów takich jak Claude i ChatGPT bezpośrednio z Twoim kontem Linkly.