Pāriet uz saturu
Visi raksti

climcpapi

URL saīsinātāja CLI izstrādātājiem un AI aģentiem

Saīsiniet URL no komandrindas ar Linkdash CLI. Kopīgojiet failus, veiciet A/B testus, mērķējiet apmeklētājus un ļaujiet AI aģentiem pārvaldīt saites ar MCP.

Igor KirnosovLasīšanas laiks: 8 min

Terminālis, kurā ar komandu linkdash links create tiek izveidota Linkdash īsā saite

Linkdash ir URL saīsinātājs, ko pārvaldāt no termināļa. Viena komanda pārvērš URL, failu vai teksta fragmentu izsekotā īsajā saitē domēnā lida.sh un izvada rezultātu kā JSON, ko varat nodot jebkam tālāk. Tās pašas darbības ir pieejamas arī HTTP API un kā MCP serveris, tāpēc AI aģents var izveidot, atjaunināt un mērīt saites ar tieši tiem pašiem rīkiem, ko izmantojat jūs.

Šajā ceļvedī aplūkots viss CLI: instalēšana, pirmās saites saīsināšana, failu kopīgošana, saišu aizsargāšana, A/B testi, apmeklētāju novirzīšana pēc valsts vai ierīces un analītikas lasīšana, neatverot pārlūku.

Linkdash vadības panelis ar īso saišu sarakstu, kurā redzams to veids, slug, mērķis un statuss

Linkdash CLI instalēšana

CLI ir npm pakotne, un tai nepieciešams Node.js 20 vai jaunāks.

npm i -g linkdash-cli

Tāpat tas darbojas ar pnpm add -g linkdash-cli vai bun add -g linkdash-cli. Instalētā komanda ir linkdash.

Pēc tam vienā solī izveidojiet kontu un pierakstiet CLI:

linkdash auth create

Tas pārlūkā atver reģistrācijas lapu. Kad konts ir izveidots, apstipriniet terminālī redzamo kodu, un CLI ir pierakstījies. Ja jums jau ir konts, tā vietā izmantojiet linkdash auth login. linkdash auth whoami parāda, kuru kontu izmantojat, un CLI rokasgrāmatā ir uzskaitītas visas komandas un karodziņi.

Sesija tiek glabāta failā ~/.config/linkdash/config.json ar atļaujām tikai īpašniekam. CI vai citām vidēm bez saskarnes iestatiet LINKDASH_TOKEN uz sesijas marķieri no šī faila datorā, kurā esat pierakstījušies, un glabājiet to kā jebkuru citu noslēpumu.

Kā saīsināt URL no komandrindas

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

Tā ir visa saskarne: veiksmīgas komandas izvada JSON uz stdout, bet kļūdas izvada vienkāršu tekstu uz stderr ar izejas kodu 1. Karodziņa --json nav, jo JSON ir vienīgais izvades formāts. Tāpēc CLI ir viegli izmantot skriptos. Lai macOS nokopētu jaunu īso saiti tieši starpliktuvē:

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

Daži karodziņi, ko izmantosiet nemitīgi:

  • --slug iestata publisko ceļu. Slug var saturēt mazos burtus, ciparus un defises vidū, līdz 64 rakstzīmēm. Ja to neizmantojat, Linkdash to ģenerē.
  • --name ir privāta etiķete, ko redzat tikai jūs, — ērti, lai vēlāk atrastu saites.
  • --tag var atkārtot, tāpēc --tag launch --tag q4 piešķir saitei divus tagus.
  • --utm-source, --utm-medium, --utm-campaign, --utm-term un --utm-content pievieno mērķim kampaņas parametrus.

Izveidotās saites varat skatīt un meklēt ar linkdash links list --q pricing --tag launch.

Kopīgojiet failu vai teksta fragmentu

Īsās saites nav tikai URL. Tā pati komanda augšupielādē failu vai saglabā fragmentu:

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

Faila saite piedāvā apmeklētājiem lejupielādi ar priekšskatījumu attēliem un video. Teksta saite parāda fragmentu lapā ar kopēšanas pogu. Abas tiek izsekotas kā jebkura cita saite, tāpēc varat redzēt, kas un kad atvēra jūsu prezentāciju. Lai aizstātu failu esošā saitē, nemainot URL:

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

Nosakiet, kas var atvērt saiti

Katrai saitei var būt savi piekļuves noteikumi:

linkdash links create --url https://example.com/decks/q4-2026 \
  --slug q4-deck \
  --password "$DECK_PASSWORD" \
  --expires 14d \
  --max-openings 50
  • --password pirms saites atvēršanas pieprasa apmeklētājiem paroli.
  • --starts un --expires pieņem ilgumu, piemēram, 30m, 24h vai 7d, vai ISO datumu. Pirms sākuma laika saite vispār neatveras.
  • --max-openings aptur saiti pēc norādītā atvēršanu skaita, kas noder vienreizējām lejupielādēm.

Saiti jebkurā laikā varat apturēt un atsākt ar linkdash links update q4-deck --status paused un --status active.

A/B tests ar īso saiti

Linkdash katra saite ir viena vai vairāku variantu konteiners. Variants ir mērķis (URL, fails vai teksts) ar savu svaru un noteikumiem. Parastai saitei ir viens variants ar nosaukumu main. Pievienojiet vēl, un īsā saite sadalīs datplūsmu starp tiem:

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

Karodziņi pēc katra --variant pieder šim variantam līdz nākamajam. Datplūsma tiek sadalīta pēc svara, kas pēc noklusējuma ir 1, tāpēc piemērs augstāk ir 50/50 tests. Piešķiriet variantam --weight 3, lai tas saņemtu trīs reizes vairāk datplūsmas.

Piešķire pēc noklusējuma ir noturīga: atkārtots apmeklētājs turpina saņemt to pašu variantu, un tieši tas vajadzīgs godīgam testam. Kad maināt eksperimentu, linkdash links update launch --restart-split vienreiz pārdala visus no jauna.

Linkdash saite ar diviem variantiem, control un annual-first, kas sadala datplūsmu starp divām cenu lapām

Statistika tiek atgriezta katram variantam, tāpēc varat tos salīdzināt tieši:

linkdash links stats launch --last 7d

Izvades masīvā variants katram variantam ir visits, visitors, downloads un plays. Vairāk par statistiku tālāk.

Novirziet apmeklētājus pēc valsts, ierīces vai vaicājuma parametra

Variantiem var būt arī nosacījumi. Pievienojiet variantam --when, un to varēs saņemt tikai atbilstoši apmeklētāji. Tā viena īsā saite kļūst par maršrutētāju. Piemēram, viena saite, kas sūta tālruņus uz pareizo lietotņu veikalu:

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

Kad apmeklētājs atver saiti, varianti, kuru nosacījumi atbilst, veido kopu. Ja neatbilst neviens, tā vietā tiek izmantoti varianti bez nosacījumiem, tāpēc web augstāk uztver visus, kas neizmanto iOS vai Android.

Linkdash saite, kas novirza apmeklētājus uz App Store iOS ierīcēs, uz Google Play Android ierīcēs un uz tīmekļa lapu visus pārējos

Varat pārbaudīt:

Atslēga Atbilst Piemērs
country ISO valstu kodi --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 Valodu tagi pēc prefiksa --when language=de
referrer Novirzītāja resursdators --when referrer=twitter.com

Atkārtojiet --when, lai pieprasītu vairākus nosacījumus vienlaikus. --when country=DE,AT --when device=mobile atbilst mobilajiem apmeklētājiem no Vācijas vai Austrijas.

Varianti var pārbaudīt arī apmeklētāja vaicājuma virkni, tāpēc viena saite var darboties atšķirīgi atkarībā no tā, kur to kopīgojāt. lida.sh/launch?src=newsletter var nosūtīt jaunumu vēstules lasītājus uz īpašu lapu:

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

Parametru noteikumi atbalsta vienādību (=), nevienādību (!=), saturēšanu (~=), sākšanos ar (^=), beigšanos ar ($=), vienu no (=a|b), esamību (param:ref?) un iztrūkumu (param:!ref). Ja vēlaties, lai apmeklētāja parametri tiktu nodoti mērķim, izveidojiet saiti ar --forward-params.

Vadības panelī ir tās pašas iespējas, ar valstu izvēli, kas meklē pēc nosaukuma, tāpēc jums nav jāatceras, ka Slovēnija ir SI:

Mērķa valstu izvēle variantam Linkdash vadības panelī, atlasītas Vācija un Austrija

Klikšķu analītikas lasīšana terminālī

linkdash links stats launch --last 7d

Izvadē ir kopējie visits, downloads un plays, apmeklējumu skaits pieprasītajā periodā (visitsInLast), countries un referrers, no kurienes šie apmeklējumi nāca, sadalījums variants un saraksts visitors ar katra nesenā apmeklējuma laiku, valsti, ierīci, pārlūku un novirzītāju. --last pieņem ilgumu, piemēram, 24h vai 30d, un pēc noklusējuma ir 24h.

Linkdash neglabā apmeklētāju IP adreses. Adrese tiek izmantota, lai noteiktu apmeklētāja valsti un iegūtu anonīmu apmeklētāja identifikatoru, kas mainās katru dienu, un pēc tam tiek dzēsta.

Lai reaģētu uz klikšķiem reāllaikā, reģistrējiet webhook. Linkdash nosūta parakstītus notikumus link.visit, link.download un link.play uz jebkuru HTTPS galapunktu:

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

Parakstīšanas noslēpums tiek izvadīts vienreiz, tāpēc saglabājiet to nekavējoties. Kā verificēt parakstus, skatiet webhook dokumentācijā.

Ļaujiet AI aģentiem izveidot īsās saites ar MCP

Viss iepriekš minētais ir pieejams arī AI aģentiem. Linkdash darbina attālu MCP serveri adresē https://api.linkdash.dev/mcp, un tā rīki atspoguļo CLI: links_create, links_update, links_stats, variants_add, domains_add un pārējie, kas atgriež to pašu JSON.

Izveidojiet API atslēgu vadības paneļa sadaļā API atslēgas un pēc tam savienojiet savu aģentu. Claude Code:

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

Cursor pievienojiet to failā .cursor/mcp.json:

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

Codex, kas nolasa atslēgu no norādītā vides mainīgā:

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

Turpmāk saites varat pieprasīt vienkāršā valodā, piemēram, „saīsini https://example.com/pricing kā pricing un pievieno tagu launch“ vai „kurš launch variants šonedēļ saņēma vairāk apmeklētāju?“, un aģents izsauks pareizo rīku. MCP dokumentācijā aprakstīts arī OpenCode.

Ja jūsu aģents jau strādā terminālī, tas var izmantot CLI tieši. Instalējiet Linkdash aģenta skill, lai tas zinātu komandas un karodziņus:

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

HTTP API izmantošana

Jūsu pašu kodam tās pašas darbības ir pieejamas kā vienkāršs REST API adresē https://api.linkdash.dev/v1, autentificējoties ar to pašu API atslēgu:

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

Atbildei ir tāda pati struktūra kā CLI izvadei. API rokasgrāmatā aprakstīts katrs galapunkts, ieskaitot failu augšupielādi un variantus.

Sava domēna izmantošana

Pēc noklusējuma īsās saites atrodas domēnā lida.sh. Lai tās apkalpotu no sava domēna, pievienojiet to un novirziet savu DNS uz Linkdash:

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

Pēc tam izveidojiet tajā saites ar --domain go.example.com. Katram pielāgotajam domēnam ir savs slug kopums, tāpēc go.example.com/launch nekonfliktē ar kāda cita launch. Domēnu ceļvedī aprakstīta DNS iestatīšana, ieskaitot iestatīšanu ar vienu klikšķi pakalpojumu sniedzējiem, kas to atbalsta.

Cenas

Free plānam nav nepieciešama kredītkarte, un tajā ir iekļauti 5000 notikumu mēnesī, 1 GB failu krātuves, viena mēneša analītikas vēsture un viens pielāgots domēns. Notikums ir apmeklējums, lejupielāde vai atskaņojums kādā no jūsu saitēm vai rakstīšanas darbība, piemēram, saites izveide vai atjaunināšana. Lasīšanas darbības, piemēram, saišu saraksts vai statistikas iegūšana, ir bez maksas.

Maksas plāni paaugstina šos limitus: Professional maksā 18 $ mēnesī, bet Growth — 48 $ mēnesī. Pilnu salīdzinājumu skatiet cenās.

BUJ

Vai ir bezmaksas URL saīsinātājs ar CLI?

Jā. Linkdash CLI darbojas Free plānā, kurā ir iekļauti 5000 notikumu mēnesī bez kredītkartes.

Vai Linkdash CLI var izmantot CI?

Jā. Iestatiet LINKDASH_TOKEN uz sesijas marķieri, un CLI darbosies bez pārlūka. Tā kā katra komanda izvada JSON, varat izveidot un atjaunināt saites no GitHub Actions vai jebkura cita konveijera un nolasīt rezultātus ar jq.

Vai AI aģenti var izveidot īsās saites?

Jā, trīs veidos: caur MCP serveri adresē https://api.linkdash.dev/mcp, caur CLI ar instalētu Linkdash aģenta skill vai caur HTTP API. Visi trīs nodrošina tās pašas darbības un atgriež to pašu JSON.

Vai Linkdash glabā apmeklētāju IP adreses?

Nē. Linkdash izmanto adresi, lai noteiktu apmeklētāja valsti un izveidotu ikdienas anonīmu identifikatoru, un pēc tam to dzēš. Saišu īpašnieki nekad neredz IP adreses.

Vai viena īsā saite var nosūtīt dažādus apmeklētājus uz dažādām lapām?

Jā. Piešķiriet saitei vairākus variantus un katram pievienojiet nosacījumus, piemēram, valsti, ierīci, operētājsistēmu, valodu, novirzītāju vai vaicājuma parametru. Bez nosacījumiem varianti sadala datplūsmu pēc svara — tā tiek veikts A/B tests.


Gatavi izmēģināt? Instalējiet CLI, palaidiet linkdash auth create un saīsiniet savu pirmo saiti mazāk nekā minūtē. Ātrajā sākumā ir aprakstīts katrs solis.

Linkdash

© 2026 Igor Kirnosov s.p. Visas tiesības aizsargātas.