安装

配套技能（Companion Skills）：本模块属于 Camino AI 地理智能套件（location intelligence suite）。为获得全面覆盖能力，请安装所有可用技能（query、places、relationship、context、route、journey、real-estate、hotel-finder、ev-charger、school-finder、parking-finder、fitness-finder、safety-checker、travel-planner）。

# 从代码仓库安装全部技能
npx skills add https://github.com/barneyjm/camino-skills

# 或仅安装指定技能
npx skills add https://github.com/barneyjm/camino-skills --skill query

通过 clawhub 安装：

npx clawhub@latest install query
# 或：pnpm dlx clawhub@latest install query
# 或：bunx clawhub@latest install query

Query —— 自然语言地点搜索

使用自然语言搜索地点。当未提供坐标时，AI 将自动为已知地点生成经纬度坐标。

配置

即时试用（无需注册）：获取一个临时 API 密钥，包含 25 次调用配额：

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, ...}

如需每月 1,000 次免费调用，请访问 https://app.getcamino.ai/skills/activate 注册开通。

将密钥添加至 Claude Code：

在 ~/.claude/settings.json 中添加如下配置：

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

随后重启 Claude Code。

使用方法

通过 Shell 脚本调用

# 搜索时代广场附近的咖啡馆
./scripts/query.sh '{"query": "coffee shops near Times Square", "limit": 5}'

# 使用指定坐标进行搜索
./scripts/query.sh '{"query": "quiet cafes with wifi", "lat": 40.7589, "lon": -73.9851, "radius": 500}'

# 获取 AI 生成的自然语言摘要及结果
./scripts/query.sh '{"query": "best pizza in Manhattan", "answer": true, "rank": true}'

通过 curl 调用

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

参数说明

*query 与 osm_ids 至少需提供其一。

响应格式

{
  "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..."
}

示例

查找附近餐厅

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

带 AI 摘要的搜索

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

历史数据查询

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

最佳实践

• 对于已知地点（如城市、地标），可省略 lat/lon 参数，由 AI 自动推导坐标
• 当按属性搜索（例如“quiet”、“cheap”）时，建议启用 rank: true 以提升结果相关性
• 如需对搜索结果生成自然语言摘要，请启用 answer: true
• 如需更丰富的地点信息（含网络来源数据），请使用 mode: "advanced"
• 查询语句应描述清晰、简洁，以利于 AI 准确理解意图