Μετάβαση στο περιεχόμενο
Όλα τα άρθρα

climcpapi

Ένα CLI για σύντομους συνδέσμους, για developers και AI agents

Συντομεύστε URLs από τη γραμμή εντολών με το Linkdash CLI. Μοιραστείτε αρχεία και αποσπάσματα, τρέξτε A/B tests, στοχεύστε επισκέπτες, συνδέστε agents μέσω MCP.

Igor Kirnosov10 λεπ. ανάγνωσης

Τερματικό που δημιουργεί σύντομο σύνδεσμο Linkdash με την εντολή linkdash links create

Το Linkdash είναι ένας URL shortener που χειρίζεστε από το τερματικό. Μία εντολή μετατρέπει ένα URL, ένα αρχείο ή ένα απόσπασμα κειμένου σε σύντομο σύνδεσμο με παρακολούθηση στο lida.sh και εμφανίζει το αποτέλεσμα ως JSON που μπορείτε να διοχετεύσετε οπουδήποτε. Οι ίδιες λειτουργίες είναι διαθέσιμες μέσω HTTP API και ως MCP server, ώστε ένας AI agent να μπορεί να δημιουργεί, να ενημερώνει και να μετρά συνδέσμους με ακριβώς τα ίδια εργαλεία που χρησιμοποιείτε εσείς.

Αυτός ο οδηγός περνά από όλο το CLI: την εγκατάσταση, τον πρώτο σας σύντομο σύνδεσμο, την κοινή χρήση αρχείων, το κλείδωμα συνδέσμων, τα A/B tests, τη δρομολόγηση επισκεπτών ανά χώρα ή συσκευή και την ανάγνωση αναλυτικών στοιχείων χωρίς να ανοίξετε browser.

Ο πίνακας ελέγχου του Linkdash με λίστα σύντομων συνδέσμων, τον τύπο, το slug, τον προορισμό και την κατάστασή τους

Εγκαταστήστε το Linkdash CLI

Το CLI είναι πακέτο npm και χρειάζεται Node.js 20 ή νεότερο.

npm i -g linkdash-cli

Λειτουργεί το ίδιο με pnpm add -g linkdash-cli ή bun add -g linkdash-cli. Η εντολή που εγκαθιστά είναι linkdash.

Μετά δημιουργήστε λογαριασμό και συνδέστε το CLI, σε ένα βήμα:

linkdash auth create

Αυτό ανοίγει τη σελίδα εγγραφής στον browser σας. Μόλις έχετε λογαριασμό, εγκρίνετε τον κωδικό που εμφανίζεται στο τερματικό σας και το CLI συνδέεται. Αν έχετε ήδη λογαριασμό, χρησιμοποιήστε καλύτερα το linkdash auth login. Το linkdash auth whoami επιβεβαιώνει ποιον λογαριασμό χρησιμοποιείτε, και η αναφορά του CLI έχει κάθε εντολή και flag.

Η συνεδρία αποθηκεύεται στο ~/.config/linkdash/config.json με δικαιώματα μόνο για τον κάτοχο. Για CI ή άλλα headless περιβάλλοντα, ορίστε το LINKDASH_TOKEN στο session token από αυτό το αρχείο σε ένα μηχάνημα όπου έχετε συνδεθεί, και χειριστείτε το όπως κάθε άλλο secret.

Συντομεύστε ένα URL από τη γραμμή εντολών

linkdash links create --url https://example.com/pricing --slug pricing
{
  "id": "pricing",
  "url": "https://lida.sh/pricing",
  "kind": "url",
  "variants": [
    { "name": "main", "kind": "url" }
  ]
}

Αυτή είναι όλη η διεπαφή: οι επιτυχημένες εντολές εμφανίζουν JSON στο stdout και τα σφάλματα εμφανίζουν απλό κείμενο στο stderr με exit code 1. Δεν υπάρχει flag --json, γιατί το JSON είναι η μόνη έξοδος. Αυτό κάνει το CLI εύκολο στα scripts. Για να αντιγράψετε έναν νέο σύντομο σύνδεσμο κατευθείαν στο πρόχειρο σε macOS:

linkdash links create --url https://example.com/pricing | jq -r .url | pbcopy

Μερικά flags που θα χρησιμοποιείτε συνέχεια:

  • Το --slug ορίζει τη δημόσια διαδρομή. Τα slugs χρησιμοποιούν πεζά λατινικά γράμματα, ψηφία και ενδιάμεσες παύλες, έως 64 χαρακτήρες. Αν το παραλείψετε, το Linkdash δημιουργεί ένα.
  • Το --name είναι μια ιδιωτική ετικέτα που βλέπετε μόνο εσείς, χρήσιμη για να βρίσκετε συνδέσμους αργότερα.
  • Το --tag επαναλαμβάνεται, οπότε το --tag launch --tag q4 βάζει δύο ετικέτες σε έναν σύνδεσμο.
  • Τα --utm-source, --utm-medium, --utm-campaign, --utm-term και --utm-content προσθέτουν παραμέτρους καμπάνιας στον προορισμό.

Δείτε και αναζητήστε όσα έχετε δημιουργήσει με linkdash links list --q pricing --tag launch.

Μοιραστείτε ένα αρχείο ή ένα απόσπασμα κειμένου

Οι σύντομοι σύνδεσμοι δεν είναι μόνο για URLs. Η ίδια εντολή ανεβάζει ένα αρχείο ή αποθηκεύει ένα απόσπασμα:

linkdash links create --file ./board-deck.pdf --slug board-deck --expires 7d
linkdash links create --text "Release checklist: tag, build, smoke test, announce" --tag launch

Ένας σύνδεσμος αρχείου δίνει στους επισκέπτες λήψη, με προεπισκόπηση για εικόνες και βίντεο. Ένας σύνδεσμος κειμένου δείχνει το απόσπασμα σε μια σελίδα με κουμπί αντιγραφής. Και οι δύο παρακολουθούνται όπως κάθε άλλος σύνδεσμος, οπότε βλέπετε ποιος άνοιξε την παρουσίασή σας και πότε. Για να αντικαταστήσετε το αρχείο πίσω από έναν υπάρχοντα σύνδεσμο χωρίς να αλλάξει το URL:

linkdash links update board-deck --file ./board-deck-v2.pdf

Ελέγξτε ποιος μπορεί να ανοίξει έναν σύνδεσμο

Κάθε σύνδεσμος μπορεί να έχει τους δικούς του κανόνες πρόσβασης:

linkdash links create --url https://example.com/decks/q4-2026 \
  --slug q4-deck \
  --password "$DECK_PASSWORD" \
  --expires 14d \
  --max-openings 50
  • Το --password ζητά από τους επισκέπτες κωδικό πριν ανοίξει ο σύνδεσμος.
  • Τα --starts και --expires δέχονται διάρκεια όπως 30m, 24h ή 7d, ή ημερομηνία ISO. Πριν από την ώρα έναρξης, ένας σύνδεσμος δεν ανοίγει καθόλου.
  • Το --max-openings θέτει τον σύνδεσμο σε παύση μετά από τόσα ανοίγματα, κάτι χρήσιμο για λήψεις μίας χρήσης.

Μπορείτε να θέσετε σε παύση και να συνεχίσετε έναν σύνδεσμο οποιαδήποτε στιγμή με linkdash links update q4-deck --status paused και --status active.

Τρέξτε A/B test σε έναν σύντομο σύνδεσμο

Στο Linkdash, κάθε σύνδεσμος είναι ένα δοχείο μίας ή περισσότερων παραλλαγών. Μια παραλλαγή είναι ένας προορισμός (URL, αρχείο ή κείμενο) με δικό του βάρος και κανόνες. Ένας κανονικός σύνδεσμος έχει μία παραλλαγή με όνομα main. Προσθέστε κι άλλες και ο σύντομος σύνδεσμος μοιράζει την κίνησή του ανάμεσά τους:

linkdash links create --slug launch \
  --variant control --url https://example.com/pricing \
  --variant annual-first --url "https://example.com/pricing?view=annual"

Τα flags μετά από κάθε --variant ανήκουν σε εκείνη την παραλλαγή μέχρι την επόμενη. Η κίνηση μοιράζεται με βάση το βάρος, που από προεπιλογή είναι 1, οπότε το παραπάνω παράδειγμα είναι μια δοκιμή 50/50. Δώστε σε μια παραλλαγή --weight 3 για να της στείλετε τριπλάσια κίνηση.

Η ανάθεση είναι σταθερή από προεπιλογή: ένας επισκέπτης που επιστρέφει παίρνει πάντα την ίδια παραλλαγή, αυτό ακριβώς που θέλετε για μια δίκαιη δοκιμή. Όταν αλλάζετε το πείραμα, το linkdash links update launch --restart-split ανακατεύει ξανά όλους μία φορά.

Ένας σύνδεσμος Linkdash με δύο παραλλαγές, control και annual-first, που μοιράζει την κίνηση ανάμεσα σε δύο σελίδες τιμών

Τα στατιστικά επιστρέφουν ανά παραλλαγή, ώστε να τις συγκρίνετε απευθείας:

linkdash links stats launch --last 7d

Ο πίνακας variants στην έξοδο αναφέρει visits, visitors, downloads και plays για κάθε παραλλαγή. Περισσότερα για τα στατιστικά παρακάτω.

Δρομολογήστε επισκέπτες ανά χώρα, συσκευή ή παράμετρο ερωτήματος

Οι παραλλαγές μπορούν επίσης να έχουν συνθήκες. Προσθέστε --when σε μια παραλλαγή και μόνο οι επισκέπτες που ταιριάζουν μπορούν να τη λάβουν. Έτσι ένας σύντομος σύνδεσμος γίνεται router. Για παράδειγμα, ένας σύνδεσμος που στέλνει τα κινητά στο σωστό app store:

linkdash links create --slug get-app \
  --variant ios \
    --url https://apps.apple.com/app/example/id000000000 \
    --when os=ios \
  --variant android \
    --url "https://play.google.com/store/apps/details?id=com.example" \
    --when os=android \
  --variant web \
    --url https://example.com/app

Όταν ένας επισκέπτης ανοίγει τον σύνδεσμο, οι παραλλαγές των οποίων οι συνθήκες ταιριάζουν σχηματίζουν τη δεξαμενή. Αν δεν ταιριάζει καμία, χρησιμοποιούνται οι παραλλαγές χωρίς συνθήκες, οπότε η web παραπάνω πιάνει όλους όσοι δεν είναι σε iOS ή Android.

Ένας σύνδεσμος Linkdash που δρομολογεί τους επισκέπτες στο App Store σε iOS, στο Google Play σε Android και σε μια ιστοσελίδα για όλους τους άλλους

Μπορείτε να ελέγξετε:

Κλειδί Ταιριάζει με Παράδειγμα
country Κωδικούς χωρών ISO --when country=DE,AT,CH
device mobile, tablet, desktop --when device=mobile
os windows, macos, android, ios, linux, other --when os=ios
browser edge, chrome, firefox, safari, other --when browser=safari
language Language tags, κατά πρόθεμα --when language=de
referrer Τον host παραπομπής --when referrer=twitter.com

Επαναλάβετε το --when για να απαιτήσετε πολλές συνθήκες ταυτόχρονα. Το --when country=DE,AT --when device=mobile ταιριάζει με επισκέπτες από κινητό από τη Γερμανία ή την Αυστρία.

Οι παραλλαγές μπορούν επίσης να ελέγχουν το query string του επισκέπτη, ώστε ένας σύνδεσμος να συμπεριφέρεται διαφορετικά ανάλογα με το πού τον μοιραστήκατε. Το lida.sh/launch?src=newsletter μπορεί να στέλνει τους αναγνώστες του newsletter κάπου ξεχωριστά:

linkdash links variants add launch --name newsletter \
  --url https://example.com/pricing/newsletter \
  --when param:src=newsletter

Οι κανόνες παραμέτρων υποστηρίζουν ισότητα (=), ανισότητα (!=), περιέχει (~=), ξεκινά με (^=), τελειώνει σε ($=), ένα από (=a|b), υπάρχει (param:ref?) και λείπει (param:!ref). Αν θέλετε αντίθετα οι παράμετροι του επισκέπτη να περνούν στον προορισμό, δημιουργήστε τον σύνδεσμο με --forward-params.

Ο πίνακας ελέγχου έχει τις ίδιες ρυθμίσεις, με επιλογέα χωρών που αναζητά με βάση το όνομα, οπότε δεν χρειάζεται να θυμάστε ότι η Σλοβενία είναι SI:

Επιλογή χωρών-στόχων για μια παραλλαγή στον πίνακα ελέγχου του Linkdash, με επιλεγμένες τη Γερμανία και την Αυστρία

Διαβάστε αναλυτικά στοιχεία κλικ από το τερματικό

linkdash links stats launch --last 7d

Η έξοδος περιλαμβάνει τα συνολικά visits, downloads και plays, τον αριθμό επισκέψεων στο διάστημα που ζητήσατε (visitsInLast), τις countries και τους referrers από όπου ήρθαν αυτές οι επισκέψεις, μια ανάλυση variants και μια λίστα visitors με την ώρα, τη χώρα, τη συσκευή, τον browser και την παραπομπή κάθε πρόσφατης επίσκεψης. Το --last δέχεται διάρκεια όπως 24h ή 30d και από προεπιλογή είναι 24h.

Το Linkdash δεν αποθηκεύει τις διευθύνσεις IP των επισκεπτών. Η διεύθυνση χρησιμοποιείται για να βρεθεί η χώρα του επισκέπτη και για να παραχθεί ένα ανώνυμο αναγνωριστικό επισκέπτη που αλλάζει καθημερινά, και μετά απορρίπτεται.

Για να αντιδράτε στα κλικ τη στιγμή που γίνονται, καταχωρίστε ένα webhook. Το Linkdash στέλνει υπογεγραμμένα συμβάντα link.visit, link.download και link.play σε οποιοδήποτε HTTPS endpoint:

linkdash webhooks create --url https://example.com/hooks

Το μυστικό υπογραφής εμφανίζεται μία φορά, οπότε αποθηκεύστε το αμέσως. Δείτε την τεκμηρίωση των webhooks για την επαλήθευση υπογραφών.

Αφήστε τους AI agents να δημιουργούν σύντομους συνδέσμους με MCP

Όλα τα παραπάνω είναι διαθέσιμα και στους AI agents. Το Linkdash τρέχει έναν απομακρυσμένο MCP server στο https://api.linkdash.dev/mcp, και τα εργαλεία του αντιστοιχούν στο CLI: links_create, links_update, links_stats, variants_add, domains_add και τα υπόλοιπα, επιστρέφοντας το ίδιο JSON.

Δημιουργήστε ένα κλειδί API στον πίνακα ελέγχου, στα Κλειδιά API, και μετά συνδέστε τον agent σας. Στο Claude Code:

claude mcp add --transport http linkdash https://api.linkdash.dev/mcp \
  --header "Authorization: Bearer $LINKDASH_API_KEY"

Στο Cursor, προσθέστε το στο .cursor/mcp.json:

{
  "mcpServers": {
    "linkdash": {
      "url": "https://api.linkdash.dev/mcp",
      "headers": { "Authorization": "Bearer ${env:LINKDASH_API_KEY}" }
    }
  }
}

Στο Codex, που διαβάζει το κλειδί από τη μεταβλητή περιβάλλοντος που ορίζετε:

codex mcp add linkdash --url https://api.linkdash.dev/mcp \
  --bearer-token-env-var LINKDASH_API_KEY

Από εκεί και πέρα μπορείτε να ζητάτε συνδέσμους σε απλή γλώσσα, όπως «συντόμευσε το https://example.com/pricing ως pricing και βάλε του την ετικέτα launch» ή «ποια παραλλαγή του launch είχε περισσότερους επισκέπτες αυτή την εβδομάδα;», και ο agent καλεί το σωστό εργαλείο. Η τεκμηρίωση MCP καλύπτει και το OpenCode.

Αν ο agent σας δουλεύει ήδη σε τερματικό, μπορεί να χρησιμοποιεί απευθείας το CLI. Εγκαταστήστε το skill του Linkdash για agents ώστε να γνωρίζει τις εντολές και τα flags:

npx skills add https://linkdash.dev/skills/linkdash/SKILL.md

Χρησιμοποιήστε το HTTP API

Για τον δικό σας κώδικα, οι ίδιες λειτουργίες είναι ένα απλό REST API στο https://api.linkdash.dev/v1, με αυθεντικοποίηση μέσω του ίδιου κλειδιού API:

curl https://api.linkdash.dev/v1/links \
  -H "Authorization: Bearer $LINKDASH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://example.com/pricing", "slug": "pricing" }'

Η απάντηση έχει την ίδια μορφή με την έξοδο του CLI. Η αναφορά του API καλύπτει κάθε endpoint, μαζί με τις μεταφορτώσεις αρχείων και τις παραλλαγές.

Χρησιμοποιήστε το δικό σας domain

Οι σύντομοι σύνδεσμοι βρίσκονται από προεπιλογή στο lida.sh. Για να τους εξυπηρετείτε από το δικό σας domain, προσθέστε το και στρέψτε το DNS σας στο Linkdash:

linkdash domains add go.example.com
linkdash domains verify go.example.com

Μετά δημιουργήστε συνδέσμους σε αυτό με --domain go.example.com. Κάθε προσαρμοσμένο domain έχει το δικό του σύνολο slugs, οπότε το go.example.com/launch δεν συγκρούεται με το launch κανενός άλλου. Ο οδηγός για τα domains καλύπτει τη ρύθμιση DNS, μαζί με τη ρύθμιση με ένα κλικ για τους παρόχους που την υποστηρίζουν.

Τιμές

Το πρόγραμμα Free δεν χρειάζεται πιστωτική κάρτα και περιλαμβάνει 5.000 συμβάντα τον μήνα, 1 GB χώρο για αρχεία, ιστορικό αναλυτικών στοιχείων ενός μήνα και ένα προσαρμοσμένο domain. Συμβάν είναι μια επίσκεψη, λήψη ή αναπαραγωγή σε έναν από τους συνδέσμους σας, ή μια εγγραφή, όπως η δημιουργία ή η ενημέρωση ενός συνδέσμου. Οι αναγνώσεις, όπως η λίστα συνδέσμων ή η ανάκτηση στατιστικών, είναι δωρεάν.

Τα επί πληρωμή προγράμματα αυξάνουν αυτά τα όρια: το Professional κοστίζει 18 $ τον μήνα και το Growth 48 $ τον μήνα. Δείτε τις τιμές για την πλήρη σύγκριση.

Συχνές ερωτήσεις

Υπάρχει δωρεάν URL shortener με CLI;

Ναι. Το Linkdash CLI λειτουργεί στο πρόγραμμα Free, που περιλαμβάνει 5.000 συμβάντα τον μήνα χωρίς πιστωτική κάρτα.

Μπορώ να χρησιμοποιήσω το Linkdash CLI σε CI;

Ναι. Ορίστε το LINKDASH_TOKEN σε ένα session token και το CLI τρέχει χωρίς browser. Επειδή κάθε εντολή εμφανίζει JSON, μπορείτε να δημιουργείτε και να ενημερώνετε συνδέσμους από GitHub Actions ή οποιοδήποτε άλλο pipeline και να διαβάζετε τα αποτελέσματα με jq.

Μπορούν οι AI agents να δημιουργούν σύντομους συνδέσμους;

Ναι, με τρεις τρόπους: μέσω του MCP server στο https://api.linkdash.dev/mcp, μέσω του CLI με εγκατεστημένο το skill του Linkdash για agents ή μέσω του HTTP API. Και οι τρεις εκθέτουν τις ίδιες λειτουργίες και επιστρέφουν το ίδιο JSON.

Αποθηκεύει το Linkdash τις διευθύνσεις IP των επισκεπτών;

Όχι. Το Linkdash χρησιμοποιεί τη διεύθυνση για να βρει τη χώρα του επισκέπτη και για να δημιουργήσει ένα ημερήσιο ανώνυμο αναγνωριστικό, και μετά την απορρίπτει. Οι κάτοχοι συνδέσμων δεν βλέπουν ποτέ διευθύνσεις IP.

Μπορεί ένας σύντομος σύνδεσμος να στέλνει διαφορετικούς επισκέπτες σε διαφορετικές σελίδες;

Ναι. Δώστε σε έναν σύνδεσμο πολλές παραλλαγές και προσθέστε σε καθεμία συνθήκες όπως χώρα, συσκευή, λειτουργικό σύστημα, γλώσσα, παραπομπή ή παράμετρο ερωτήματος. Χωρίς συνθήκες, οι παραλλαγές μοιράζουν την κίνηση με βάση το βάρος, και έτσι τρέχετε ένα A/B test.


Έτοιμοι να το δοκιμάσετε; Εγκαταστήστε το CLI, εκτελέστε linkdash auth create και συντομεύστε τον πρώτο σας σύνδεσμο σε λιγότερο από ένα λεπτό. Η γρήγορη εκκίνηση έχει κάθε βήμα.