mcpField
P
profile-explorer

profile-explorer

github.com/lyticsMarketing & growth455 installsUpdated 3w ago
Repository

About profile-explorer

profile-explorer is a skill for interactive user-profile exploration, intended for users analyzing identity data, segment membership, and event history. It combines profile lookup with segment queries and supports follow-up investigation of attributes and related data.

Key features

  1. 01Look up profiles by identity field
  2. 02Retrieve segment memberships
  3. 03Present structured profile summaries
  4. 04Explore history and attributes further
  5. 05Compare multiple user profiles

Use cases

  1. 01Find a user's profile and attributes by email
  2. 02Check which segments include a user
  3. 03Compare users or investigate segment membership

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/lytics/agent-skills --skill profile-explorer

After installing, type/profile-explorerin Claude Code to confirm it loaded.

Details

From the project README

Profile Explorer

Purpose

Interactive profile exploration that combines identity lookup, segment membership analysis, and event history browsing. Provides a comprehensive view of an individual user profile.

Environment

Requires authenticated API access. See ../references/auth.md for credential resolution.

Inputs

  • Identity field and value (e.g., email, [email protected])
  • Or: exploration query (e.g., "find a user in the high-value segment")

Exploration Flow

Step 1: Look Up Profile

Use entity-lookup skill:

curl -s "${LYTICS_API_URL:-https://api.lytics.io}/api/entity/user/${FIELD}/${VALUE}" \
  -H "Authorization: ${LYTICS_API_TOKEN}"
Step 2: Get Segment Memberships
curl -s "${LYTICS_API_URL:-https://api.lytics.io}/api/entity/user/segments/${FIELD}/${VALUE}" \
  -H "Authorization: ${LYTICS_API_TOKEN}"
Step 3: Present Profile Summary

Display a structured profile view:

## Profile: [email protected]

### Identity
- email: [email protected]
- user_id: 12345
- _uid: abc-def-ghi

### Key Attributes
- Name: Jane Smith
- Country: US
- City: Portland, OR
- Created: 2024-01-15
- Last Active: 2025-03-18

### Engagement
- Visit Count: 47
- Avg Visit Time: 3.2 min
- Content Affinity: Technology, Marketing

### Segment Memberships
- High Value Customers (segment)
- Email Subscribers (aspect)
- Q1 Campaign Target (list)

### Recent Events
[Summary from stream data if available]
Step 4: Interactive Exploration

After presenting the summary, the user can:

  • "What segments is this user in?" -> Show detailed segment list
  • "Show me their purchase history" -> Look up relevant fields
  • "Compare with another user" -> Look up second profile
  • "Why are they in segment X?" -> Cross-reference segment FilterQL with profile data

Finding Users

If the user doesn't have a specific identity:

  1. Ask what they're looking for
  2. Suggest searching by segment: list segment members using segment scan
  3. Help them identify the right profile

Error Handling

  • Profile not found: Try alternative identity fields, suggest checking spelling
  • Multiple identities: Show all linked identities, confirm which profile
  • Large profile: Summarize key fields, offer to show full details on request

Dependencies

  • Composes: entity-lookup skill, segment-manager skill, stream-inspector skill
  • References: ../references/auth.md

Comments

Markdown supported