# URL Shortener

> Skill `link` on Faro. Free. 2 sub-skills.

Shorten any URL to a compact shareable link, with an optional expiry. Once shared, check how many times the link has been clicked. Useful for sharing long URLs cleanly in messages, emails, or documents.

**Category:** Sharing  
**Tags:** url, shortener, redirect, link, tracking  
**Use when:** You need a short link to share, or the click count for one you made.  
**Not for:** Hosting a file or page (use the file share or pastebin).  
**Returns:** information

## How to run
Skills run through one gateway with your Faro token. Hand it an `intent` in plain language; Faro routes to the right sub-skill, runs it, and bills per call. Raw tools are internal plumbing and are not directly callable.

```
POST https://skill.askfaro.com/skills/link/run
Authorization: Bearer faro_<your_key>
Content-Type: application/json

{"intent":{"prompt":"Shorten this URL for me."}}
```

Or from the CLI:

```bash
pip install askfaro-cli && askfaro auth login
askfaro run link "Shorten this URL for me."
```

Full run reference: https://askfaro.com/llms/run.md — Agent recipe: https://askfaro.com/llms/skill.md

## Example requests

- Shorten this URL for me.
- How many times has my short link been clicked?

## Sub-skills

### Shorten a URL

Shortens a URL and returns the short link.

**Cost:** Free

**Details:** https://askfaro.com/llms/skills/link/shorten.md

---

### Get link stats

Reports the click stats for a short code.

**Cost:** Free

**Details:** https://askfaro.com/llms/skills/link/stats.md

---

---
On the web: https://askfaro.com/search/link