ZJU-REAL/Easel / skills/builtin/skill-short-link
skill-short-link
Verified短链 + UTM 追踪:给内容/投放链接拼接 UTM 追踪参数(来源/媒介/活动)并缩短, 便于在小红书/抖音/公众号等追踪流量来源与活动效果。当用户说"短链""生成短链""缩短链接" "UTM""追踪链接""投放链接""带参数的链接""统计来源""tinyurl"时使用。用免 key 公共短链服务。
| File | Kind | Size |
|---|---|---|
| EASEL-META.md | markdown | 520 B |
| SKILL.md | skill md | 2.4 KB |
| scripts/shortlink.py | script | 7.1 KB |
SKILL.md
View on GitHub---
name: skill-short-link
description: >-
短链 + UTM 追踪:给内容/投放链接拼接 UTM 追踪参数(来源/媒介/活动)并缩短,
便于在小红书/抖音/公众号等追踪流量来源与活动效果。当用户说"短链""生成短链""缩短链接"
"UTM""追踪链接""投放链接""带参数的链接""统计来源""tinyurl"时使用。用免 key 公共短链服务。
layer: publish
---
# 短链 + UTM 追踪
> 给链接拼 UTM 追踪参数并缩短,追踪各平台引流效果。走 `scripts/shortlink.py`(纯标准库无依赖,
> 短链用免 key 公共服务 TinyURL / is.gd / v.gd)。
## 输入
| 字段 | 必填 | 说明 |
|------|------|------|
| URL | 是 | 落地页/商品/表单链接 |
| source | UTM 时必填 | 来源平台,如 xiaohongshu/douyin/wechat |
| medium | UTM 时必填 | 媒介,如 social/video/cpc |
| campaign | UTM 时必填 | 活动名,如 618/newproduct |
## 执行
脚本路径(相对项目根):`skills/builtin/skill-short-link/scripts/shortlink.py`(各子命令 `-h`)。
```bash
# 一步到位:拼 UTM + 缩短(最常用)
python <skill>/scripts/shortlink.py both --url "https://shop.example.com/item/123" \
--source xiaohongshu --medium social --campaign 618
# 只拼 UTM 参数
python <skill>/scripts/shortlink.py utm --url "https://a.com/p" \
--source douyin --medium video --campaign summer --content 视频A
# 只缩短
python <skill>/scripts/shortlink.py short --url "https://a.com/very/long/url" --provider tinyurl
```
- 默认短链服务 `tinyurl`(最稳、任意 URL 均可);也可 `--provider isgd`/`vgd`(支持 `--alias` 自定义短码,
但对部分域名有黑名单)。
- 多平台投放建议**每个平台一条短链**(source 不同),这样后台能分平台看流量。
## 规则
1. 每个投放渠道生成独立短链(utm_source 区分),否则无法分平台归因。
2. campaign 用统一命名规范(如 `618`、`产品名-月份`),方便后续聚合。
3. `--content` 用于同活动多素材 A/B(如"视频A"/"图文B")。
4. 短链服务为第三方公共服务,重要投放建议自建短链域名(本 SKILL 便于快速出链)。
## 参考来源
UTM 是 GA/各分析平台通用的来源追踪参数标准(utm_source/medium/campaign/term/content)。
短链用 TinyURL / is.gd / v.gd 的免 key 公共 API。纯 urllib 实现。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Unverified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |