This skill should be used when the user asks to "lookup Amplitude user", "find user by device ID", "get user activity from Amplitude", or "search Amplitude user events". Queries Amplitude REST API for user data using Device ID or User ID.
View on GitHubamplitude-user-lookup/skills/amplitude-user-lookup/SKILL.md
February 1, 2026
Select agents to install to:
npx add-skill https://github.com/jongwony/cc-plugin/blob/main/amplitude-user-lookup/skills/amplitude-user-lookup/SKILL.md -a claude-code --skill amplitude-user-lookupInstallation paths:
.claude/skills/amplitude-user-lookup/# 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