友盟命令行工具(Umeng Command Line Interface)- 支持通过多种鉴权方式调用友盟全线 API(官网接口/旧版 OpenAPI/阿里云风格 OpenAPI),涵盖移动统计、性能监控、消息推送、数据返还等功能。
友盟命令行工具是一个可在终端中操作友盟平台的 CLI 工具,支持人类用户和 AI Agent 使用。它可以调用友盟的多种服务,包括但不限于:
- 移动统计(U-App)
- 性能监控(U-APM)
- 消息推送(U-Push)
- 数据返还(U-DOP)
- 广告监测(AppTrack)
- 小程序统计(U-Mini)
- 反作弊 SDK
npm install -g @umengfe/umeng-cli# TODO: Shell 安装脚本尚未实现
# curl -fsSL https://raw.githubusercontent.com/umeng/umeng-cli/main/scripts/install.sh | sh安装完成后,可通过以下命令验证是否安装成功:
umeng-cli --version使用前需要先完成登录:
umeng-cli login这将会生成一个二维码,使用微信扫描即可完成登录。如果终端不支持显示二维码,可以使用以下命令:
umeng-cli login --no-qr此命令会生成一个登录链接,可以在浏览器中打开完成登录。
umeng-cli 支持三种鉴权方式调用不同的友盟 API:
- 官网接口(Cookie 鉴权):调用友盟官网内部接口
- 友盟旧版 OpenAPI(umeng-aksk 鉴权):使用 HMAC-SHA1 签名鉴权
- 友盟阿里云风格 OpenAPI(aliyun-aksk 鉴权):使用 ACS3-HMAC-SHA256 V3 签名鉴权
# 查看当前登录用户
umeng-cli whoami
# 列出所有已登录账号
umeng-cli account list
# 切换账号(交互式选择)
umeng-cli account switch注意:安装 umeng-cli CLI 工具和安装 umeng-cli Skills 是两码事:
- 安装 CLI 工具:通过
npm install -g @umengfe/umeng-cli安装命令行工具 - 安装 Skills:AI Agent 通过
npx skills add umeng/umeng-cli -y -g安装 Skills,以便了解和使用友盟 CLI 的能力
# AI Agent 安装 umeng-cli Skills
npx skills add umeng/umeng-cli -y -g
# TODO: 未来支持 Skills 搜索
# umeng-cli skills search '<keyword>'
# 调用特定 API
umeng-cli call '<tool_schema_json>' '<args_json>'# 调用友盟 OpenAPI 获取应用统计数据
umeng-cli call '{
"name": "umeng.uapp.getDailyData",
"api": {
"method": "GET",
"baseUrl": "https://gateway.open.umeng.com/openapi",
"endpoint": "param2/1/com.umeng.uapp/umeng.uapp.getDailyData",
"authType": "umeng-aksk"
}
}' '{"appkey":"your_appkey","startDate":"2025-01-01","endDate":"2025-01-07"}'# 调用 U-APM 获取性能趋势
umeng-cli call '{
"name": "apm.GetStatTrend",
"api": {
"method": "GET",
"baseUrl": "https://apm.openapi.umeng.com",
"endpoint": "/stat/getStatTrend",
"authType": "aliyun-aksk"
}
}' '{"dataSourceId":"your_datasource_id","startDate":"2025-01-01","endDate":"2025-01-07","type":"realtime"}'# 卸载 CLI 工具(包括二进制、Skills 和配置)
umeng-cli uninstall
# 卸载 CLI 工具但保留配置和凭证
umeng-cli uninstall --keep-config- GitHub: https://github.com/umeng/umeng-cli
- AI Agent Skills 文档 - 了解 umeng-cli 的完整能力和用法