query

name	query
description	Search for places using natural language with Camino AI's location intelligence API. Returns relevant results with coordinates, distances, and metadata. Use when you need to find real-world locations like restaurants, shops, landmarks, or any point of interest.
metadata	{"clawdbot":{"emoji":"🔍","requires":{"env":["CAMINO_API_KEY"]},"primaryEnv":"CAMINO_API_KEY"}}

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 query

Via clawhub:

npx clawhub@latest install query
# or: pnpm dlx clawhub@latest install query
# or: bunx clawhub@latest install query

Query - Natural Language Place Search

Search for places using natural language. The AI automatically generates coordinates for known locations when not provided.

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 coffee shops near Times Square
./scripts/query.sh '{"query": "coffee shops near Times Square", "limit": 5}'

# Search with specific coordinates
./scripts/query.sh '{"query": "quiet cafes with wifi", "lat": 40.7589, "lon": -73.9851, "radius": 500}'

# Get AI-generated answer with results
./scripts/query.sh '{"query": "best pizza in Manhattan", "answer": true, "rank": true}'

Via curl

curl -H "X-API-Key: $CAMINO_API_KEY" \
  "https://api.getcamino.ai/query?query=coffee+shops+near+Times+Square&limit=5"

Parameters

Parameter	Type	Required	Default	Description
query	string	Yes*	-	Natural language query (e.g., "coffee shops near Times Square")
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	1000	Search radius in meters (100-50000)
rank	bool	No	true	Use AI to rank results by relevance
limit	int	No	20	Maximum results (1-100)
offset	int	No	0	Pagination offset
answer	bool	No	false	Generate human-readable summary
time	string	No	-	Temporal query: "2020-01-01", "2020..", or "2020..2024"
osm_ids	string	No	-	Comma-separated OSM IDs (e.g., "node/123,way/456")
mode	string	No	"basic"	"basic" (OSM only) or "advanced" (web enrichment)

*Either query or osm_ids is required.

Response Format

{
  "query": "quiet coffee shops with wifi",
  "results": [
    {
      "name": "Blue Bottle Coffee",
      "lat": 40.7601,
      "lon": -73.9847,
      "type": "cafe",
      "distance_m": 150,
      "relevance_score": 0.95,
      "address": "..."
    }
  ],
  "ai_ranked": true,
  "pagination": {
    "total_results": 23,
    "limit": 5,
    "offset": 0
     
  
   

Examples

Find nearby restaurants

./scripts/query.sh '{"query": "Italian restaurants", "lat": 40.7128, "lon": -74.0060, "limit": 10}'

Search with AI answer

./scripts/query.sh '{"query": "best brunch spots in Brooklyn", "answer": true}'

Historical data query

./scripts/query.sh '{"query": "restaurants", "lat": 40.7589, "lon": -73.9851, "time": "2020-01-01"}'

Best Practices

• For known locations (cities, landmarks), you can omit lat/lon and let the AI generate coordinates
• Use rank: true for more relevant results when searching by attributes (e.g., "quiet", "cheap")
• Enable answer: true when you need a natural language summary of results
• Use mode: "advanced" for richer place data from web sources
• Keep queries descriptive but concise for best AI interpretation