DEV Community

Cover image for Agent-ready short links from the command line
Ntty
Ntty

Posted on

Agent-ready short links from the command line

Most short-link tools are designed around a dashboard. I did it for agents.

That works when a marketer is setting up campaigns manually. It is awkward when the workflow starts in a terminal, CI job, documentation script, launch checklist, or coding agent.

Lnkgo is a small API/CLI-first link service for branded tracked links.

  • npm CLI: npm install -g lnkgo
  • agent skill: npx --yes skills add citedy/lnkgo --skill lnkgo

You can create a short link, generate a QR code, read analytics, and verify a custom domain without opening a dashboard.

Example agent use cases

Create a campaign link:

Create a Lnkgo link for this launch URL and tag it producthunt.

Track a partner page:

Create a partner link, then summarize clicks by referrer tomorrow.

Generate a QR:

Create a tracked link and save a QR code as event-qr.png.

Use a custom domain:

Check my domain status, then create the link on links.example.com.

Summarize analytics:

Fetch analytics for this link id and give me totals, countries, and top referrers.

CLI example

lnkgo create \
  --url https://example.com/launch \
  --tag devto \
  --tag launch
Enter fullscreen mode Exit fullscreen mode

Then use the returned id for QR and analytics:

lnkgo qr "$LINK_ID" --output event-qr.png
lnkgo analytics "$LINK_ID"
Enter fullscreen mode Exit fullscreen mode

REST API example

curl -sS -X POST "https://api.lnkgo.app/v1/links" \
  -H "Authorization: Bearer $LNKGO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen | tr '[:upper:]' '[:lower:]')" \
  -d '{"url":"https://example.com/launch","tags":["producthunt","launch"]}'
Enter fullscreen mode Exit fullscreen mode

Custom domains

Default links use lnkgo.app.

If you want your own domain, request it, add the returned DNS proof records, and create links on that domain after it becomes active.

Launch limits

Email verification starts with safe starter limits. Domain ownership proof unlocks the launch offer: up to 10 custom domains, 10,000 links/month, 1,000 links/domain/month, 50,000 API calls/month, and 14-day analytics.

Try it here:
https://lnkgo.app

Top comments (0)