concierge

# Travel Concierge

Find contact details (phone, email, WhatsApp, Instagram, etc.) for accommodation listings and place AI booking calls.

## Capabilities

### 1) Find contact details from a listing URL

```bash
concierge find-contact "<url>"
```

### 2) Place an autonomous phone call

```bash
concierge call "+1-555-123-4567" \
  --goal "Book a room for March 12-14" \
  --name "Derek Rein" \
  --email "alexanderderekrein@gmail.com" \
  --customer-phone "+1-555-000-1111" \
  --context "Prefer direct booking if rate beats Booking.com"
```

The `call` command now auto-manages infra by default: if local server is down, it starts `ngrok` + call server automatically and stops both when the call ends.

## Supported listing platforms

- **Airbnb**: `airbnb.com/rooms/...`
- **Booking.com**: `booking.com/hotel/...`
- **VRBO**: `vrbo.com/...`
- **Expedia**: `expedia.com/...Hotel...`

## Examples

### Find contacts for an Airbnb listing
Run:
```bash
concierge find-contact "https://www.airbnb.com/rooms/12345"
```

### Start a call and control turns manually
Run:
```bash
concierge call "+1-555-123-4567" \
  --goal "Negotiate a direct booking rate" \
  --name "Derek Rein" \
  --email "alexanderderekrein@gmail.com" \
  --customer-phone "+1-555-000-1111" \
  --interactive
```

### JSON output for scripting (contact lookup)
```bash
concierge find-contact --json "https://..."
```

### Verbose output
```bash
concierge --verbose find-contact "https://..."
```

## Configuration

The CLI stores configuration in:

`~/.config/concierge/config.json5`

### Optional for contact lookup

```bash
concierge config set googlePlacesApiKey "your-key"
```

### Required for AI phone calls

```bash
concierge config set twilioAccountSid "<sid>"
concierge config set twilioAuthToken "<token>"
concierge config set twilioPhoneNumber "+14155551234"
concierge config set deepgramApiKey "<key>"
concierge config set elevenLabsApiKey "<key>"
concierge config set elevenLabsVoiceId "EXAVITQu4vr4xnSDxMaL"
concierge c...

# Travel Concierge

Find accommodation contact details and place AI-powered booking calls.

## Installation

```bash
skill install @skillhq/concierge
```

## Features

- **Contact Extraction**: Find phone, email, WhatsApp, and social media contacts from Airbnb, Booking.com, VRBO, and Expedia listings
- **AI Phone Calls**: Place autonomous phone calls with a goal-driven AI agent that handles the conversation until the goal is achieved

## System Dependencies (AI Calls)

AI calls require local binaries in addition to API keys:

- `ffmpeg` (must include MP3 decode support)
- `ngrok` (used when `call` auto-starts infrastructure)

Install examples:

```bash
# macOS
brew install ffmpeg ngrok

# Ubuntu/Debian (including ARM VPS)
sudo apt-get update
sudo apt-get install -y ffmpeg
# install ngrok from ngrok docs, then verify `ngrok version`
```

Verify locally:

```bash
ffmpeg -version
ffmpeg -decoders | rg -i mp3
ngrok version
```

The call preflight now fails fast with a clear error if these dependencies are missing or if ffmpeg cannot decode MP3.

## Quick Start

### Find contacts for a listing

```bash
concierge find-contact "https://www.airbnb.com/rooms/12345"
```

### Place an AI booking call

```bash
concierge call "+1-555-123-4567" \
  --goal "Book a room for March 12-14" \
  --name "John Smith" \
  --email "john@example.com" \
  --customer-phone "+1-555-000-1111"
```

## Configuration

Configuration is stored in `~/.config/concierge/config.json5`.

### For contact lookup (optional)

```bash
concierge config set googlePlacesApiKey "your-key"
```

### For AI phone calls (required)

```bash
concierge config set twilioAccountSid "<sid>"
concierge config set twilioAuthToken "<token>"
concierge config set twilioPhoneNumber "+14155551234"
concierge config set deepgramApiKey "<key>"
concierge config set elevenLabsApiKey "<key>"
concierge config set elevenLabsVoiceId "EXAVITQu4vr4xnSDxMaL"
concierge config set anthropicApiKey "<key>"
```

## Documentation

See [SKILL.md](./S...