short-url — скилл для Claude Code: что делает и как установить
Скилл short-url для Claude Code создаёт короткие ссылки через AceDataCloud API. Готовит длинный URL к передаче или публикации.
Apache-2.0 228 установок ★ 17 обновлён 2026-10-25
npx skills add AceDataCloud/Skills --skill short-url -a claude-codeЧто делает short-url
Скилл отправляет исходный URL в AceDataCloud API и возвращает короткую ссылку с доменом suro.id. Запрос выполняется через POST /shorturl, а результат приходит сразу, без опроса фоновой задачи.
Для работы нужен токен ACEDATACLOUD_API_TOKEN в файле .env. Поле content должно содержать корректный URL, иначе сокращение не сработает. Это главное ограничение перед установкой.
В README также указан дополнительный вариант подключения через MCP: пакет mcp-shorturl устанавливается командой pip install mcp-shorturl, а удалённый сервер доступен по адресу https://short-url.mcp.acedata.cloud/mcp. MCP можно использовать вместе со скиллом.
Какие задачи решает
- сократить длинный URL через API
- получить короткую ссылку с доменом
suro.id - проверить корректность исходного адреса перед отправкой
- подключить сокращение ссылок через MCP
Примеры запросов агенту
- Сократи URL из
README.mdи верни короткую ссылку. - Создай короткую ссылку для
https://example.com/articleчерез AceDataCloud API. - Проверь адрес и отправь его в
POST /shorturlс нужным токеном.
Как установить short-url
1Через Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill short-url -a claude-code2Вручную: положить файлы
~/.claude/skills/short-url/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/short-url/
1Через Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill short-url -a codex2Вручную: положить файлы
.agents/skills/short-url/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill short-url -a cursor2Вручную: положить файлы
.cursor/skills/short-url/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install AceDataCloud/Skills skills/short-url2Вручную: положить файлы
.github/skills/short-url/SKILL.md1Через Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill short-url -a gemini-cli2Командой платформы
gemini skills install https://github.com/AceDataCloud/Skills --path skills/short-urlВручную: положить файлы
.devin/skills/short-url/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill short-url -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о short-url
Как установить short-url в Claude Code?
Выполните npx skills add AceDataCloud/Skills --skill short-url -a claude-code. Файл скилла появится по пути ~/.claude/skills/short-url/SKILL.md.
Что делает short-url?
Скилл отправляет длинный URL в AceDataCloud API и получает короткую ссылку на домене suro.id. Ответ возвращается синхронно.
Что нужно для работы short-url?
В .env должен быть задан ACEDATACLOUD_API_TOKEN. Значение content в запросе должно быть корректным URL.
Исходный текст
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