Back to Details

query

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

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.
bash
undefined
配套Skill：这是Camino AI位置智能套件的一部分。安装所有可用Skill（query、places、relationship、context、route、journey、real-estate、hotel-finder、ev-charger、school-finder、parking-finder、fitness-finder、safety-checker、travel-planner）以获得全面覆盖。
bash
undefined

Install all skills from repo

从仓库安装所有Skill

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

Or install specific skills

或安装特定Skill

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

**Via clawhub:**
```bash
npx clawhub@latest install query
npx skills add https://github.com/barneyjm/camino-skills --skill query

**通过clawhub安装：**
```bash
npx clawhub@latest install query

or: pnpm dlx clawhub@latest install query

或：pnpm dlx clawhub@latest install query

or: bunx clawhub@latest install query

或：bunx clawhub@latest install query

undefined
undefined

Query - Natural Language Place Search

Query - 自然语言地点搜索

Search for places using natural language. The AI automatically generates coordinates for known locations when not provided.
使用自然语言搜索地点。当未提供坐标时，AI会自动为已知地点生成坐标。

Setup

设置

Instant Trial (no signup required): Get a temporary API key with 25 calls:
bash
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
:
json
{
  "env": {
    "CAMINO_API_KEY": "your-api-key-here"
  }
}
Restart Claude Code.
即时试用（无需注册）：获取包含25次调用额度的临时API密钥：
bash
curl -s -X POST -H "Content-Type: application/json" \
  -d '{"email": "you@example.com"}' \
  https://api.getcamino.ai/trial/start
返回结果：
{"api_key": "camino-xxx...", "calls_remaining": 25, ...}
每月可获得1000次免费调用，前往https://app.getcamino.ai/skills/activate注册。
将密钥添加到Claude Code：
将密钥添加到你的
~/.claude/settings.json
文件中：
json
{
  "env": {
    "CAMINO_API_KEY": "your-api-key-here"
  }
}
重启Claude Code。

Usage

使用方法

Via Shell Script

通过Shell脚本

bash
undefined
bash
undefined

Search for coffee shops near Times Square

搜索时代广场附近的咖啡店

./scripts/query.sh '{"query": "coffee shops near Times Square", "limit": 5}'
./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}'
./scripts/query.sh '{"query": "quiet cafes with wifi", "lat": 40.7589, "lon": -73.9851, "radius": 500}'

Get AI-generated answer with results

获取包含结果的AI生成回答

./scripts/query.sh '{"query": "best pizza in Manhattan", "answer": true, "rank": true}'
undefined
./scripts/query.sh '{"query": "best pizza in Manhattan", "answer": true, "rank": true}'
undefined

Via curl

通过curl

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

Parameters

参数

ParameterTypeRequiredDefaultDescription
querystringYes*-Natural language query (e.g., "coffee shops near Times Square")
latfloatNo-Latitude for search center. AI generates if omitted for known locations.
lonfloatNo-Longitude for search center. AI generates if omitted for known locations.
radiusintNo1000Search radius in meters (100-50000)
rankboolNotrueUse AI to rank results by relevance
limitintNo20Maximum results (1-100)
offsetintNo0Pagination offset
answerboolNofalseGenerate human-readable summary
timestringNo-Temporal query: "2020-01-01", "2020..", or "2020..2024"
osm_idsstringNo-Comma-separated OSM IDs (e.g., "node/123,way/456")
modestringNo"basic""basic" (OSM only) or "advanced" (web enrichment)
*Either 
query
or 
osm_ids
is required.
参数类型是否必填默认值描述
query字符串是*-自然语言查询（例如："coffee shops near Times Square"）
lat浮点数否-搜索中心点纬度。若为已知地点，可省略该参数，由AI自动生成坐标。
lon浮点数否-搜索中心点经度。若为已知地点，可省略该参数，由AI自动生成坐标。
radius整数否1000搜索半径（单位：米，范围100-50000）
rank布尔值否true使用AI按相关性对结果排序
limit整数否20最大返回结果数（范围1-100）
offset整数否0分页偏移量
answer布尔值否false生成人类可读的结果摘要
time字符串否-时间范围查询：格式为"2020-01-01"、"2020.."或"2020..2024"
osm_ids字符串否-逗号分隔的OSM ID（例如："node/123,way/456"）
mode字符串否"basic""basic"（仅使用OSM数据）或"advanced"（结合网络补充数据）
*
query
或
osm_ids
二者必填其一。

Response Format

响应格式

json
{
  "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,
    "has_more": true
  },
  "answer": "I found several quiet coffee shops with wifi near Times Square..."
}
json
{
  "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,
    "has_more": true
  },
  "answer": "I found several quiet coffee shops with wifi near Times Square..."
}

Examples

示例

Find nearby restaurants

查找附近餐厅

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

Search with AI answer

搜索并获取AI生成的回答

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

Historical data query

历史数据查询

bash
./scripts/query.sh '{"query": "restaurants", "lat": 40.7589, "lon": -73.9851, "time": "2020-01-01"}'
bash
./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
  • 对于已知地点（城市、地标），可省略lat/lon参数，由AI自动生成坐标
  • 当按属性（如"安静"、"便宜"）搜索时，设置
    rank: true
    可获得更相关的结果
  • 当需要结果的自然语言摘要时，启用
    answer: true
  • 使用
    mode: "advanced"
    可获取来自网络来源的更丰富地点数据
  • 保持查询描述性但简洁，以获得最佳AI解析效果