Jo4短链

技能简介

Jo4短链（jo4）是一个现代的 URL 缩短服务，支持 QR 码生成和详细的链接分析。

能做什么

• 创建短链接（支持自定义别名）
• 生成 QR 码
• 跟踪点击分析（地理位置、设备、浏览器、来源）
• UTM 参数跟踪
• 设置链接过期时间
• 密码保护链接
• 支持匿名创建（有限功能）

使用说明

安装 Skill：

通过 ClawHub 安装：

clawhub install jo4

认证：设置 API 密钥：export JO4_API_KEY="your-api-key"。从 https://jo4.io/api-keys 获取。

创建短链接：curl -X POST "https://jo4-api.jo4.io/api/v1/protected/url" -H "X-API-Key: $JO4_API_KEY" -H "Content-Type: application/json" -d '{"longUrl": "https://example.com", "title": "My Link"}'

支持参数：longUrl（必需）、title、description、shortUrl（自定义别名）、expirationTime（过期时间戳）、passwordProtected、password、UTM参数。

匿名创建（无需认证）：curl -X POST "https://jo4-api.jo4.io/api/v1/public/url" -H "Content-Type: application/json" -d '{"longUrl": "https://example.com"}'

获取链接详情：curl -X GET "https://jo4-api.jo4.io/api/v1/protected/url/{slug}" -H "X-API-Key: $JO4_API_KEY"

获取分析统计：curl -X GET "https://jo4-api.jo4.io/api/v1/protected/url/{slug}/stats" -H "X-API-Key: $JO4_API_KEY"

返回：总点击、按日期点击、地理分布、设备/浏览器分布、来源。

列出我的链接：curl -X GET "https://jo4-api.jo4.io/api/v1/protected/url/myurls?page=0&size=20" -H "X-API-Key: $JO4_API_KEY"

更新/删除：更新 PUT /protected/url/{id}，删除 DELETE /protected/url/{id}。

QR码：每个短链接自动生成 QR 码：https://jo4.io/qr/{shortUrl}

速率限制：免费：60请求/分钟，Pro：最高10000请求/分钟，匿名：10请求/分钟。

输入与输出

见下方输入与输出表格。

风险提示

• 需要 JO4_API_KEY（匿名创建除外）
• 免费版有速率限制（60/分钟）
• 匿名创建无分析访问权限
• 过期链接无法恢复
• 自定义别名有限制（16字符，字母数字下划线连字符）

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/jo4/SKILL.md

来源类型：GitHub