# Juicebox Install Auth

> Install and configure Juicebox PeopleGPT API authentication. Use when setting up people search or initializing Juicebox. Trigger: "install juicebox", "setup juicebox", "juicebox auth".

- Skill: `gabrielmoreira/juicebox-install-auth` (Agent Skill)
- Install (CLI): `npx skillmds@latest add gabrielmoreira/juicebox-install-auth`
- Raw SKILL.md: https://api.skillmd.com/api/skills/gabrielmoreira/juicebox-install-auth/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- License: MIT
- Author: gabrielmoreira (https://skillmd.com/u/gabrielmoreira)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/gabrielmoreira/juicebox-install-auth

---

# Juicebox Install & Auth

## Overview

Set up Juicebox PeopleGPT API for AI-powered people search across 800M+ professional profiles.

## Prerequisites

- Juicebox account at [app.juicebox.ai](https://app.juicebox.ai)
- API key from Dashboard > Settings > API Keys
- Node.js 18+ or Python 3.8+

## Instructions

### Step 1: Install SDK

```bash
npm install @juicebox/sdk
# or: pip install juicebox-sdk
```

### Step 2: Configure Authentication

```bash
export JUICEBOX_API_KEY="jb_live_..."
echo 'JUICEBOX_API_KEY=jb_live_your-key' >> .env
```

### Step 3: Verify Connection

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

const results = await client.search({ query: 'engineer', limit: 1 });
console.log(`Connected! ${results.total} profiles available`);
```

```python
from juicebox import JuiceboxClient
client = JuiceboxClient(api_key=os.environ['JUICEBOX_API_KEY'])
results = client.search(query='engineer', limit=1)
print(f'Connected! {results.total} profiles')
```

## Error Handling

| Error | Code | Solution |
|-------|------|----------|
| Invalid API key | 401 | Verify at app.juicebox.ai/settings |
| Plan limit exceeded | 403 | Upgrade plan or check quota |
| Rate limited | 429 | Check `Retry-After` header |

## Output

Produce a redacted authentication receipt with environment, secret-reference status, least-privilege scope, sandbox fixture classification, source/destination approval, suppression and `contacts_exported=0` checks, owner approval, and cleanup confirmation. Never include API keys, identities, or contact data.

## Examples

`env=staging; credential=secret-reference; scope=read-sandbox; fixture=synthetic; suppression=pass; contacts_exported=0; cleanup=verified` is a safe connection-check result.

## Resources

- [Juicebox Docs](https://docs.juicebox.work)
- [PeopleGPT](https://juicebox.ai/peoplegpt)

## Next Steps

After auth, proceed to `juicebox-hello-world`.