Skip to main content
skill CX Codex

short-url — Claude Code skill: what it does, how to install

The short-url skill creates short links through the AceDataCloud API. Use it when a long URL needs a compact shareable form.

Apache-2.0 228 installs ★ 17 updated 2026-10-25

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add AceDataCloud/Skills --skill short-url -a claude-code
Open on GitHub

What short-url does

The skill sends a source URL to AceDataCloud and returns a shortened address under the suro.id domain. It uses POST /shorturl, and the API responds immediately rather than requiring task polling.

Set ACEDATACLOUD_API_TOKEN in a .env file before using it. The request’s content value must be a valid URL, so malformed input will stop the shortening request. That requirement is the main setup check.

The README also lists an optional MCP route. Install it with pip install mcp-shorturl, or connect to https://short-url.mcp.acedata.cloud/mcp. The MCP server can be used alongside the skill.

What it helps with

  • shorten a long URL through an API
  • return a compact link on suro.id
  • validate a source address before sending it
  • connect URL shortening through MCP

Example prompts for the agent

  • Shorten the URL in README.md and return the new link.
  • Send https://example.com/article to AceDataCloud and give me its short URL.
  • Check this address, then submit it to POST /shorturl using the configured token.

How to install short-url

1Skills CLI (Vercel)

npx skills add AceDataCloud/Skills --skill short-url -a claude-code

2Manually: put the files in place

~/.claude/skills/short-url/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/short-url/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about short-url

How do I install short-url in Claude Code?

Run npx skills add AceDataCloud/Skills --skill short-url -a claude-code. The skill file will be placed at ~/.claude/skills/short-url/SKILL.md.

What does short-url do?

It sends a long URL to the AceDataCloud API and returns a shortened link on suro.id. The response is synchronous.

What does short-url require?

Set ACEDATACLOUD_API_TOKEN in .env. The content request value must be a valid URL.

Source text

SKILL.md · Apache-2.0
---
name: short-url
description: Create short URLs via AceDataCloud API. Use when generating shortened links for sharing, or batch-creating multiple short URLs at once. Supports custom slugs and expiration.
license: Apache-2.0
metadata:
  author: acedatacloud
  version: "1.0"
compatibility: Requires ACEDATACLOUD_API_TOKEN in .env file (see _shared/authentication.md). Optionally pair with mcp-short-url for tool-use.
---

# 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)

© acedatacloud · Apache-2.0 · AceDataCloud/Skills

Similar skills

SKILL.md skills catalog →

From the same set67

The whole set →
google-search google-search runs Google queries for pages, images, news, maps, places or videos through the AceDataCloud API and returns structured results to the agent. CX Codex +1 232installs google-gmail google-gmail is a Claude Code skill for searching Gmail, reviewing threads, and handling labels or attachments. Sending and other write actions require granted scopes and user confirmation. CX Codex +1 231installs ai-chat ai-chat routes agent requests to 50+ LLM models via AceDataCloud unified chat gateway. Handles stateful conversations, audio processing, and OpenAI-compatible completions across multiple model families. CX Codex +1 230installs zhihu Adds Zhihu to your coding agent: search posts or the open web, check trending topics, pull stats for your own articles and answers. CX Codex +1 229installs face-transform face-transform is a Claude Code skill that connects seven AceDataCloud face APIs for keypoint detection, retouching, age and gender changes, face swaps, cartoon conversion, and liveness checks. CX Codex +1 228installs google-calendar Reads calendar events, checks free slots, and manages meetings via Google Calendar v3 REST API. Useful for controlling your schedule directly from the terminal. CX Codex +1 222installs blogger Use Blogger API v3 to publish posts, inspect blogs and entries, or update an existing post. The skill handles these tasks from Claude Code. CX Codex +1 221installs tencentcloud-cls Search and analyze Tencent Cloud CLS logs, inspect API failures, follow trace IDs, and run CQL or SQL queries over log topics. CX Codex +1 221installs

Project sponsors

Companies that keep this analytics open