Integrations

CLI

The HumanConnection CLI lets you interact with the platform directly from your terminal. The primary command available today is humans search.

Installation

$npm install -g @humanconnection/cli

Command pattern

humanconnection [resource] <command> [flags]

Global flags

FlagDescription
--formatOutput format: json (default) or pretty

Search for a person and find their social profiles and location, or find people by location and title. This is the main working command in the CLI.

$humanconnection humans search \
>  --name "Brian Chesky" \
>  --company-name "Airbnb"

Flags (person lookup mode)

FlagRequiredDescription
--name <name>YesFull name of the person
--company-name <name>NoCompany name for disambiguation
--company-domain <domain>NoCompany domain for precise matching
--location <location>NoLocation to narrow results
--provide-emailNoInclude email in results

Flags (people search mode)

FlagRequiredDescription
--location <location>YesLocation to search in
--title-filters <filters>YesBoolean filter for titles (e.g. "sales AND SaaS")
--provide-emailNoInclude email addresses in results

Example output

1[
2  {
3    "name": "Brian Chesky",
4    "email": "brian@airbnb.com",
5    "company_domain": "airbnb.com",
6    "bio": "Co-Founder & CEO at Airbnb.",
7    "location": "San Francisco, CA",
8    "profiles": {
9      "linkedin_profile_url": "https://linkedin.com/in/brianchesky",
10      "x_profile_url": "https://x.com/bchesky",
11      "instagram_profile_url": "https://instagram.com/bchesky"
12    },
13    "confidence": 0.85
14  }
15]

More examples

$# Search by company name
$humanconnection humans search \
>  --name "Sara Blakely" \
>  --company-name "Spanx"
$
$# Search by company domain
$humanconnection humans search \
>  --name "David Solomon" \
>  --company-domain "goldmansachs.com"
$
$# Search with company and location
$humanconnection humans search \
>  --name "Melanie Perkins" \
>  --company-name "Canva" \
>  --location "Sydney"
$
$# Search with just a name
$humanconnection humans search --name "Elon Musk"
$
$# Get email address
$humanconnection humans search \
>  --name "Brian Chesky" \
>  --company-domain "airbnb.com" \
>  --provide-email
$
$# People search mode: find professionals by location and title
$humanconnection humans search \
>  --location "Austin" \
>  --title-filters "sales AND SaaS" \
>  --provide-email
$
$# Output as JSON (default)
$humanconnection humans search --name "Elon Musk" --format json

Search a person’s recent social activity for personal interests, hobbies, and conversation starters.

$humanconnection interests search \
>  --name "Brian Chesky" \
>  --linkedin-url "https://linkedin.com/in/brianchesky" \
>  --x-url "https://x.com/bchesky"

Flags

FlagRequiredDescription
--name <name>YesFull name of the person
--linkedin-url <url>NoLinkedIn profile URL
--x-url <url>NoX/Twitter profile URL
--instagram-url <url>NoInstagram profile URL

Using with jq

Pipe CLI output to jq for programmatic access:

$# Get just the LinkedIn URL
$humanconnection humans search \
>  --name "Brian Chesky" \
>  --company-name "Airbnb" \
>  --format json | jq -r '.[0].profiles.linkedin_profile_url'
$
$# Get the confidence score
$humanconnection humans search \
>  --name "Brian Chesky" \
>  --company-name "Airbnb" \
>  --format json | jq '.[0].confidence'
$
$# Get email
$humanconnection humans search \
>  --name "Brian Chesky" \
>  --company-domain "airbnb.com" \
>  --provide-email \
>  --format json | jq -r '.[0].email'

Scripting example

$#!/bin/bash
$# Find social profiles for a list of people
$
$PEOPLE=(
>  "Brian Chesky|Airbnb"
>  "Sara Blakely|Spanx"
>  "Melanie Perkins|Canva"
>)
$
$for entry in "${PEOPLE[@]}"; do
$  IFS='|' read -r name company <<< "$entry"
$  echo "=== $name ==="
$  humanconnection humans search --name "$name" --company-name "$company" --format json | jq '.[] | {name, location, confidence, linkedin: .profiles.linkedin_profile_url}'
$  echo
$done

Next steps

MCP Server

Integrate with AI agents via MCP.

Skills

Install as a skill for coding assistants.