clerk

vm0-ai 的头像作者 vm0-ai

从Clerk获取用户指标(总用户数、活跃用户数、新用户数)

📖 中文导读:从Clerk获取用户指标(总用户数、活跃用户数、新用户数) 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: clerk description: Get user metrics from Clerk (total users, active users, new users)

Clerk User Metrics Skill

Fetches user statistics from Clerk authentication service.

When to Use

Use this skill when you need to get:

  • Total user count
  • Active users (users with activity yesterday)
  • New users (users created yesterday)

How to Use

# Get yesterday's user metrics (default)
$CLAUDE_CONFIG_DIR/skills/clerk/scripts/get-users.sh

# Get metrics for a specific date
$CLAUDE_CONFIG_DIR/skills/clerk/scripts/get-users.sh "2024-12-17"

Arguments

  • date (optional): Specific date in YYYY-MM-DD format. Defaults to yesterday.

Prerequisites

  • CLERK_SECRET_KEY environment variable must be set (starts with sk_live_ or sk_test_)

Output

Results are saved to /tmp/data/clerk_users_[timestamp].json:

{
  "date": "2024-12-17",
  "total_users": 150,
  "active_users": 25,
  "new_users": 5
}

Console output:

Clerk User Metrics for 2024-12-17
Total Users: 150
Active Users: 25
New Users: 5

API Reference

Error Handling

  • 401 Unauthorized: Check that CLERK_SECRET_KEY is set correctly
  • 403 Forbidden: The API key may not have the required permissions
  • 429 Rate Limited: Too many requests, try again later