Installation

Companion Skills: This is part of the Camino AI location intelligence suite. Install all available skills (query, places, relationship, context, route, journey, real-estate, hotel-finder, ev-charger, school-finder, parking-finder, fitness-finder, safety-checker, travel-planner) for comprehensive coverage.

Install all skills from repo

npx skills add https://github.com/barneyjm/camino-skills

Or install specific skills

npx skills add https://github.com/barneyjm/camino-skills --skill hotel-finder

Via clawhub:

npx clawhub@latest install hotel-finder

or: pnpm dlx clawhub@latest install hotel-finder

or: bunx clawhub@latest install hotel-finder

Hotel Finder

Search for hotels, hostels, and lodging near landmarks, conference venues, or neighborhoods. Results are AI-ranked for relevance and include a human-readable summary.

Setup

Instant Trial (no signup required): Get a temporary API key with 25 calls:

curl -s -X POST -H "Content-Type: application/json"
-d '{"email": "you@example.com"}'
https://api.getcamino.ai/trial/start

Returns: {"api_key": "camino-xxx...", "calls_remaining": 25, ...}

For 1,000 free calls/month, sign up at https://app.getcamino.ai/skills/activate.

Add your key to Claude Code:

Add to your ~/.claude/settings.json :

{ "env": { "CAMINO_API_KEY": "your-api-key-here" } }

Restart Claude Code.

Usage

Via Shell Script

Search for hotels near a landmark

./scripts/hotel-finder.sh '{"query": "hotels near the Eiffel Tower", "limit": 5}'

Search with specific coordinates

./scripts/hotel-finder.sh '{"query": "boutique hotels", "lat": 40.7589, "lon": -73.9851, "radius": 1000}'

Search for hostels in a city

./scripts/hotel-finder.sh '{"query": "hostels in Barcelona", "limit": 10}'

Via curl

curl -H "X-API-Key: $CAMINO_API_KEY"
"https://api.getcamino.ai/query?query=hotels+near+the+Eiffel+Tower&limit=5&rank=true&answer=true"

Parameters

Parameter Type Required Default Description

query string Yes

Natural language query (e.g., "hotels near Eiffel Tower")

lat float No

Latitude for search center. AI generates if omitted for known locations.

lon float No

Longitude for search center. AI generates if omitted for known locations.

radius int No 2000 Search radius in meters

limit int No 10 Maximum results (1-100)

Response Format

{ "query": "hotels near the Eiffel Tower", "results": [ { "name": "Hotel du Champ de Mars", "lat": 48.8555, "lon": 2.3005, "type": "hotel", "distance_m": 350, "relevance_score": 0.92, "address": "..." } ], "ai_ranked": true, "pagination": { "total_results": 15, "limit": 5, "offset": 0, "has_more": true }, "answer": "I found several hotels near the Eiffel Tower. The closest is..." }

Examples

Hotels near a conference venue

./scripts/hotel-finder.sh '{"query": "hotels near Moscone Center San Francisco", "limit": 10}'

Budget hostels in a city

./scripts/hotel-finder.sh '{"query": "hostels in Amsterdam", "radius": 3000, "limit": 15}'

Lodging near an airport

./scripts/hotel-finder.sh '{"query": "hotels near JFK airport", "radius": 5000}'

Best Practices

• Include the landmark or neighborhood in your query for best results without coordinates

• Use larger radius (3000-5000m) for suburban or airport searches

• Use smaller radius (500-1000m) for dense city centers

• Combine with the route skill to calculate travel times from hotels to your destination

• Combine with the context skill for a full neighborhood assessment around each hotel

• The AI ranking prioritizes proximity and relevance to your query intent