{"id":"5d593bae-504c-4e5d-86b2-326309079919","shortId":"zvDBrc","kind":"skill","title":"short-url","tagline":"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.","description":"# Short URL Service\n\nCreate short URLs through AceDataCloud's URL shortening API.\n\n> **Setup:** See [authentication](../_shared/authentication.md) for token setup.\n\n## Quick Start\n\n```bash\ncurl -X POST https://api.acedata.cloud/shorturl \\\n  -H \"Authorization: Bearer $ACEDATACLOUD_API_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"content\": \"https://example.com/very-long-url-path?with=params\"}'\n```\n\n## Workflows\n\n### 1. Create a Short URL\n\n```json\nPOST /shorturl\n{\n  \"content\": \"https://example.com/article/2024/awesome-content\"\n}\n```\n\nResponse:\n\n```json\n{\n  \"data\": {\n    \"url\": \"https://suro.id/abc123\"\n  },\n  \"success\": true\n}\n```\n\n## Parameters\n\n| Parameter | Required | Description |\n|-----------|----------|-------------|\n| `content` | Yes | The original long URL to shorten |\n\n## Gotchas\n\n- Short URLs use the `suro.id` domain\n- Results are returned synchronously — no task polling needed\n- The `content` field must be a valid URL to shorten\n\n> **MCP:** `pip install mcp-shorturl` | Hosted: `https://short-url.mcp.acedata.cloud/mcp` | See [all MCP servers](../_shared/mcp-servers.md)","tags":["short","url","skills","acedatacloud","acedata-cloud","agent-skills","agentskills","ai-image","ai-music","ai-tools","ai-video","claude-code"],"capabilities":["skill","source-acedatacloud","skill-short-url","topic-acedata-cloud","topic-agent-skills","topic-agentskills","topic-ai-image","topic-ai-music","topic-ai-tools","topic-ai-video","topic-claude-code","topic-cursor","topic-gemini-cli","topic-github-copilot","topic-mcp"],"categories":["Skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/AceDataCloud/Skills/short-url","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add AceDataCloud/Skills","source_repo":"https://github.com/AceDataCloud/Skills","install_from":"skills.sh"}},"qualityScore":"0.453","qualityRationale":"deterministic score 0.45 from registry signals: · indexed on github topic:agent-skills · 7 github stars · SKILL.md body (1,103 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T19:14:03.730Z","embedding":null,"createdAt":"2026-05-18T13:21:34.633Z","updatedAt":"2026-05-18T19:14:03.730Z","lastSeenAt":"2026-05-18T19:14:03.730Z","tsv":"'/_shared/authentication.md':46 '/_shared/mcp-servers.md':148 '/abc123':94 '/article/2024/awesome-content':87 '/mcp':143 '/shorturl':58,83 '/very-long-url-path?with=params':74 '1':76 'acedatacloud':8,38,62 'api':9,42,63 'api.acedata.cloud':57 'api.acedata.cloud/shorturl':56 'application/json':69 'authent':45 'author':60 'bash':52 'batch':19 'batch-creat':18 'bearer':61 'content':67,71,84,101,125 'content-typ':66 'creat':4,20,34,77 'curl':53 'custom':27 'd':70 'data':90 'descript':100 'domain':115 'example.com':73,86 'example.com/article/2024/awesome-content':85 'example.com/very-long-url-path?with=params':72 'expir':30 'field':126 'generat':12 'gotcha':109 'h':59,65 'host':140 'instal':136 'json':81,89 'link':14 'long':105 'mcp':134,138,146 'mcp-shorturl':137 'multipl':21 'must':127 'need':123 'origin':104 'paramet':97,98 'pip':135 'poll':122 'post':55,82 'quick':50 'requir':99 'respons':88 'result':116 'return':118 'see':44,144 'server':147 'servic':33 'setup':43,49 'share':16 'short':2,5,22,31,35,79,110 'short-url':1 'short-url.mcp.acedata.cloud':142 'short-url.mcp.acedata.cloud/mcp':141 'shorten':13,41,108,133 'shorturl':139 'skill' 'skill-short-url' 'slug':28 'source-acedatacloud' 'start':51 'success':95 'support':26 'suro.id':93,114 'suro.id/abc123':92 'synchron':119 'task':121 'token':48,64 'topic-acedata-cloud' 'topic-agent-skills' 'topic-agentskills' 'topic-ai-image' 'topic-ai-music' 'topic-ai-tools' 'topic-ai-video' 'topic-claude-code' 'topic-cursor' 'topic-gemini-cli' 'topic-github-copilot' 'topic-mcp' 'true':96 'type':68 'url':3,6,23,32,36,40,80,91,106,111,131 'use':10,112 'valid':130 'via':7 'workflow':75 'x':54 'yes':102","prices":[{"id":"1b8006ae-2ba3-4170-9fe8-d7a714448ffa","listingId":"5d593bae-504c-4e5d-86b2-326309079919","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"AceDataCloud","category":"Skills","install_from":"skills.sh"},"createdAt":"2026-05-18T13:21:34.633Z"}],"sources":[{"listingId":"5d593bae-504c-4e5d-86b2-326309079919","source":"github","sourceId":"AceDataCloud/Skills/short-url","sourceUrl":"https://github.com/AceDataCloud/Skills/tree/main/skills/short-url","isPrimary":false,"firstSeenAt":"2026-05-18T13:21:34.633Z","lastSeenAt":"2026-05-18T19:14:03.730Z"}],"details":{"listingId":"5d593bae-504c-4e5d-86b2-326309079919","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"AceDataCloud","slug":"short-url","github":{"repo":"AceDataCloud/Skills","stars":7,"topics":["acedata-cloud","agent-skills","agentskills","ai-image","ai-music","ai-tools","ai-video","claude-code","cursor","gemini-cli","github-copilot","mcp","npm","openai-codex","roo-code"],"license":"other","html_url":"https://github.com/AceDataCloud/Skills","pushed_at":"2026-05-18T07:35:03Z","description":"Agent Skills for AceDataCloud AI services — music, image, video generation, web search, and more. Compatible with Claude Code, GitHub Copilot, Gemini CLI, and all agentskills.io-compatible agents.","skill_md_sha":"ddcd4e72cdccb1eefa8185e64b54e244a298e007","skill_md_path":"skills/short-url/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/AceDataCloud/Skills/tree/main/skills/short-url"},"layout":"multi","source":"github","category":"Skills","frontmatter":{"name":"short-url","license":"Apache-2.0","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.","compatibility":"Requires ACEDATACLOUD_API_TOKEN in .env file (see _shared/authentication.md). Optionally pair with mcp-short-url for tool-use."},"skills_sh_url":"https://skills.sh/AceDataCloud/Skills/short-url"},"updatedAt":"2026-05-18T19:14:03.730Z"}}