← 返回 Skills 市场
aiwithabidi

Amplitude

作者 aiwithabidi · GitHub ↗ · v1.0.0
cross-platform ⚠ suspicious
717
总下载
0
收藏
3
当前安装
1
版本数
在 OpenClaw 中安装
/install amplitude
功能描述
Amplitude product analytics — track events, analyze user behavior, run cohort analysis, manage user properties, and query funnel/retention data via the Ampli...
使用说明 (SKILL.md)

📉 Amplitude

Amplitude product analytics — track events, analyze user behavior, run cohort analysis, manage user properties, and query funnel/retention data via the Amplitude API.

Features

  • Event tracking — log user events with properties
  • User analytics — active users, sessions, engagement
  • Funnel analysis — conversion through event sequences
  • Retention analysis — user return rates over time
  • Cohort management — create and manage user cohorts
  • User properties — set and query user attributes
  • Revenue analytics — LTV, ARPU, revenue tracking
  • Segmentation — query by properties and events
  • Event segmentation — event counts and breakdowns
  • Dashboard export — export chart data

Requirements

Variable Required Description
AMPLITUDE_API_KEY API key/token for Amplitude
AMPLITUDE_SECRET_KEY Amplitude secret key for Export/Dashboard APIs

Quick Start

# Track an event
python3 {baseDir}/scripts/amplitude.py track '{"user_id":"user123","event_type":"purchase","event_properties":{"amount":29.99}}'
# Track batch events
python3 {baseDir}/scripts/amplitude.py track-batch events.json
# Set user properties
python3 {baseDir}/scripts/amplitude.py identify '{"user_id":"user123","user_properties":{"plan":"pro","company":"Acme"}}'
# Get active user counts
python3 {baseDir}/scripts/amplitude.py active-users --start 2026-01-01 --end 2026-02-01

Commands

track

Track an event.

python3 {baseDir}/scripts/amplitude.py track '{"user_id":"user123","event_type":"purchase","event_properties":{"amount":29.99}}'

track-batch

Track batch events.

python3 {baseDir}/scripts/amplitude.py track-batch events.json

identify

Set user properties.

python3 {baseDir}/scripts/amplitude.py identify '{"user_id":"user123","user_properties":{"plan":"pro","company":"Acme"}}'

active-users

Get active user counts.

python3 {baseDir}/scripts/amplitude.py active-users --start 2026-01-01 --end 2026-02-01

events

Get event data.

python3 {baseDir}/scripts/amplitude.py events --start 2026-01-01 --end 2026-02-01 --event purchase

funnel

Run funnel analysis.

python3 {baseDir}/scripts/amplitude.py funnel '{"events":[{"event_type":"page_view"},{"event_type":"signup"},{"event_type":"purchase"}]}' --start 2026-01-01 --end 2026-02-01

retention

Retention analysis.

python3 {baseDir}/scripts/amplitude.py retention --start 2026-01-01 --end 2026-02-01

cohorts

List cohorts.

python3 {baseDir}/scripts/amplitude.py cohorts

cohort-get

Get cohort details.

python3 {baseDir}/scripts/amplitude.py cohort-get abc123

revenue

Revenue analysis.

python3 {baseDir}/scripts/amplitude.py revenue --start 2026-01-01 --end 2026-02-01

user-search

Search for a user.

python3 {baseDir}/scripts/amplitude.py user-search "[email protected]"

user-activity

Get user activity.

python3 {baseDir}/scripts/amplitude.py user-activity user123

segments

Event segmentation query.

python3 {baseDir}/scripts/amplitude.py segments --event purchase --group-by platform --start 2026-01-01 --end 2026-02-01

Output Format

All commands output JSON by default. Add --human for readable formatted output.

# JSON (default, for programmatic use)
python3 {baseDir}/scripts/amplitude.py track --limit 5

# Human-readable
python3 {baseDir}/scripts/amplitude.py track --limit 5 --human

Script Reference

Script Description
{baseDir}/scripts/amplitude.py Main CLI — all Amplitude operations

Data Policy

This skill never stores data locally. All requests go directly to the Amplitude API and results are returned to stdout. Your data stays on Amplitude servers.

Credits


Built by M. Abidi | agxntsix.ai YouTube | GitHub Part of the AgxntSix Skill Suite for OpenClaw agents.

📅 Need help setting up OpenClaw for your business? Book a free consultation

安全使用建议
This skill mostly looks like an Amplitude CLI, but there are two issues to consider before installing: (1) the manifest asks for AMPLITUDE_SECRET_KEY even though the shipped script never uses it — ask the author why that secret is required or remove it. (2) if AMPLITUDE_API_KEY isn't in the environment, the script will read a .env file from your workspace (~/.openclaw/workspace/.env or a path from WORKSPACE). That means the skill will access local files for credentials; ensure that .env doesn't contain unrelated secrets and prefer setting AMPLITUDE_API_KEY explicitly in the agent's secret store. If you require stronger assurance, request the author to remove the unused secret requirement, remove the .env fallback, or allow you to review an updated version that only uses declared credentials and documents why any local file reads are necessary.
功能分析
Type: OpenClaw Skill Name: amplitude Version: 1.0.0 The skill's stated purpose of integrating with Amplitude API is benign. However, the `scripts/amplitude.py` file contains significant functional bugs where JSON payloads for commands like `track`, `track-batch`, and `identify` are not correctly parsed or passed to the API, rendering core functionalities non-operational. Additionally, the script exhibits a potential path injection vulnerability where `args.id` is directly interpolated into API URL paths without sanitization, which could be exploited for URL manipulation. While there is no evidence of intentional malice, these critical vulnerabilities and functional flaws make the skill suspicious.
能力评估
Purpose & Capability
The skill claims to integrate with Amplitude and requires AMPLITUDE_API_KEY and AMPLITUDE_SECRET_KEY. The implementation only uses AMPLITUDE_API_KEY; AMPLITUDE_SECRET_KEY is declared but never read or used. Requesting a secret key that the code doesn't use is disproportionate and inconsistent with the stated purpose.
Instruction Scope
SKILL.md states 'never stores data locally' and that only the Amplitude API is contacted, but the CLI code will, if the AMPLITUDE_API_KEY env var is not set, try to read a .env file from a workspace path (WORKSPACE or ~/.openclaw/workspace/.env). That is file access outside the Amplitude API and may expose other local secrets if the .env contains them (the code only parses lines beginning with AMPLITUDE_API_KEY=, but reading local workspace files is scope creep relative to the documentation).
Install Mechanism
No install spec — instruction-only plus a Python script that relies on stdlib only. No external downloads or installers are declared, which is low-risk from an install-mechanism perspective.
Credentials
The skill requires two environment variables (AMPLITUDE_API_KEY and AMPLITUDE_SECRET_KEY). The code only reads AMPLITUDE_API_KEY (and will fall back to parsing a local .env for it). AMPLITUDE_SECRET_KEY is not used anywhere in the script, so requesting it is unnecessary and disproportionate. Additionally, the fallback to reading a workspace .env file can surface secrets stored there.
Persistence & Privilege
The skill does not request always:true, does not modify other skills or global agent configuration, and does not write persistent files. It only reads a workspace .env file as a fallback and otherwise sends requests to amplitude.com.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install amplitude
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /amplitude 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
- Initial release of the Amplitude product analytics skill. - Track events, analyze user behavior, run cohort and funnel analyses, manage user properties, and perform retention and revenue analysis via the Amplitude API. - Includes segmentation, event segmentation, dashboard export, and comprehensive CLI commands. - Requires only Python 3.10+ standard library (no external dependencies). - Secure: no data stored locally; all operations performed via direct API calls.
元数据
Slug amplitude
版本 1.0.0
许可证
累计安装 3
当前安装数 3
历史版本数 1
常见问题

Amplitude 是什么?

Amplitude product analytics — track events, analyze user behavior, run cohort analysis, manage user properties, and query funnel/retention data via the Ampli... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 717 次。

如何安装 Amplitude?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install amplitude」即可一键安装,无需额外配置。

Amplitude 是免费的吗?

是的,Amplitude 完全免费(开源免费),可自由下载、安装和使用。

Amplitude 支持哪些平台?

Amplitude 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Amplitude?

由 aiwithabidi(@aiwithabidi)开发并维护,当前版本 v1.0.0。

💬 留言讨论