SKILL.md
Juicebox Hello World
Overview
Three examples: natural language people search, profile enrichment, and contact data from 800M+ profiles.
Instructions
Example 1: Natural Language Search
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
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)
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 |
Prerequisites
- A sandbox workspace, synthetic prospects, documented source authority, approved destination, suppression policy, and deletion path for test artifacts.
Output
Return an onboarding receipt with workspace, source-authority result, input/accepted/quarantined counts, suppression result, destination, export-count assertion, retention date, and cleanup state. Do not include names, contact details, enrichment values, or credentials.
Examples
Run a synthetic prospect fixture and record workspace=hello-sandbox; source=approved; accepted=2; quarantined=0; suppression=pass; contacts_exported=0; cleanup=complete.
Resources
Next Steps
Explore juicebox-sdk-patterns for production code.