climcpapi
Linkinlyhentäjä komentoriville kehittäjille ja tekoälyagenteille
Lyhennä URL-osoitteita komentoriviltä Linkdash CLI:llä. Jaa tiedostoja, aja A/B-testejä, kohdenna kävijöitä ja anna tekoälyagenttien hallita linkkejä MCP:llä.
Igor Kirnosov7 min lukuaika

Linkdash on linkinlyhentäjä, jota ohjaat päätteestä. Yksi komento muuttaa URL-osoitteen, tiedoston tai tekstikatkelman seuratuksi lyhytlinkiksi lida.sh-osoitteeseen ja tulostaa tuloksen JSONina, jonka voit putkittaa mihin tahansa. Samat toiminnot ovat saatavilla HTTP API:n kautta ja MCP-palvelimena, joten tekoälyagentti voi luoda, päivittää ja mitata linkkejä täsmälleen samoilla työkaluilla kuin sinä.
Tämä opas käy läpi koko CLI:n: asennuksen, ensimmäisen linkin lyhentämisen, tiedostojen jakamisen, linkkien lukitsemisen, A/B-testien ajamisen, kävijöiden reitittämisen maan tai laitteen mukaan ja analytiikan lukemisen avaamatta selainta.

Asenna Linkdash CLI
CLI on npm-paketti, ja se vaatii Node.js:n version 20 tai uudemman.
npm i -g linkdash-cli
Se toimii samoin komennoilla pnpm add -g linkdash-cli tai bun add -g linkdash-cli. Asennettava komento on linkdash.
Luo sitten tili ja kirjaa CLI sisään yhdellä kertaa:
linkdash auth create
Tämä avaa rekisteröitymissivun selaimessasi. Kun tili on luotu, hyväksyt päätteessäsi näkyvän koodin, ja CLI on kirjautunut sisään. Jos sinulla on jo tili, käytä sen sijaan komentoa linkdash auth login. linkdash auth whoami vahvistaa, mitä tiliä käytät, ja CLI-viiteopas listaa jokaisen komennon ja lipun.
Istunto tallennetaan tiedostoon ~/.config/linkdash/config.json vain omistajan oikeuksilla. CI:tä tai muita käyttöliittymättömiä ympäristöjä varten aseta LINKDASH_TOKEN istuntotokeniksi kyseisestä tiedostosta koneelta, jolla olet kirjautunut, ja käsittele sitä kuten mitä tahansa muuta salaisuutta.
Lyhennä URL komentoriviltä
linkdash links create --url https://example.com/pricing --slug pricing
{
"id": "pricing",
"url": "https://lida.sh/pricing",
"kind": "url",
"variants": [
{ "name": "main", "kind": "url" }
]
}
Siinä on koko käyttöliittymä: onnistuneet komennot tulostavat JSONia stdoutiin, ja virheet tulostavat pelkkää tekstiä stderriin poistumiskoodilla 1. --json-lippua ei ole, koska JSON on ainoa tulostemuoto. Siksi CLI:tä on helppo skriptata. Näin kopioit uuden lyhytlinkin suoraan leikepöydälle macOS:ssä:
linkdash links create --url https://example.com/pricing | jq -r .url | pbcopy
Muutama lippu, joita käytät jatkuvasti:
--slugasettaa julkisen polun. Slugeissa käytetään pieniä kirjaimia, numeroita ja sisäisiä yhdysmerkkejä, enintään 64 merkkiä. Jätä se pois, niin Linkdash luo sellaisen.--nameon yksityinen nimi, jonka vain sinä näet, kätevä linkkien löytämiseen myöhemmin.--tagon toistettava, joten--tag launch --tag q4antaa linkille kaksi tagia.--utm-source,--utm-medium,--utm-campaign,--utm-termja--utm-contentlisäävät kohteeseen kampanjaparametreja.
Listaa ja hae luomiasi linkkejä komennolla linkdash links list --q pricing --tag launch.
Jaa tiedosto tai tekstikatkelma
Lyhytlinkit eivät ole vain URL-osoitteille. Sama komento lataa tiedoston tai tallentaa katkelman:
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
Tiedostolinkki antaa kävijöille latauksen, ja kuville ja videoille esikatselun. Tekstilinkki näyttää katkelman sivulla kopiointipainikkeen kanssa. Molempia seurataan kuten mitä tahansa muuta linkkiä, joten näet, kuka avasi esityksesi ja milloin. Näin korvaat olemassa olevan linkin takana olevan tiedoston muuttamatta URL-osoitetta:
linkdash links update board-deck --file ./board-deck-v2.pdf
Päätä, kuka voi avata linkin
Jokaisella linkillä voi olla omat käyttösääntönsä:
linkdash links create --url https://example.com/decks/q4-2026 \
--slug q4-deck \
--password "$DECK_PASSWORD" \
--expires 14d \
--max-openings 50
--passwordkysyy kävijöiltä salasanaa ennen kuin linkki avautuu.--startsja--expireshyväksyvät keston, kuten30m,24htai7d, tai ISO-päivämäärän. Ennen alkamisaikaansa linkki ei ratkea lainkaan.--max-openingskeskeyttää linkin näin monen avauskerran jälkeen, mikä on hyödyllistä kertalatauksissa.
Voit keskeyttää ja jatkaa linkkiä milloin tahansa komennoilla linkdash links update q4-deck --status paused ja --status active.
Aja A/B-testi lyhytlinkillä
Linkdashissa jokainen linkki on yhden tai useamman variantin säiliö. Variantti on kohde (URL, tiedosto tai teksti), jolla on oma paino ja säännöt. Tavallisella linkillä on yksi variantti nimeltä main. Lisää variantteja, niin lyhytlinkki jakaa liikenteensä niiden kesken:
linkdash links create --slug launch \
--variant control --url https://example.com/pricing \
--variant annual-first --url "https://example.com/pricing?view=annual"
Kunkin --variant-lipun jälkeiset liput kuuluvat kyseiselle variantille seuraavaan asti. Liikenne jaetaan painon mukaan, jonka oletus on 1, joten yllä oleva esimerkki on 50/50-testi. Anna variantille --weight 3, niin se saa kolminkertaisen määrän liikennettä.
Kohdistus on oletuksena pysyvä: palaava kävijä saa jatkossakin saman variantin, mikä on reilun testin edellytys. Kun muutat koetta, linkdash links update launch --restart-split sekoittaa kaikki kerran uudelleen.

Tilastot palautetaan varianteittain, joten voit verrata niitä suoraan:
linkdash links stats launch --last 7d
Tulosteen variants-taulukko raportoi kullekin variantille arvot visits, visitors, downloads ja plays. Lisää tilastoista alempana.
Reititä kävijät maan, laitteen tai kyselyparametrin mukaan
Varianteilla voi olla myös ehtoja. Lisää variantille --when, niin vain ehdot täyttävät kävijät voivat saada sen. Näin yhdestä lyhytlinkistä tulee reititin. Esimerkiksi yksi linkki, joka ohjaa puhelimet oikeaan sovelluskauppaan:
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
Kun kävijä avaa linkin, ne variantit, joiden ehdot täyttyvät, muodostavat joukon. Jos mikään ei täsmää, käytetään sen sijaan ehdottomia variantteja, joten yllä oleva web nappaa kaikki, jotka eivät käytä iOS:ää tai Androidia.

Voit verrata seuraavia:
| Avain | Vastaa | Esimerkki |
|---|---|---|
country |
ISO-maakoodit | --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 |
Kielitagit, etuliitteen mukaan | --when language=de |
referrer |
Viittaava palvelin | --when referrer=twitter.com |
Toista --when vaatiaksesi useita ehtoja kerralla. --when country=DE,AT --when device=mobile vastaa mobiilikävijöitä Saksasta tai Itävallasta.
Variantit voivat verrata myös kävijän kyselymerkkijonoa, joten yksi linkki voi toimia eri tavoin sen mukaan, missä jaoit sen. lida.sh/launch?src=newsletter voi ohjata uutiskirjeen lukijat erityiseen paikkaan:
linkdash links variants add launch --name newsletter \
--url https://example.com/pricing/newsletter \
--when param:src=newsletter
Parametrisäännöt tukevat operaattoreita yhtä kuin (=), eri kuin (!=), sisältää (~=), alkaa (^=), päättyy ($=), jokin näistä (=a|b), olemassa (param:ref?) ja puuttuu (param:!ref). Jos haluat sen sijaan välittää kävijän parametrit kohteeseen, luo linkki lipulla --forward-params.
Hallintapaneelissa on samat säätimet, ja maavalitsin hakee nimen perusteella, joten sinun ei tarvitse muistaa, että Slovenia on SI:

Lue klikkausanalytiikka päätteestä
linkdash links stats launch --last 7d
Tuloste sisältää kokonaismäärät visits, downloads ja plays, pyytämäsi aikaikkunan käyntien määrän (visitsInLast), maat (countries) ja viittaajat (referrers), joista käynnit tulivat, varianttikohtaisen erittelyn variants sekä visitors-listan, jossa näkyvät kunkin viimeaikaisen käynnin aika, maa, laite, selain ja viittaaja. --last hyväksyy keston, kuten 24h tai 30d, ja sen oletus on 24h.
Linkdash ei tallenna kävijöiden IP-osoitteita. Osoitteella haetaan kävijän maa ja johdetaan päivittäin vaihtuva anonyymi kävijätunniste, minkä jälkeen osoite hylätään.
Jos haluat reagoida klikkauksiin heti, rekisteröi webhook. Linkdash lähettää allekirjoitettuja link.visit-, link.download- ja link.play-tapahtumia mihin tahansa HTTPS-päätepisteeseen:
linkdash webhooks create --url https://example.com/hooks
Allekirjoitussalaisuus tulostetaan vain kerran, joten tallenna se heti. Allekirjoitusten varmentamisesta kerrotaan webhook-dokumentaatiossa.
Anna tekoälyagenttien luoda lyhytlinkkejä MCP:llä
Kaikki yllä oleva on myös tekoälyagenttien käytettävissä. Linkdash ajaa etä-MCP-palvelinta osoitteessa https://api.linkdash.dev/mcp, ja sen työkalut vastaavat CLI:tä: links_create, links_update, links_stats, variants_add, domains_add ja muut, ja ne palauttavat saman JSONin.
Luo API-avain hallintapaneelin kohdassa API-avaimet ja yhdistä sitten agenttisi. Claude Codessa:
claude mcp add --transport http linkdash https://api.linkdash.dev/mcp \
--header "Authorization: Bearer $LINKDASH_API_KEY"
Cursorissa lisää se tiedostoon .cursor/mcp.json:
{
"mcpServers": {
"linkdash": {
"url": "https://api.linkdash.dev/mcp",
"headers": { "Authorization": "Bearer ${env:LINKDASH_API_KEY}" }
}
}
}
Codexissa, joka lukee avaimen nimeämästäsi ympäristömuuttujasta:
codex mcp add linkdash --url https://api.linkdash.dev/mcp \
--bearer-token-env-var LINKDASH_API_KEY
Siitä lähtien voit pyytää linkkejä tavallisella kielellä, esimerkiksi ”lyhennä https://example.com/pricing nimellä pricing ja tagaa se launch” tai ”kumpi launch-linkin variantti sai enemmän kävijöitä tällä viikolla?”, ja agentti kutsuu oikeaa työkalua. MCP-dokumentaatio kattaa myös OpenCoden.
Jos agenttisi toimii jo päätteessä, se voi käyttää CLI:tä suoraan. Asenna Linkdashin agenttiskill, niin se tuntee komennot ja liput:
npx skills add https://linkdash.dev/skills/linkdash/SKILL.md
Käytä HTTP API:a
Omassa koodissasi samat toiminnot ovat tavallinen REST API osoitteessa https://api.linkdash.dev/v1, ja todennus tapahtuu samalla API-avaimella:
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" }'
Vastauksella on sama rakenne kuin CLI:n tulosteella. API-viiteopas kattaa jokaisen päätepisteen, myös tiedostojen lataukset ja variantit.
Käytä omaa verkkotunnustasi
Lyhytlinkit ovat oletuksena osoitteessa lida.sh. Jos haluat tarjoilla ne omasta verkkotunnuksestasi, lisää se ja osoita DNS Linkdashiin:
linkdash domains add go.example.com
linkdash domains verify go.example.com
Luo sitten linkkejä siihen lipulla --domain go.example.com. Jokaisella omalla verkkotunnuksella on oma slug-joukkonsa, joten go.example.com/launch ei törmää kenenkään muun launch-slugiin. Verkkotunnusopas kattaa DNS-määritykset, myös yhden klikkauksen käyttöönoton sitä tukeville palveluntarjoajille.
Hinnoittelu
Free-paketti ei vaadi luottokorttia, ja siihen sisältyy 5 000 tapahtumaa kuukaudessa, 1 Gt tiedostotallennustilaa, kuukauden analytiikkahistoria ja yksi oma verkkotunnus. Tapahtuma on käynti, lataus tai toisto jossakin linkeistäsi tai kirjoitus, kuten linkin luominen tai päivittäminen. Lukutoiminnot, kuten linkkien listaaminen tai tilastojen hakeminen, ovat maksuttomia.
Maksulliset paketit nostavat näitä rajoja: Professional maksaa 18 $ kuukaudessa ja Growth 48 $ kuukaudessa. Täydellinen vertailu on hinnoittelusivulla.
UKK
Onko olemassa ilmaista linkinlyhentäjää, jossa on CLI?
Kyllä. Linkdash CLI toimii Free-paketissa, johon sisältyy 5 000 tapahtumaa kuukaudessa ilman luottokorttia.
Voinko käyttää Linkdash CLI:tä CI:ssä?
Kyllä. Aseta LINKDASH_TOKEN istuntotokeniksi, niin CLI toimii ilman selainta. Koska jokainen komento tulostaa JSONia, voit luoda ja päivittää linkkejä GitHub Actionsista tai mistä tahansa muusta putkesta ja lukea tulokset jq:lla.
Voivatko tekoälyagentit luoda lyhytlinkkejä?
Kyllä, kolmella tavalla: MCP-palvelimen kautta osoitteessa https://api.linkdash.dev/mcp, CLI:n kautta, kun Linkdashin agenttiskill on asennettu, tai HTTP API:n kautta. Kaikki kolme tarjoavat samat toiminnot ja palauttavat saman JSONin.
Tallentaako Linkdash kävijöiden IP-osoitteita?
Ei. Linkdash käyttää osoitetta kävijän maan selvittämiseen ja päivittäisen anonyymin tunnisteen luomiseen ja hylkää sen sitten. Linkkien omistajat eivät koskaan näe IP-osoitteita.
Voiko yksi lyhytlinkki ohjata eri kävijät eri sivuille?
Kyllä. Anna linkille useita variantteja ja lisää kullekin ehtoja, kuten maa, laite, käyttöjärjestelmä, kieli, viittaaja tai kyselyparametri. Ilman ehtoja variantit jakavat liikenteen painon mukaan, ja juuri niin A/B-testi ajetaan.
Valmis kokeilemaan? Asenna CLI, suorita linkdash auth create ja lyhennä ensimmäinen linkkisi alle minuutissa. Pikaoppaassa on jokainen vaihe.

