juicebox-hello-world

jeremylongshore's avatarfrom jeremylongshore

Create a minimal working Juicebox example.Use when getting started with Juicebox, creating your first search,or testing basic people search functionality.Trigger with phrases like "juicebox hello world", "first juicebox search","simple juicebox example", "test juicebox".

⭐939stars🔀114forks📁View on GitHub🕐Updated Jan 11, 2026
[Developer Tools]

When & Why to Use This Skill

This Claude skill provides a streamlined 'Hello World' template for the Juicebox SDK, enabling developers to quickly set up, authenticate, and execute their first AI-powered people search. It simplifies the onboarding process by providing ready-to-use TypeScript and Python code snippets for searching professional profiles, making it an essential starting point for integrating Juicebox AI into recruitment or lead generation workflows.

Use Cases

  • Initial Setup: Quickly verify Juicebox API credentials and environment configuration with a minimal, functional script.
  • Prototyping: Use the provided boilerplate code to jumpstart the development of custom talent sourcing or professional networking tools.
  • Query Testing: Experiment with different search parameters and filters, such as job titles and company names, to understand the API's response structure.
  • Educational Reference: Serve as a clear, documented example for developers learning how to interact with the Juicebox SDK in both Node.js and Python environments.
namejuicebox-hello-world
description|
allowed-toolsRead, Write, Edit, Bash(npm:*), Bash(pip:*), Grep
version1.0.0
licenseMIT
authorJeremy Longshore <jeremy@intentsolutions.io>

Juicebox Hello World

Overview

Create a minimal working example to search for people using Juicebox AI.

Prerequisites

  • Juicebox SDK installed (juicebox-install-auth completed)
  • Valid API key configured
  • Node.js or Python environment

Instructions

Step 1: Create Search Script

// search.ts
import { JuiceboxClient } from '@juicebox/sdk';

const client = new JuiceboxClient({
  apiKey: process.env.JUICEBOX_API_KEY
});

async function searchPeople() {
  const results = await client.search.people({
    query: 'software engineer at Google',
    limit: 5
  });

  console.log(`Found ${results.total} people`);
  results.profiles.forEach(profile => {
    console.log(`- ${profile.name} | ${profile.title} at ${profile.company}`);
  });
}

searchPeople();

npx ts-node search.ts

Step 3: Verify Output

Expected output:

Found 150 people
- Jane Smith | Senior Software Engineer at Google
- John Doe | Staff Engineer at Google
- ...

Output

  • Working search script
  • Console output with search results
  • Profile data including name, title, company

Error Handling

Error Cause Solution
Empty Results Query too specific Broaden search terms
Timeout Large result set Add limit parameter
Invalid Query Malformed syntax Check query format

Examples

Python Example

from juicebox import JuiceboxClient
import os

client = JuiceboxClient(api_key=os.environ.get('JUICEBOX_API_KEY'))

results = client.search.people(
    query='product manager in San Francisco',
    limit=10
)

for profile in results.profiles:
    print(f"- {profile.name} | {profile.title}")

const results = await client.search.people({
  query: 'senior engineer',
  filters: {
    location: 'New York',
    company_size: '1000+',
    experience_years: { min: 5 }
  },
  limit: 20
});

Resources

Next Steps

After your first search, explore juicebox-sdk-patterns for production-ready code.