{"id":"db9722b8-49da-4c14-a8be-a142dcdac7fc","entityType":"agent","slug":"clawhub-barneyjm-query","name":"Query","canonicalUrl":"https://www.xpersona.co/agent/clawhub-barneyjm-query","canonicalPath":"/agent/clawhub-barneyjm-query","generatedAt":"2026-10-10T03:52:29.561Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-09T18:27:08.151Z","emptyReason":null},"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. Skill: Query Owner: barneyjm Summary: 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. Tags: latest:2.0.0 Version history: v2.0.0 | 2026-02-08T03:09:55.062Z | auto Version 2.0.0 (query) - Added instant trial","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 2.1K downloads reported by the source. Last updated 10/9/2026.","installCommand":"clawhub skill install s175g00ed7n2ej0r13jbm8m3k18842ww:query","sourceUrl":"https://clawhub.ai/barneyjm/query","homepage":"https://clawhub.ai/barneyjm/skills/query","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/barneyjm/query","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/barneyjm/skills/query","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":67,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Search for places using natural language with Camino AI's location intelligence API. Returns relevant results with coordinates, distances, and metadata. Use whe"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-09T18:27:08.151Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T18:27:08.151Z","emptyReason":null},"stars":null,"forks":null,"downloads":2133,"packageName":null,"latestVersion":"2.0.0","tractionLabel":"2.1K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T18:27:08.150Z","emptyReason":null},"lastUpdatedAt":"2026-10-09T18:27:08.151Z","lastCrawledAt":"2026-10-09T18:27:08.150Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-10T18:27:08.150Z","lastVerifiedAt":null,"highlights":[{"version":"2.0.0","createdAt":"2026-02-08T03:09:55.062Z","changelog":"Version 2.0.0 (query) - Added instant trial option: get a temporary API key with 25 free calls, no signup required. - Clarified signup steps with a direct link for 1,000 free calls/month. - Expanded suggested companion skill list to include new skills (real-estate, hotel-finder, ev-charger, school-finder, parking-finder, fitness-finder, safety-checker, travel-planner). - Updated setup instructions with clearer steps for both quick trial and full signup. - Documentation improvements for ease of use and onboarding.","fileCount":3,"zipByteSize":3680},{"version":"0.1.2","createdAt":"2026-02-03T15:16:41.629Z","changelog":"- Added a new \"Installation\" section with instructions for installing the skill via skills repo or clawhub. - Mentioned query as part of the Camino AI suite, with info about related skills. - No changes to API usage or parameters. User workflow and guidance remain unchanged.","fileCount":3,"zipByteSize":3432},{"version":"0.1.1","createdAt":"2026-01-31T16:46:54.760Z","changelog":"- Added a metadata field to SKILL.md with emoji and environment variable requirements. - No user-facing functionality changes. Documentation update only.","fileCount":3,"zipByteSize":3217},{"version":"0.1.0","createdAt":"2026-01-31T16:34:24.040Z","changelog":"- Initial release of the Query skill for natural language place search using Camino AI's location intelligence API. - Supports searching for real-world locations (restaurants, shops, landmarks) with coordinates, distances, and metadata. - Allows both shell script and curl-based queries; integrates API key setup guidance. - Offers advanced options: relevance ranking, AI-generated answers, temporal queries, pagination, and selectable enrichment modes. - Returns structured results with support for human-readable summaries and OpenStreetMap enrichment.","fileCount":3,"zipByteSize":3155}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s175g00ed7n2ej0r13jbm8m3k18842ww:query","setupComplexity":"low","setupSteps":["Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-barneyjm-query/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-barneyjm-query/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-barneyjm-query/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-barneyjm-query/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-barneyjm-query/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-barneyjm-query/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-10T03:52:29.561Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-barneyjm-query/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-barneyjm-query/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-barneyjm-query/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-barneyjm-query/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-09T18:27:08.151Z","emptyReason":null},"readme":"Skill: Query\n\nOwner: barneyjm\n\nSummary: 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.\n\nTags: latest:2.0.0\n\nVersion history:\n\nv2.0.0 | 2026-02-08T03:09:55.062Z | auto\n\nVersion 2.0.0 (query)\n\n- Added instant trial option: get a temporary API key with 25 free calls, no signup required.\n- Clarified signup steps with a direct link for 1,000 free calls/month.\n- Expanded suggested companion skill list to include new skills (real-estate, hotel-finder, ev-charger, school-finder, parking-finder, fitness-finder, safety-checker, travel-planner).\n- Updated setup instructions with clearer steps for both quick trial and full signup.\n- Documentation improvements for ease of use and onboarding.\n\nv0.1.2 | 2026-02-03T15:16:41.629Z | auto\n\n- Added a new \"Installation\" section with instructions for installing the skill via skills repo or clawhub.\n- Mentioned query as part of the Camino AI suite, with info about related skills.\n- No changes to API usage or parameters. User workflow and guidance remain unchanged.\n\nv0.1.1 | 2026-01-31T16:46:54.760Z | auto\n\n- Added a metadata field to SKILL.md with emoji and environment variable requirements.\n- No user-facing functionality changes. Documentation update only.\n\nv0.1.0 | 2026-01-31T16:34:24.040Z | auto\n\n- Initial release of the Query skill for natural language place search using Camino AI's location intelligence API.\n- Supports searching for real-world locations (restaurants, shops, landmarks) with coordinates, distances, and metadata.\n- Allows both shell script and curl-based queries; integrates API key setup guidance.\n- Offers advanced options: relevance ranking, AI-generated answers, temporal queries, pagination, and selectable enrichment modes.\n- Returns structured results with support for human-readable summaries and OpenStreetMap enrichment.\n\nArchive index:\n\nArchive v2.0.0: 3 files, 3680 bytes\n\nFiles: scripts/query.sh (3043b), SKILL.md (4780b), _meta.json (124b)\n\nFile v2.0.0:SKILL.md\n\n---\nname: query\ndescription: \"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.\"\nmetadata: {\"clawdbot\":{\"emoji\":\"🔍\",\"requires\":{\"env\":[\"CAMINO_API_KEY\"]},\"primaryEnv\":\"CAMINO_API_KEY\"}}\n---\n\n## Installation\n\n**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.\n\n```bash\n# Install all skills from repo\nnpx skills add https://github.com/barneyjm/camino-skills\n\n# Or install specific skills\nnpx skills add https://github.com/barneyjm/camino-skills --skill query\n```\n\n**Via clawhub:**\n```bash\nnpx clawhub@latest install query\n# or: pnpm dlx clawhub@latest install query\n# or: bunx clawhub@latest install query\n```\n\n# Query - Natural Language Place Search\n\nSearch for places using natural language. The AI automatically generates coordinates for known locations when not provided.\n\n## Setup\n\n**Instant Trial (no signup required):** Get a temporary API key with 25 calls:\n\n```bash\ncurl -s -X POST -H \"Content-Type: application/json\" \\\n  -d '{\"email\": \"you@example.com\"}' \\\n  https://api.getcamino.ai/trial/start\n```\n\nReturns: `{\"api_key\": \"camino-xxx...\", \"calls_remaining\": 25, ...}`\n\nFor 1,000 free calls/month, sign up at [https://app.getcamino.ai/skills/activate](https://app.getcamino.ai/skills/activate).\n\n**Add your key to Claude Code:**\n\nAdd to your `~/.claude/settings.json`:\n\n```json\n{\n  \"env\": {\n    \"CAMINO_API_KEY\": \"your-api-key-here\"\n  }\n}\n```\n\nRestart Claude Code.\n\n## Usage\n\n### Via Shell Script\n\n```bash\n# Search for coffee shops near Times Square\n./scripts/query.sh '{\"query\": \"coffee shops near Times Square\", \"limit\": 5}'\n\n# Search with specific coordinates\n./scripts/query.sh '{\"query\": \"quiet cafes with wifi\", \"lat\": 40.7589, \"lon\": -73.9851, \"radius\": 500}'\n\n# Get AI-generated answer with results\n./scripts/query.sh '{\"query\": \"best pizza in Manhattan\", \"answer\": true, \"rank\": true}'\n```\n\n### Via curl\n\n```bash\ncurl -H \"X-API-Key: $CAMINO_API_KEY\" \\\n  \"https://api.getcamino.ai/query?query=coffee+shops+near+Times+Square&limit=5\"\n```\n\n## Parameters\n\n| Parameter | Type | Required | Default | Description |\n|-----------|------|----------|---------|-------------|\n| query | string | Yes* | - | Natural language query (e.g., \"coffee shops near Times Square\") |\n| lat | float | No | - | Latitude for search center. AI generates if omitted for known locations. |\n| lon | float | No | - | Longitude for search center. AI generates if omitted for known locations. |\n| radius | int | No | 1000 | Search radius in meters (100-50000) |\n| rank | bool | No | true | Use AI to rank results by relevance |\n| limit | int | No | 20 | Maximum results (1-100) |\n| offset | int | No | 0 | Pagination offset |\n| answer | bool | No | false | Generate human-readable summary |\n| time | string | No | - | Temporal query: \"2020-01-01\", \"2020..\", or \"2020..2024\" |\n| osm_ids | string | No | - | Comma-separated OSM IDs (e.g., \"node/123,way/456\") |\n| mode | string | No | \"basic\" | \"basic\" (OSM only) or \"advanced\" (web enrichment) |\n\n*Either `query` or `osm_ids` is required.\n\n## Response Format\n\n```json\n{\n  \"query\": \"quiet coffee shops with wifi\",\n  \"results\": [\n    {\n      \"name\": \"Blue Bottle Coffee\",\n      \"lat\": 40.7601,\n      \"lon\": -73.9847,\n      \"type\": \"cafe\",\n      \"distance_m\": 150,\n      \"relevance_score\": 0.95,\n      \"address\": \"...\"\n    }\n  ],\n  \"ai_ranked\": true,\n  \"pagination\": {\n    \"total_results\": 23,\n    \"limit\": 5,\n    \"offset\": 0,\n    \"has_more\": true\n  },\n  \"answer\": \"I found several quiet coffee shops with wifi near Times Square...\"\n}\n```\n\n## Examples\n\n### Find nearby restaurants\n```bash\n./scripts/query.sh '{\"query\": \"Italian restaurants\", \"lat\": 40.7128, \"lon\": -74.0060, \"limit\": 10}'\n```\n\n### Search with AI answer\n```bash\n./scripts/query.sh '{\"query\": \"best brunch spots in Brooklyn\", \"answer\": true}'\n```\n\n### Historical data query\n```bash\n./scripts/query.sh '{\"query\": \"restaurants\", \"lat\": 40.7589, \"lon\": -73.9851, \"time\": \"2020-01-01\"}'\n```\n\n## Best Practices\n\n- For known locations (cities, landmarks), you can omit lat/lon and let the AI generate coordinates\n- Use `rank: true` for more relevant results when searching by attributes (e.g., \"quiet\", \"cheap\")\n- Enable `answer: true` when you need a natural language summary of results\n- Use `mode: \"advanced\"` for richer place data from web sources\n- Keep queries descriptive but concise for best AI interpretation\n\nFile v2.0.0:_meta.json\n\n{\n  \"ownerId\": \"kn7e3j3w1x5et0yppacy4m90y18084ba\",\n  \"slug\": \"query\",\n  \"version\": \"2.0.0\",\n  \"publishedAt\": 1770520195062\n}\n\nArchive v0.1.2: 3 files, 3432 bytes\n\nFiles: scripts/query.sh (3043b), SKILL.md (4284b), _meta.json (124b)\n\nFile v0.1.2:SKILL.md\n\n---\nname: query\ndescription: \"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.\"\nmetadata: {\"clawdbot\":{\"emoji\":\"🔍\",\"requires\":{\"env\":[\"CAMINO_API_KEY\"]},\"primaryEnv\":\"CAMINO_API_KEY\"}}\n---\n\n## Installation\n\n**Companion Skills**: This is part of the Camino AI location intelligence suite. Install all 6 skills (query, places, relationship, context, route, journey) for comprehensive coverage.\n\n```bash\n# Install all skills from repo\nnpx skills add https://github.com/barneyjm/camino-skills\n\n# Or install specific skills\nnpx skills add https://github.com/barneyjm/camino-skills --skill query\n```\n\n**Via clawhub:**\n```bash\nnpx clawhub@latest install query\n# or: pnpm dlx clawhub@latest install query\n# or: bunx clawhub@latest install query\n```\n\n# Query - Natural Language Place Search\n\nSearch for places using natural language. The AI automatically generates coordinates for known locations when not provided.\n\n## Setup\n\n1. Get your API key from [https://app.getcamino.ai](https://app.getcamino.ai)\n2. Add to your `~/.claude/settings.json`:\n\n```json\n{\n  \"env\": {\n    \"CAMINO_API_KEY\": \"your-api-key-here\"\n  }\n}\n```\n\n3. Restart Claude Code\n\n## Usage\n\n### Via Shell Script\n\n```bash\n# Search for coffee shops near Times Square\n./scripts/query.sh '{\"query\": \"coffee shops near Times Square\", \"limit\": 5}'\n\n# Search with specific coordinates\n./scripts/query.sh '{\"query\": \"quiet cafes with wifi\", \"lat\": 40.7589, \"lon\": -73.9851, \"radius\": 500}'\n\n# Get AI-generated answer with results\n./scripts/query.sh '{\"query\": \"best pizza in Manhattan\", \"answer\": true, \"rank\": true}'\n```\n\n### Via curl\n\n```bash\ncurl -H \"X-API-Key: $CAMINO_API_KEY\" \\\n  \"https://api.getcamino.ai/query?query=coffee+shops+near+Times+Square&limit=5\"\n```\n\n## Parameters\n\n| Parameter | Type | Required | Default | Description |\n|-----------|------|----------|---------|-------------|\n| query | string | Yes* | - | Natural language query (e.g., \"coffee shops near Times Square\") |\n| lat | float | No | - | Latitude for search center. AI generates if omitted for known locations. |\n| lon | float | No | - | Longitude for search center. AI generates if omitted for known locations. |\n| radius | int | No | 1000 | Search radius in meters (100-50000) |\n| rank | bool | No | true | Use AI to rank results by relevance |\n| limit | int | No | 20 | Maximum results (1-100) |\n| offset | int | No | 0 | Pagination offset |\n| answer | bool | No | false | Generate human-readable summary |\n| time | string | No | - | Temporal query: \"2020-01-01\", \"2020..\", or \"2020..2024\" |\n| osm_ids | string | No | - | Comma-separated OSM IDs (e.g., \"node/123,way/456\") |\n| mode | string | No | \"basic\" | \"basic\" (OSM only) or \"advanced\" (web enrichment) |\n\n*Either `query` or `osm_ids` is required.\n\n## Response Format\n\n```json\n{\n  \"query\": \"quiet coffee shops with wifi\",\n  \"results\": [\n    {\n      \"name\": \"Blue Bottle Coffee\",\n      \"lat\": 40.7601,\n      \"lon\": -73.9847,\n      \"type\": \"cafe\",\n      \"distance_m\": 150,\n      \"relevance_score\": 0.95,\n      \"address\": \"...\"\n    }\n  ],\n  \"ai_ranked\": true,\n  \"pagination\": {\n    \"total_results\": 23,\n    \"limit\": 5,\n    \"offset\": 0,\n    \"has_more\": true\n  },\n  \"answer\": \"I found several quiet coffee shops with wifi near Times Square...\"\n}\n```\n\n## Examples\n\n### Find nearby restaurants\n```bash\n./scripts/query.sh '{\"query\": \"Italian restaurants\", \"lat\": 40.7128, \"lon\": -74.0060, \"limit\": 10}'\n```\n\n### Search with AI answer\n```bash\n./scripts/query.sh '{\"query\": \"best brunch spots in Brooklyn\", \"answer\": true}'\n```\n\n### Historical data query\n```bash\n./scripts/query.sh '{\"query\": \"restaurants\", \"lat\": 40.7589, \"lon\": -73.9851, \"time\": \"2020-01-01\"}'\n```\n\n## Best Practices\n\n- For known locations (cities, landmarks), you can omit lat/lon and let the AI generate coordinates\n- Use `rank: true` for more relevant results when searching by attributes (e.g., \"quiet\", \"cheap\")\n- Enable `answer: true` when you need a natural language summary of results\n- Use `mode: \"advanced\"` for richer place data from web sources\n- Keep queries descriptive but concise for best AI interpretation\n\nFile v0.1.2:_meta.json\n\n{\n  \"ownerId\": \"kn7e3j3w1x5et0yppacy4m90y18084ba\",\n  \"slug\": \"query\",\n  \"version\": \"0.1.2\",\n  \"publishedAt\": 1770131801629\n}\n\nArchive v0.1.1: 3 files, 3217 bytes\n\nFiles: scripts/query.sh (3043b), SKILL.md (3732b), _meta.json (124b)\n\nFile v0.1.1:SKILL.md\n\n---\nname: query\ndescription: \"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.\"\nmetadata: {\"clawdbot\":{\"emoji\":\"🔍\",\"requires\":{\"env\":[\"CAMINO_API_KEY\"]},\"primaryEnv\":\"CAMINO_API_KEY\"}}\n---\n\n# Query - Natural Language Place Search\n\nSearch for places using natural language. The AI automatically generates coordinates for known locations when not provided.\n\n## Setup\n\n1. Get your API key from [https://app.getcamino.ai](https://app.getcamino.ai)\n2. Add to your `~/.claude/settings.json`:\n\n```json\n{\n  \"env\": {\n    \"CAMINO_API_KEY\": \"your-api-key-here\"\n  }\n}\n```\n\n3. Restart Claude Code\n\n## Usage\n\n### Via Shell Script\n\n```bash\n# Search for coffee shops near Times Square\n./scripts/query.sh '{\"query\": \"coffee shops near Times Square\", \"limit\": 5}'\n\n# Search with specific coordinates\n./scripts/query.sh '{\"query\": \"quiet cafes with wifi\", \"lat\": 40.7589, \"lon\": -73.9851, \"radius\": 500}'\n\n# Get AI-generated answer with results\n./scripts/query.sh '{\"query\": \"best pizza in Manhattan\", \"answer\": true, \"rank\": true}'\n```\n\n### Via curl\n\n```bash\ncurl -H \"X-API-Key: $CAMINO_API_KEY\" \\\n  \"https://api.getcamino.ai/query?query=coffee+shops+near+Times+Square&limit=5\"\n```\n\n## Parameters\n\n| Parameter | Type | Required | Default | Description |\n|-----------|------|----------|---------|-------------|\n| query | string | Yes* | - | Natural language query (e.g., \"coffee shops near Times Square\") |\n| lat | float | No | - | Latitude for search center. AI generates if omitted for known locations. |\n| lon | float | No | - | Longitude for search center. AI generates if omitted for known locations. |\n| radius | int | No | 1000 | Search radius in meters (100-50000) |\n| rank | bool | No | true | Use AI to rank results by relevance |\n| limit | int | No | 20 | Maximum results (1-100) |\n| offset | int | No | 0 | Pagination offset |\n| answer | bool | No | false | Generate human-readable summary |\n| time | string | No | - | Temporal query: \"2020-01-01\", \"2020..\", or \"2020..2024\" |\n| osm_ids | string | No | - | Comma-separated OSM IDs (e.g., \"node/123,way/456\") |\n| mode | string | No | \"basic\" | \"basic\" (OSM only) or \"advanced\" (web enrichment) |\n\n*Either `query` or `osm_ids` is required.\n\n## Response Format\n\n```json\n{\n  \"query\": \"quiet coffee shops with wifi\",\n  \"results\": [\n    {\n      \"name\": \"Blue Bottle Coffee\",\n      \"lat\": 40.7601,\n      \"lon\": -73.9847,\n      \"type\": \"cafe\",\n      \"distance_m\": 150,\n      \"relevance_score\": 0.95,\n      \"address\": \"...\"\n    }\n  ],\n  \"ai_ranked\": true,\n  \"pagination\": {\n    \"total_results\": 23,\n    \"limit\": 5,\n    \"offset\": 0,\n    \"has_more\": true\n  },\n  \"answer\": \"I found several quiet coffee shops with wifi near Times Square...\"\n}\n```\n\n## Examples\n\n### Find nearby restaurants\n```bash\n./scripts/query.sh '{\"query\": \"Italian restaurants\", \"lat\": 40.7128, \"lon\": -74.0060, \"limit\": 10}'\n```\n\n### Search with AI answer\n```bash\n./scripts/query.sh '{\"query\": \"best brunch spots in Brooklyn\", \"answer\": true}'\n```\n\n### Historical data query\n```bash\n./scripts/query.sh '{\"query\": \"restaurants\", \"lat\": 40.7589, \"lon\": -73.9851, \"time\": \"2020-01-01\"}'\n```\n\n## Best Practices\n\n- For known locations (cities, landmarks), you can omit lat/lon and let the AI generate coordinates\n- Use `rank: true` for more relevant results when searching by attributes (e.g., \"quiet\", \"cheap\")\n- Enable `answer: true` when you need a natural language summary of results\n- Use `mode: \"advanced\"` for richer place data from web sources\n- Keep queries descriptive but concise for best AI interpretation\n\nFile v0.1.1:_meta.json\n\n{\n  \"ownerId\": \"kn7e3j3w1x5et0yppacy4m90y18084ba\",\n  \"slug\": \"query\",\n  \"version\": \"0.1.1\",\n  \"publishedAt\": 1769878014760\n}\n\nArchive v0.1.0: 3 files, 3155 bytes\n\nFiles: scripts/query.sh (3043b), SKILL.md (3624b), _meta.json (124b)\n\nFile v0.1.0:SKILL.md\n\n---\nname: query\ndescription: \"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.\"\n---\n\n# Query - Natural Language Place Search\n\nSearch for places using natural language. The AI automatically generates coordinates for known locations when not provided.\n\n## Setup\n\n1. Get your API key from [https://app.getcamino.ai](https://app.getcamino.ai)\n2. Add to your `~/.claude/settings.json`:\n\n```json\n{\n  \"env\": {\n    \"CAMINO_API_KEY\": \"your-api-key-here\"\n  }\n}\n```\n\n3. Restart Claude Code\n\n## Usage\n\n### Via Shell Script\n\n```bash\n# Search for coffee shops near Times Square\n./scripts/query.sh '{\"query\": \"coffee shops near Times Square\", \"limit\": 5}'\n\n# Search with specific coordinates\n./scripts/query.sh '{\"query\": \"quiet cafes with wifi\", \"lat\": 40.7589, \"lon\": -73.9851, \"radius\": 500}'\n\n# Get AI-generated answer with results\n./scripts/query.sh '{\"query\": \"best pizza in Manhattan\", \"answer\": true, \"rank\": true}'\n```\n\n### Via curl\n\n```bash\ncurl -H \"X-API-Key: $CAMINO_API_KEY\" \\\n  \"https://api.getcamino.ai/query?query=coffee+shops+near+Times+Square&limit=5\"\n```\n\n## Parameters\n\n| Parameter | Type | Required | Default | Description |\n|-----------|------|----------|---------|-------------|\n| query | string | Yes* | - | Natural language query (e.g., \"coffee shops near Times Square\") |\n| lat | float | No | - | Latitude for search center. AI generates if omitted for known locations. |\n| lon | float | No | - | Longitude for search center. AI generates if omitted for known locations. |\n| radius | int | No | 1000 | Search radius in meters (100-50000) |\n| rank | bool | No | true | Use AI to rank results by relevance |\n| limit | int | No | 20 | Maximum results (1-100) |\n| offset | int | No | 0 | Pagination offset |\n| answer | bool | No | false | Generate human-readable summary |\n| time | string | No | - | Temporal query: \"2020-01-01\", \"2020..\", or \"2020..2024\" |\n| osm_ids | string | No | - | Comma-separated OSM IDs (e.g., \"node/123,way/456\") |\n| mode | string | No | \"basic\" | \"basic\" (OSM only) or \"advanced\" (web enrichment) |\n\n*Either `query` or `osm_ids` is required.\n\n## Response Format\n\n```json\n{\n  \"query\": \"quiet coffee shops with wifi\",\n  \"results\": [\n    {\n      \"name\": \"Blue Bottle Coffee\",\n      \"lat\": 40.7601,\n      \"lon\": -73.9847,\n      \"type\": \"cafe\",\n      \"distance_m\": 150,\n      \"relevance_score\": 0.95,\n      \"address\": \"...\"\n    }\n  ],\n  \"ai_ranked\": true,\n  \"pagination\": {\n    \"total_results\": 23,\n    \"limit\": 5,\n    \"offset\": 0,\n    \"has_more\": true\n  },\n  \"answer\": \"I found several quiet coffee shops with wifi near Times Square...\"\n}\n```\n\n## Examples\n\n### Find nearby restaurants\n```bash\n./scripts/query.sh '{\"query\": \"Italian restaurants\", \"lat\": 40.7128, \"lon\": -74.0060, \"limit\": 10}'\n```\n\n### Search with AI answer\n```bash\n./scripts/query.sh '{\"query\": \"best brunch spots in Brooklyn\", \"answer\": true}'\n```\n\n### Historical data query\n```bash\n./scripts/query.sh '{\"query\": \"restaurants\", \"lat\": 40.7589, \"lon\": -73.9851, \"time\": \"2020-01-01\"}'\n```\n\n## Best Practices\n\n- For known locations (cities, landmarks), you can omit lat/lon and let the AI generate coordinates\n- Use `rank: true` for more relevant results when searching by attributes (e.g., \"quiet\", \"cheap\")\n- Enable `answer: true` when you need a natural language summary of results\n- Use `mode: \"advanced\"` for richer place data from web sources\n- Keep queries descriptive but concise for best AI interpretation\n\nFile v0.1.0:_meta.json\n\n{\n  \"ownerId\": \"kn7e3j3w1x5et0yppacy4m90y18084ba\",\n  \"slug\": \"query\",\n  \"version\": \"0.1.0\",\n  \"publishedAt\": 1769877264040\n}","readmeExcerpt":"Skill: Query Owner: barneyjm Summary: 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. Tags: latest:2.0.0 Version history: v2.0.0 | 2026-02-08T03:09:55.062Z | auto Version 2.0.0 (query) - Added instant trial","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"# Install all skills from repo\nnpx skills add https://github.com/barneyjm/camino-skills\n\n# Or install specific skills\nnpx skills add https://github.com/barneyjm/camino-skills --skill query"},{"language":"bash","snippet":"npx clawhub@latest install query\n# or: pnpm dlx clawhub@latest install query\n# or: bunx clawhub@latest install query"},{"language":"bash","snippet":"curl -s -X POST -H \"Content-Type: application/json\" \\\n  -d '{\"email\": \"you@example.com\"}' \\"},{"language":"bash","snippet":"curl -s -X POST -H \"Content-Type: application/json\" \\\n  -d '{\"email\": \"you@example.com\"}' \\\n  https://api.getcamino.ai/trial/start"},{"language":"json","snippet":"{\n  \"env\": {\n    \"CAMINO_API_KEY\": \"your-api-key-here\"\n  }\n}"},{"language":"bash","snippet":"# Search for coffee shops near Times Square\n./scripts/query.sh '{\"query\": \"coffee shops near Times Square\", \"limit\": 5}'\n\n# Search with specific coordinates\n./scripts/query.sh '{\"query\": \"quiet cafes with wifi\", \"lat\": 40.7589, \"lon\": -73.9851, \"radius\": 500}'\n\n# Get AI-generated answer with results\n./scripts/query.sh '{\"query\": \"best pizza in Manhattan\", \"answer\": true, \"rank\": true}'"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: query\ndescription: \"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.\"\nmetadata: {\"clawdbot\":{\"emoji\":\"🔍\",\"requires\":{\"env\":[\"CAMINO_API_KEY\"]},\"primaryEnv\":\"CAMINO_API_KEY\"}}\n---\n\n## Installation\n\n**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.\n\n```bash\n# Install all skills from repo\nnpx skills add https://github.com/barneyjm/camino-skills\n\n# Or install specific skills\nnpx skills add https://github.com/barneyjm/camino-skills --skill query\n```\n\n**Via clawhub:**\n```bash\nnpx clawhub@latest install query\n# or: pnpm dlx clawhub@latest install query\n# or: bunx clawhub@latest install query\n```\n\n# Query - Natural Language Place Search\n\nSearch for places using natural language. The AI automatically generates coordinates for known locations when not provided.\n\n## Setup\n\n**Instant Trial (no signup required):** Get a temporary API key with 25 calls:\n\n```bash\ncurl -s -X POST -H \"Content-Type: application/json\" \\\n  -d '{\"email\": \"you@example.com\"}' \\\n  https://api.getcamino.ai/trial/start\n```\n\nReturns: `{\"api_key\": \"camino-xxx...\", \"calls_remaining\": 25, ...}`\n\nFor 1,000 free calls/month, sign up at [https://app.getcamino.ai/skills/activate](https://app.getcamino.ai/skills/activate).\n\n**Add your key to Claude Code:**\n\nAdd to your `~/.claude/settings.json`:\n\n```json\n{\n  \"env\": {\n    \"CAMINO_API_KEY\": \"your-api-key-here\"\n  }\n}\n```\n\nRestart Claude Code.\n\n## Usage\n\n### Via Shell Script\n\n```bash\n# Search for coffee shops near Times Square\n./scripts/query.sh '{\"query\": \"coffee shops near Times Square\", \"limit\": 5}'\n\n# Search with specific coordinates\n./scripts/query.sh '{\"query\": \"quiet cafes with wifi\", \"lat\": 40.7589, \"lon\": -73.9851, \"radius\": 500}'\n\n# Get AI-generated answer with results\n./scripts/query.sh '{\"query\": \"best pizza in Manhattan\", \"answer\": true, \"rank\": true}'\n```\n\n### Via curl\n\n```bash\ncurl -H \"X-API-Key: $CAMINO_API_KEY\" \\\n  \"https://api.getcamino.ai/query?query=coffee+shops+near+Times+Square&limit=5\"\n```\n\n## Parameters\n\n| Parameter | Type | Required | Default | Description |\n|-----------|------|----------|---------|-------------|\n| query | string | Yes* | - | Natural language query (e.g., \"coffee shops near Times Square\") |\n| lat | float | No | - | Latitude for search center. AI generates if omitted for known locations. |\n| lon | float | No | - | Longitude for search center. AI generates if omitted for known locations. |\n| radius | int | No | 1000 | Search radius in meters (100-50000) |\n| rank | bool | No | true | Use AI to rank results by relevance |\n| limit | int | "},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn7e3j3w1x5et0yppacy4m90y18084ba\",\n  \"slug\": \"query\",\n  \"version\": \"2.0.0\",\n  \"publishedAt\": 1770520195062\n}"}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"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. Skill: Query Owner: barneyjm Summary: 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. Tags: latest:2.0.0 Version history: v2.0.0 | 2026-02-08T03:09:55.062Z | auto Version 2.0.0 (query) - Added instant trial","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":848,"uniquenessScore":54,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-09T18:27:08.151Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-09T18:27:08.151Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-10T03:52:29.561Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}