短链 + UTM 追踪

SkillDev tools

Short links + UTM tracking: appends UTM tracking parameters (source/medium/campaign) to content/campaign links and shortens them, making it easy to track traffic sources and campaign performance on platforms like Xiaohongshu/Douyin/WeChat Official Accounts. Use when the user says "短链" (short link),

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the 短链 + UTM 追踪 skill

What this skill tells your AI

The instructions your AI receives, as published by zju-real/easel in skills/openclaw/skill-short-link/SKILL.md and read by ahel’s review.

给链接拼 UTM 追踪参数并缩短,追踪各平台引流效果。走 scripts/shortlink.py(纯标准库无依赖, 短链用免 key 公共服务 TinyURL / is.gd / v.gd)。

输入

字段必填说明
URL落地页/商品/表单链接
sourceUTM 时必填来源平台,如 xiaohongshu/douyin/wechat
mediumUTM 时必填媒介,如 social/video/cpc
campaignUTM 时必填活动名,如 618/newproduct

执行

脚本路径(相对项目根):skills/openclaw/skill-short-link/scripts/shortlink.py(各子命令 -h)。

# 一步到位:拼 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 实现。

Signals

GitHub stars
1k
Forks
143
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
skill-short-link
Source
github.com/zju-real/easel