短链

当前状态：Beta

短链用于在同一条 Agent 工作流里管理普通 Nox 短链，并查看短链效果数据。

适合什么场景

你需要查看已有普通 Nox 短链
你需要为已确认目标 URL 创建短链
你需要在确认准确 ID 后重命名或删除短链
你需要查看某条短链在指定时间窗口里的基础效果数据
你需要直接下载短链列表或单条短链效果 Excel

当前 beta 范围

按关键词、creator user IDs、创建时间和分页查看短链
查看单条短链和效果指标
创建普通 Nox 短链
更新短链标题
按 ID 删除一条或多条短链
把已选短链行或单条短链效果直接导出为 Excel

重要边界

本页只覆盖普通 Nox 短链。Shopify 联盟营销活动里的 tracking links、折扣码、成员和活动表现属于联盟营销。

关键命令

准备写入 body 前先查看 schema：

noxinfluencer schema "short-link list"
noxinfluencer schema "short-link get"
noxinfluencer schema "short-link create"
noxinfluencer schema "short-link update"
noxinfluencer schema "short-link delete"
noxinfluencer schema "short-link export-list"
noxinfluencer schema "short-link export-effect"

查看短链：

noxinfluencer short-link list --keyword summer --page_size 20
noxinfluencer short-link list --creator-uids <user_uid_1>,<user_uid_2>
noxinfluencer short-link get <short_link_id>
noxinfluencer short-link get <short_link_id> --start-time 2026-07-01T00:00:00Z --end-time 2026-07-08T00:00:00Z

只有确认后才创建、更新或删除：

noxinfluencer short-link create --body-file short-link.json --force
noxinfluencer short-link update <short_link_id> --body-file short-link-update.json --force
noxinfluencer short-link delete --body-file short-link-delete.json --force

把 SaaS Excel 报告直接下载到本地路径：

noxinfluencer short-link export-list --body-file short-link-export.json --output short-links.xlsx
noxinfluencer short-link export-effect <short_link_id> --start-time 2026-07-01T00:00:00Z --end-time 2026-07-08T00:00:00Z --output short-link-effect.xlsx

这些报告命令不会创建共享异步 export 任务。只有明确要替换已有本地文件时，才使用 --overwrite。

创建 body 示例：

{
  "title": "Summer landing page",
  "web": "https://www.example.com/summer",
  "utm_source": "agent"
}

创建短链时，web、ios、android 至少需要提供一个。

安全执行规则

写操作默认 dry-run；只有确认准确短链和动作后才使用 --force
create、update、delete 使用 --body-file
delete 接收 ID 列表 body，执行前需要确认所有目标 ID
如果不传成对的 --start-time 和 --end-time，short-link get 默认读取最近 7 天效果
不要用这个工具管理 Shopify affiliate tracking links
Excel 报告命令会直接写入 --output，不要通过 export list/get 轮询

当前边界

它不会授权 Shopify 店铺
它不会管理 affiliate members、discount codes 或 affiliate campaign tracking links
它不会构建完整活动报告；可围绕已选短链下载列表 / 效果 Excel，并通过其他 marketing ops 页面维护活动上下文