# shapescale-yourls

> Shorten URLs via YOURLS (bysha.pe). Create custom short links, get analytics, and manage redirects. Use when generating checkout links, sharing resources, or tracking clicks.

- Author: Niemand Assistant
- Repository: kesslerio/dialpad-clawdbot-skill
- Version: 20260127133854
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/kesslerio/dialpad-clawdbot-skill
- Web: https://mule.run/skillshub/@@kesslerio/dialpad-clawdbot-skill~shapescale-yourls:20260127133854

---

---
name: shapescale-yourls
description: Shorten URLs via YOURLS (bysha.pe). Create custom short links, get analytics, and manage redirects. Use when generating checkout links, sharing resources, or tracking clicks.
---

# ShapeScale YOURLS (Short URL) Skill

## Configuration Required

**⚠️ You must configure the API credentials before this skill will work.**

Add the following to your `~/.clawdbot/clawdbot.json` under `skills.entries`:

```json
"shapescale-tools": {
  "env": {
    "YOURLS_API_URL": "https://bysha.pe/yourls-api.php",
    "YOURLS_AUTH_METHOD": "signature",
    "YOURLS_SIGNATURE_TOKEN": "YOUR_SIGNATURE_TOKEN"
  }
}
```

## Tools

### `shorten_url`
Shorten a long URL. Optional: `keyword` (custom slug) and `title`.

### `shorten_with_analytics`
Shorten with UTM parameters automatically appended.
- `url`: Base URL
- `source`, `medium`, `campaign`: UTM params
- `keyword`: Custom slug (optional)

### `expand_url`
Get the destination of a short URL.

### `url_stats` / `url_analytics`
Get click statistics.

### `create_custom_url`
Force a specific custom keyword (e.g., `bysha.pe/my-custom-link`).

## Usage Examples

**Shorten a checkout link:**
"Shorten this checkout URL: https://business.shapescale.com/..."

**Create a custom branded link:**
"Create a short link `bysha.pe/acme-promo` for the pricing page."

**Track a campaign:**
"Shorten https://shapescale.com with source=linkedin, medium=social, campaign=winter_promo"

## Underlying Server
This skill wraps the [yourls-mcp](https://github.com/kesslerio/yourls-mcp) server.