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".
Allowed Tools
Provided by Plugin
juicebox-pack
Claude Code skill pack for Juicebox (24 skills)
Installation
This skill is included in the juicebox-pack plugin:
/plugin install juicebox-pack@claude-code-plugins-plusClick to copy
Instructions
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
- API key from Dashboard > Settings > API Keys
- Node.js 18+ or Python 3.8+
Instructions
Step 1: Install SDK
npm install @juicebox/sdk
# or: pip install juicebox-sdk
Step 2: Configure Authentication
export JUICEBOX_API_KEY="jb_live_..."
echo 'JUICEBOX_API_KEY=jb_live_your-key' >> .env
Step 3: Verify Connection
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`);
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
Next Steps
After auth, proceed to juicebox-hello-world.