@skillhq/travel-concierge

Travel Concierge

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

Installation

skill install @skillhq/travel-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:

# 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:

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

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

Place an AI booking call

travel-concierge call "[phone]" \
  --goal "Book a room for March 12-14" \
  --name "John Smith" \
  --email "[e-mail]" \
  --customer-phone "[phone]"

Configuration

Configuration is stored in ~/.config/travel-concierge/config.json5.

For contact lookup (optional)

travel-concierge config set googlePlacesApiKey "your-key"

For AI phone calls (required)

travel-concierge config set twilioAccountSid "<sid>"
travel-concierge config set twilioAuthToken "<token>"
travel-concierge config set twilioPhoneNumber "[phone]"
travel-concierge config set deepgramApiKey "<key>"
travel-concierge config set elevenLabsApiKey "<key>"
travel-concierge config set elevenLabsVoiceId "EXAVITQu4vr4xnSDxMaL"
travel-concierge config set anthropicApiKey "<key>"

Documentation

See SKILL.md and CALL-SETUP.md for full setup and troubleshooting.

License

MIT