Hotel Finder Location

Search for hotels, hostels, and lodging near landmarks, conference venues, or neighborhoods using Camino AI's location intelligence with AI-powered ranking.

Security Scan

The skill's code, instructions, and requested credential (CAMINO_API_KEY) are coherent with a hotel-search integration that queries api.getcamino.ai; nothing requests unrelated credentials or system access.

Purpose & Capability

Name/description describe a location/hotel search service and the skill only requires an API key and issues queries to https://api.getcamino.ai; the requested CAMINO_API_KEY is appropriate for that purpose.

Instruction Scope

SKILL.md and the script limit actions to validating input, building a query, and calling the Camino API. No unrelated files, secrets, or system paths are read or transmitted beyond the declared CAMINO_API_KEY and an example ~/.claude/settings.json entry.

Install Mechanism

This is an instruction-only skill with a small shell script; there is no packaged install spec that downloads arbitrary archives. The README suggests using npx to add a GitHub repo — standard but the repo should be reviewed before running install commands.

Credentials

Only CAMINO_API_KEY is required and declared as the primary credential. The script uses that key solely to authenticate requests to the Camino API; no additional unrelated secrets or configuration paths are requested.

Persistence & Privilege

always is false and the skill does not request system-level changes or modify other skills. The skill can be invoked autonomously (platform default), which is expected for utility skills; this alone is not a red flag.

Assessment

This skill appears to do what it says: run a query against Camino's API using CAMINO_API_KEY. Before installing, confirm you trust the Camino API host (api.getcamino.ai) and the GitHub repo referenced in the install instructions. Treat CAMINO_API_KEY as a secret — prefer injecting it from a secure environment or secrets manager rather than storing plaintext in ~/.claude/settings.json. Ensure curl and jq are available locally. If you plan to allow autonomous invocation for agents, be aware the agent could call the Camino API using your key whenever the skill is used; restrict or monitor the key if needed.

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": "[e-mail]"}' \
  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