Ugrás a tartalomhoz
Összes bejegyzés

climcpapi

Linkrövidítő CLI fejlesztőknek és AI-ügynököknek

Rövidíts URL-eket parancssorból a Linkdash CLI-jal. Ossz meg fájlokat, futtass A/B teszteket, célozz látogatókat, és kezeltesd a linkeket AI-ügynökkel MCP-n.

Igor Kirnosov9 perc olvasás

Terminál, amely a linkdash links create paranccsal Linkdash rövid linket hoz létre

A Linkdash egy linkrövidítő, amelyet a terminálból irányítasz. Egyetlen parancs egy URL-ből, fájlból vagy szövegrészletből követett rövid linket készít a lida.sh domainen, az eredményt pedig JSON-ként írja ki, amelyet bármibe továbbküldhetsz. Ugyanezek a műveletek elérhetők egy HTTP API-n és MCP-szerverként is, így egy AI-ügynök pontosan ugyanazokkal az eszközökkel hozhat létre, módosíthat és mérhet linkeket, mint te.

Ez az útmutató végigmegy az egész CLI-on: a telepítésen, az első link rövidítésén, a fájlmegosztáson, a linkek védelmén, az A/B teszteken, a látogatók ország vagy eszköz szerinti irányításán, és az analitika olvasásán böngésző nélkül.

A Linkdash irányítópultja a rövid linkek listájával: típus, slug, cél és állapot

A Linkdash CLI telepítése

A CLI egy npm-csomag, és Node.js 20 vagy újabb kell hozzá.

npm i -g linkdash-cli

Ugyanígy működik a pnpm add -g linkdash-cli vagy a bun add -g linkdash-cli paranccsal is. A telepített parancs neve linkdash.

Ezután egy lépésben hozz létre fiókot, és jelentkeztesd be a CLI-t:

linkdash auth create

Ez megnyitja a regisztrációs oldalt a böngésződben. Amint megvan a fiókod, jóváhagyod a terminálban megjelenő kódot, és a CLI be is van jelentkezve. Ha már van fiókod, használd inkább a linkdash auth login parancsot. A linkdash auth whoami megmutatja, melyik fiókot használod, a CLI-referencia pedig felsorolja az összes parancsot és kapcsolót.

A munkamenet a ~/.config/linkdash/config.json fájlban tárolódik, csak a tulajdonos számára olvasható jogosultságokkal. CI-hoz vagy más grafikus felület nélküli környezethez állítsd a LINKDASH_TOKEN változót annak a fájlnak a munkamenet-tokenjére egy olyan gépen, ahol bejelentkeztél, és kezeld úgy, mint bármely más titkos kulcsot.

URL rövidítése parancssorból

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

Ennyi az egész felület: a sikeres parancsok JSON-t írnak a stdoutra, a hibák pedig egyszerű szöveget a stderrre, 1-es kilépési kóddal. Nincs --json kapcsoló, mert a JSON az egyetlen kimenet. Ettől könnyű szkriptelni a CLI-t. Így másolhatsz egy friss rövid linket egyenesen a vágólapra macOS-en:

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

Néhány kapcsoló, amelyet folyamatosan használni fogsz:

  • A --slug a nyilvános elérési utat állítja be. A slug kisbetűket, számjegyeket és belső kötőjeleket tartalmazhat, legfeljebb 64 karakter hosszan. Ha kihagyod, a Linkdash generál egyet.
  • A --name egy privát címke, amelyet csak te látsz; jól jön, ha később keresel egy linket.
  • A --tag ismételhető, így a --tag launch --tag q4 két címkét tesz egy linkre.
  • A --utm-source, --utm-medium, --utm-campaign, --utm-term és --utm-content kampányparamétereket ad a célhoz.

A létrehozott linkeket a linkdash links list --q pricing --tag launch paranccsal listázhatod és keresheted.

Fájl vagy szövegrészlet megosztása

A rövid linkek nem csak URL-ekhez valók. Ugyanaz a parancs fájlt is feltölt, vagy szövegrészletet tárol:

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

A fájllink letöltést kínál a látogatóknak, képeknél és videóknál előnézettel. A szöveges link egy oldalon jeleníti meg a szövegrészletet, másolás gombbal. Mindkettőt ugyanúgy követjük, mint bármely más linket, így láthatod, ki és mikor nyitotta meg a prezentációdat. Így cserélheted le egy meglévő link mögötti fájlt az URL megváltoztatása nélkül:

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

Ki nyithatja meg a linket

Minden linknek saját hozzáférési szabályai lehetnek:

linkdash links create --url https://example.com/decks/q4-2026 \
  --slug q4-deck \
  --password "$DECK_PASSWORD" \
  --expires 14d \
  --max-openings 50
  • A --password jelszót kér a látogatóktól, mielőtt a link megnyílik.
  • A --starts és az --expires időtartamot fogad, például 30m, 24h vagy 7d, vagy ISO-dátumot. A kezdési időpont előtt a link egyáltalán nem oldódik fel.
  • A --max-openings ennyi megnyitás után szünetelteti a linket, ami egyszeri letöltésekhez hasznos.

A linket bármikor szüneteltetheted és folytathatod a linkdash links update q4-deck --status paused és a --status active paranccsal.

A/B teszt futtatása egy rövid linken

A Linkdashben minden link egy vagy több variáns tárolója. A variáns egy cél (URL, fájl vagy szöveg) saját súllyal és szabályokkal. Egy normál linknek egyetlen, main nevű variánsa van. Adj hozzá többet, és a rövid link felosztja köztük a forgalmat:

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

Az egyes --variant után álló kapcsolók a következő --variant-ig ahhoz a variánshoz tartoznak. A forgalmat súly szerint osztjuk fel, amely alapértelmezetten 1, így a fenti példa egy 50/50-es teszt. Adj egy variánsnak --weight 3 értéket, és háromszor annyi forgalmat kap.

A hozzárendelés alapértelmezetten tartós: a visszatérő látogató mindig ugyanazt a variánst kapja, és egy tisztességes teszthez pontosan ez kell. Ha módosítod a kísérletet, a linkdash links update launch --restart-split egyszer mindenkit újrasorsol.

Egy Linkdash link két variánssal, control és annual-first, amely két árazási oldal között osztja fel a forgalmat

A statisztikák variánsonként érkeznek, így közvetlenül összehasonlíthatod őket:

linkdash links stats launch --last 7d

A kimenet variants tömbje minden variánsnál megadja a visits, visitors, downloads és plays értékét. A statisztikákról lentebb olvashatsz többet.

Látogatók irányítása ország, eszköz vagy lekérdezési paraméter szerint

A variánsoknak feltételeik is lehetnek. Adj --when kapcsolót egy variánshoz, és csak az illeszkedő látogatók kaphatják meg. Így egyetlen rövid linkből útválasztó lesz. Például egy link, amely a telefonokat a megfelelő alkalmazásboltba küldi:

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

Amikor egy látogató megnyitja a linket, azok a variánsok alkotják a készletet, amelyek feltételei illeszkednek. Ha egyik sem illeszkedik, a feltétel nélküli variánsok kerülnek sorra, így a fenti web mindenkit elkap, aki nem iOS-t vagy Androidot használ.

Egy Linkdash link, amely iOS-en az App Store-ba, Androidon a Google Playre, mindenki mást pedig egy weboldalra irányít

Ezekre illeszthetsz:

Kulcs Mire illeszkedik Példa
country ISO-országkódok --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 Nyelvi címkék, előtag szerint --when language=de
referrer A hivatkozó host --when referrer=twitter.com

Ismételd a --when kapcsolót, ha egyszerre több feltételt is meg akarsz követelni. A --when country=DE,AT --when device=mobile a németországi vagy ausztriai mobilos látogatókra illeszkedik.

A variánsok a látogató lekérdezési karakterláncára is illeszkedhetnek, így egyetlen link másképp viselkedhet attól függően, hol osztottad meg. A lida.sh/launch?src=newsletter például külön oldalra küldheti a hírlevél olvasóit:

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

A paraméterszabályok támogatják az egyenlő (=), nem egyenlő (!=), tartalmazza (~=), ezzel kezdődik (^=), ezzel végződik ($=), ezek egyike (=a|b), létezik (param:ref?) és hiányzik (param:!ref) műveletet. Ha inkább azt szeretnéd, hogy a látogató paraméterei továbbjussanak a célhoz, hozd létre a linket a --forward-params kapcsolóval.

Az irányítópulton ugyanezek a vezérlők vannak, egy név szerint kereső országválasztóval, így nem kell fejben tartanod, hogy Szlovénia kódja SI:

Célországok kiválasztása egy variánshoz a Linkdash irányítópultján, Németország és Ausztria kijelölve

Kattintásanalitika a terminálból

linkdash links stats launch --last 7d

A kimenet tartalmazza az összes visits, downloads és plays értéket, a kért időablak látogatásainak számát (visitsInLast), a látogatások forrásaként szolgáló countries és referrers listát, a variants szerinti bontást, valamint egy visitors listát az egyes legutóbbi látogatások idejével, országával, eszközével, böngészőjével és hivatkozójával. A --last időtartamot fogad, például 24h vagy 30d, alapértéke 24h.

A Linkdash nem tárolja a látogatók IP-címét. A címet arra használjuk, hogy megállapítsuk a látogató országát, és naponta változó, névtelen látogatóazonosítót képezzünk belőle, utána eldobjuk.

Ha a kattintásokra azonnal reagálni szeretnél, regisztrálj egy webhookot. A Linkdash aláírt link.visit, link.download és link.play eseményeket küld bármely HTTPS-végpontra:

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

Az aláírókulcs csak egyszer jelenik meg, ezért azonnal mentsd el. Az aláírások ellenőrzéséről a webhookok dokumentációjában olvashatsz.

Rövid linkek AI-ügynökkel, MCP-n keresztül

A fentiek mind elérhetők AI-ügynökök számára is. A Linkdash távoli MCP-szervert futtat a https://api.linkdash.dev/mcp címen, és az eszközei a CLI-t tükrözik: links_create, links_update, links_stats, variants_add, domains_add és a többi, ugyanazt a JSON-t adva vissza.

Hozz létre egy API-kulcsot az irányítópulton az API-kulcsok oldalon, majd csatlakoztasd az ügynöködet. A Claude Code-ban:

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

A Cursorban add hozzá a .cursor/mcp.json fájlhoz:

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

A Codexben, amely a megadott környezeti változóból olvassa ki a kulcsot:

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

Ettől kezdve hétköznapi nyelven kérhetsz linkeket, például „rövidítsd le a https://example.com/pricing címet pricing néven, és címkézd launch címkével” vagy „a launch melyik variánsa kapott több látogatót ezen a héten?”, és az ügynök a megfelelő eszközt hívja meg. Az MCP-dokumentáció az OpenCode-ot is lefedi.

Ha az ügynököd már eleve terminálban dolgozik, közvetlenül is használhatja a CLI-t. Telepítsd a Linkdash ügynök-skillt, hogy ismerje a parancsokat és a kapcsolókat:

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

A HTTP API használata

A saját kódodhoz ugyanezek a műveletek egy egyszerű REST API-ként érhetők el a https://api.linkdash.dev/v1 címen, ugyanazzal az API-kulccsal hitelesítve:

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" }'

A válasz szerkezete megegyezik a CLI kimenetével. Az API-referencia minden végpontot lefed, a fájlfeltöltéseket és a variánsokat is.

Saját domain használata

A rövid linkek alapértelmezetten a lida.sh domainen élnek. Ha a saját domainedről szeretnéd kiszolgálni őket, add hozzá, és irányítsd a DNS-t a Linkdashre:

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

Ezután a --domain go.example.com kapcsolóval hozhatsz létre rajta linkeket. Minden saját domainnek saját slugkészlete van, így a go.example.com/launch nem ütközik senki más launch slugjával. A domainútmutató a DNS beállítását is bemutatja, az egykattintásos beállítással együtt azoknál a szolgáltatóknál, amelyek támogatják.

Árak

A Free csomaghoz nem kell bankkártya, és havi 5000 eseményt, 1 GB fájltárhelyet, egy hónapnyi analitikai előzményt és egy saját domaint tartalmaz. Esemény egy látogatás, letöltés vagy lejátszás valamelyik linkeden, vagy egy írás, például egy link létrehozása vagy módosítása. Az olvasások, például a linkek listázása vagy a statisztikák lekérése ingyenesek.

A fizetős csomagok megemelik ezeket a korlátokat: a Professional havi 18 dollár, a Growth havi 48 dollár. A teljes összehasonlítást az árak oldalon találod.

GYIK

Van ingyenes linkrövidítő CLI-jal?

Igen. A Linkdash CLI a Free csomagban is működik, amely havi 5000 eseményt tartalmaz, bankkártya nélkül.

Használhatom a Linkdash CLI-t CI-ban?

Igen. Állítsd a LINKDASH_TOKEN változót egy munkamenet-tokenre, és a CLI böngésző nélkül fut. Mivel minden parancs JSON-t ír ki, a GitHub Actionsből vagy bármely más pipeline-ból létrehozhatsz és frissíthetsz linkeket, az eredményeket pedig a jq segítségével olvashatod.

Létrehozhatnak AI-ügynökök rövid linkeket?

Igen, háromféleképpen: a https://api.linkdash.dev/mcp címen futó MCP-szerveren keresztül, a CLI-on keresztül a telepített Linkdash ügynök-skillel, vagy a HTTP API-n keresztül. Mindhárom ugyanazokat a műveleteket kínálja, és ugyanazt a JSON-t adja vissza.

Tárolja a Linkdash a látogatók IP-címét?

Nem. A Linkdash a címet arra használja, hogy megállapítsa a látogató országát, és napi névtelen azonosítót képezzen belőle, utána eldobja. A linkek tulajdonosai soha nem látnak IP-címeket.

Igen. Adj egy linknek több variánst, és mindegyikhez adj feltételeket, például országot, eszközt, operációs rendszert, nyelvet, hivatkozót vagy lekérdezési paramétert. Feltételek nélkül a variánsok súly szerint osztják fel a forgalmat, és így futtathatsz A/B tesztet.


Kipróbálnád? Telepítsd a CLI-t, futtasd a linkdash auth create parancsot, és egy percen belül lerövidítheted az első linkedet. A gyors kezdés minden lépést tartalmaz.