概述

将长 URL 转换为短链，访问短链时自动 302 跳转到目标地址。需要 API Key 鉴权。

AI Agent 使用

不想写代码？下载 url-shortener Skill，直接扔给 AI Agent 读取，Agent 自己就会生成短链。

把这个 Skill 加载进去：
https://shxai.space/skills/url-shortener.md

然后对 Agent 说：
"帮我把这个链接转成短链 https://..."

查看所有 Skills →

POST 创建短链

发送 POST 请求创建短链：

curl -X POST "https://short.shxai.space/create?key=YOUR_API_KEY&url=https://github.com"

响应：

{
  "short": "https://short.shxai.space/a1b2c3",
  "slug": "a1b2c3",
  "url": "https://github.com"
}

GET 访问短链

直接访问短链地址，浏览器会自动跳转：

curl -L https://short.shxai.space/a1b2c3

→ HTTP 302 跳转到原始 URL

参数

状态码

实现原理

POST /create → CF Worker → 验证 API Key (KV Store)
  → 生成短码 → 写入 KV: url:{slug}
  → 返回短链

GET /:slug → CF Worker → 查 KV: url:{slug}
  → 存在：302 跳转
  → 不存在：404