前言¶

给小程序做投放时，常规做法是登录友盟后台手工创建推广活动、再逐个渠道复制链接，或者临时写一段脚本调友盟 OpenAPI。前者不适合批量铺渠道，后者的鉴权、网关地址、接口版本容易写错，且脚本用完就没人维护。

下面介绍的 Skill 把这件事收敛成一条 CLI 调用：umeng-cli call 打到友盟 OpenAPI 网关，覆盖推广链接创建和活动/渠道清单查询。适合需要让 Agent 或 CI 流程批量产出小程序推广链接的开发者。

这是什么¶

这是一个社区出品的 Agent Skill，坐标 @user_fc9923d6/uapp-campaign，当前版本 1.0.1，分类 business-ops。

它解决的问题是：把友盟推广相关的两个 OpenAPI 接口封装成 CLI 可调用的能力，等价于旧 uapp-campaign 的能力，只是调用方式从旧形态改成了 umeng-cli call。

核心功能¶

按官方简介，这个 Skill 只封装 2 个推广接口：

1、写入接口：创建推广链接。
2、只读接口：查询推广活动列表 / 推广渠道列表。

调用入口统一是 umeng-cli call，请求发往友盟 OpenAPI 网关 gateway.open.umeng.com。

Skill 页面标注 requires_api_key=false，即不要求使用方自行提供 API Key。这一点以官方页面说明为准。

它只做推广链接这一层，不涉及埋点上报、数据看板、用户属性等友盟的其他能力。

安装与启用¶

官方页面给出的坐标是：

@user_fc9923d6/uapp-campaign
官方地址: https://api.skillhub.cn/user_fc9923d6/uapp-campaign
SkillHub 页面: https://www.skillhub.cn/skills/user_fc9923d6/uapp-campaign

安装命令我没有在已抓取的资料里核实到，这里不写推测命令。直接打开上面的官方地址，按页面提示把 Skill 装到你的 Agent 环境（Cursor / Codex CLI / Claude Code 的安装方式如有差异，以官方页面为准），然后在会话里触发即可。

需要注意两点：

1、这类 Skill 基于通用 SKILL.md 格式，启用方式取决于宿主 Agent，不是普通的 npm 包。
2、使用前确认宿主环境能访问 gateway.open.umeng.com，内网或代理环境要单独放行。

典型用法¶

Skill 的调用形态是 umeng-cli call，请求目标是友盟 OpenAPI 网关。下面说明两种典型意图对应的操作，具体接口路径、参数名和返回字段以友盟 OpenAPI 文档和 Skill 说明为准，这里不抄录未核实的参数表。

场景一，用户说「帮我给这个小程序建一条推广链接」。Skill 走写入接口，把创建推广链接的请求通过 umeng-cli call 发到友盟网关，返回结果后再把链接交回用户。

场景二，用户说「查一下有哪些推广活动 / 推广渠道」。Skill 走只读接口，拉回活动清单或渠道清单并按清单呈现。

因为是 CLI 化的封装，这些动作可以放在 Agent 的对话流程里，也可以放进自动化脚本，省掉自己拼签名和网关地址的功夫。

适用场景与注意¶

适合这几类情况：

1、小程序 / H5 / 小游戏需要批量创建推广链接、按渠道分发。
2、需要让 Agent 在对话中查询推广活动或渠道清单。
3、想把推广链接的创建从后台手工操作迁移到脚本或流程里。

限制和坑要提前说清楚：

1、仅适用于小程序 / H5 / 小游戏，不支持 Android / iOS App。给 App 做推广链接不要用这个 Skill。
2、能力范围只有 2 个推广接口（1 写入 + 1 只读），数据查询、报表、鉴权管理都不在里面。
3、接口数量少意味着它很薄，别指望它替代完整的友盟 OpenAPI SDK；复杂场景仍要直接写 OpenAPI 调用。
4、资料里没有公开接口的限频和错误码约定，批量创建前先小批量验证。

结尾¶

这个 Skill 的价值不在于多强，而在于把友盟推广链接的创建和查询压成一条 umeng-cli call，让 Agent 能直接产出小程序推广链接，不用再开后台页面。如果你的投放是小程序 / H5 / 小游戏这条线，可以装上试试。

官方地址：https://api.skillhub.cn/user_fc9923d6/uapp-campaign