SkillHub ClubShip Full StackFull Stack

amplitude-user-lookup

Amplitude user behavior queries

Packaged view

This page reorganizes the original catalog entry around fit, installability, and workflow context first. The original raw source lives below.

Stars

Hot score

Updated

March 20, 2026

Overall rating

C2.2

Composite score

2.2

Best-practice grade

B82.7

Install command

npx @skill-hub/cli install jongwony-cc-plugin-amplitude-user-lookup

Repository

jongwony/cc-plugin

Skill path: amplitude-user-lookup/skills/amplitude-user-lookup

Amplitude user behavior queries

Open repository

Best for

Primary workflow: Ship Full Stack.

Technical facets: Full Stack.

Target audience: everyone.

License: Unknown.

Original source

Catalog source: SkillHub Club.

Repository owner: jongwony.

This is still a mirrored public skill entry. Review the repository before installing into production workflows.

What it helps with

Install amplitude-user-lookup into Claude Code, Codex CLI, Gemini CLI, or OpenCode workflows
Review https://github.com/jongwony/cc-plugin before adding amplitude-user-lookup to shared team environments
Use amplitude-user-lookup for development workflows

Works across

Claude CodeCodex CLIGemini CLIOpenCode

Favorites: 0.

Sub-skills: 0.

Aggregator: No.

Original source / Raw SKILL.md

---
name: amplitude-user-lookup
description: Amplitude user behavior queries
---

# Amplitude User Lookup

Query Amplitude user data via REST API using Device ID or User ID.

## Prerequisites

Set environment variables:
```bash
export AMPLITUDE_API_KEY="your-api-key"
export AMPLITUDE_SECRET_KEY="your-secret-key"
export AMPLITUDE_REGION="us"  # or "eu" for EU data residency
```

Get keys from: Amplitude Dashboard > Settings > Projects > General

## Quick Start

### 1. Search User (Device ID -> Amplitude ID)

```bash
python scripts/user_search.py "DEVICE-ID-HERE"
```

### 2. Get User Activity

```bash
python scripts/user_activity.py AMPLITUDE_ID --limit 50
```

### Combined Workflow

```bash
# Get Amplitude ID first
AMP_ID=$(python scripts/user_search.py "DEVICE-ID" --json | jq -r '.matches[0].amplitude_id')

# Then get activity
python scripts/user_activity.py $AMP_ID --limit 100
```

## Script Options

| Script | Options |
|--------|---------|
| `user_search.py` | `--json` for raw JSON output |
| `user_activity.py` | `--limit N`, `--offset N`, `--direction [latest\|earliest]`, `--json` |

## Rate Limits

- User Search/Activity: **360 requests/hour**
- Concurrent requests: **5 max**

## References

- **[API Reference](references/api-reference.md)**: curl examples, response schemas, error codes
- **[Scripts Guide](references/scripts-guide.md)**: detailed script usage and examples