Siirry sisältöön
Kaikki kirjoitukset

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

Pääte luo Linkdash-lyhytlinkin komennolla linkdash links create

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.

Linkdashin hallintapaneeli, jossa lyhytlinkit näkyvät tyypin, slugin, kohteen ja tilan kanssa

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:

  • --slug asettaa 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.
  • --name on yksityinen nimi, jonka vain sinä näet, kätevä linkkien löytämiseen myöhemmin.
  • --tag on toistettava, joten --tag launch --tag q4 antaa linkille kaksi tagia.
  • --utm-source, --utm-medium, --utm-campaign, --utm-term ja --utm-content lisää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
  • --password kysyy kävijöiltä salasanaa ennen kuin linkki avautuu.
  • --starts ja --expires hyväksyvät keston, kuten 30m, 24h tai 7d, tai ISO-päivämäärän. Ennen alkamisaikaansa linkki ei ratkea lainkaan.
  • --max-openings keskeyttää 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.

Linkdash-linkki kahdella variantilla, control ja annual-first, jakaa liikenteen kahden hinnoittelusivun kesken

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.

Linkdash-linkki ohjaa kävijät iOS:llä App Storeen, Androidilla Google Playhin ja kaikki muut verkkosivulle

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:

Varianttien kohdemaiden valinta Linkdashin hallintapaneelissa, Saksa ja Itävalta valittuina

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.