short-urllisted
Install: claude install-skill AceDataCloud/Skills
# Short URL Service
Create short URLs through AceDataCloud's URL shortening API.
> **Setup:** See [authentication](../_shared/authentication.md) for token setup.
## Quick Start
```bash
curl -X POST https://api.acedata.cloud/shorturl \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"content": "https://example.com/very-long-url-path?with=params"}'
```
## Workflows
### 1. Create a Short URL
```json
POST /shorturl
{
"content": "https://example.com/article/2024/awesome-content"
}
```
Response:
```json
{
"data": {
"url": "https://suro.id/abc123"
},
"success": true
}
```
## Parameters
| Parameter | Required | Description |
|-----------|----------|-------------|
| `content` | Yes | The original long URL to shorten |
## Gotchas
- Short URLs use the `suro.id` domain
- Results are returned synchronously — no task polling needed
- The `content` field must be a valid URL to shorten
> **MCP:** `pip install mcp-shorturl` | Hosted: `https://short-url.mcp.acedata.cloud/mcp` | See [all MCP servers](../_shared/mcp-servers.md)