---
name: juicebox-hello-world
description: |
  Create a minimal Juicebox people search example.
  Trigger: "juicebox hello world", "first people search", "test juicebox".
allowed-tools: Read, Write, Edit, Bash(npm:*), Grep
version: 1.0.0
license: MIT
author: Jeremy Longshore <jeremy@intentsolutions.io>
tags: [saas, recruiting, juicebox]
compatible-with: claude-code
---

# Juicebox Hello World

## Overview
Three examples: natural language people search, profile enrichment, and contact data from 800M+ profiles.

## Instructions

### Example 1: Natural Language Search
```typescript
import { JuiceboxClient } from '@juicebox/sdk';
const client = new JuiceboxClient({ apiKey: process.env.JUICEBOX_API_KEY });

const results = await client.search({
  query: 'senior ML engineer at FAANG with PhD in Bay Area',
  limit: 10,
  filters: { experience_years: { min: 5 } }
});
results.profiles.forEach(p =>
  console.log(`${p.name} | ${p.title} at ${p.company} | ${p.location}`)
);
```

### Example 2: Profile Enrichment
```typescript
const enriched = await client.enrich({
  linkedin_url: 'https://linkedin.com/in/example',
  fields: ['skills', 'experience', 'education', 'contact']
});
console.log(`Skills: ${enriched.skills.join(', ')}`);
if (enriched.tech_profile?.github) {
  console.log(`GitHub: ${enriched.tech_profile.github.repos} repos`);
}
```

### Example 3: Contact Data (Python)
```python
results = client.search(query='PM fintech NYC', limit=5, include_contact=True)
for p in results.profiles:
    email = p.contact.email if p.contact else 'N/A'
    print(f"{p.name} | {p.title} | {email}")
```

## Error Handling
| Error | Cause | Solution |
|-------|-------|----------|
| Empty results | Query too narrow | Broaden terms or remove filters |
| Partial contact | Limited coverage | Not all profiles have contact data |

## Resources
- [Search API](https://docs.juicebox.work/api/search)
- [PeopleGPT](https://juicebox.ai/peoplegpt)

## Next Steps
Explore `juicebox-sdk-patterns` for production code.