โ† All skills
Tencent SkillHub ยท Developer Tools

Ncloud Maps

Query Naver Cloud Maps APIs for route navigation. Smart routing: Directions5 by default, auto-switches to Directions15 for 5+ waypoints.

skill openclawclawhub Free
0 Downloads
0 Stars
0 Installs
0 Score
High Signal

Query Naver Cloud Maps APIs for route navigation. Smart routing: Directions5 by default, auto-switches to Directions15 for 5+ waypoints.

โฌ‡ 0 downloads โ˜… 0 stars Unverified but indexed

Install for OpenClaw

Quick setup
  1. Download the package from Yavira.
  2. Extract the archive and review SKILL.md first.
  3. Import or place the package into your OpenClaw setup.

Requirements

Target platform
OpenClaw
Install method
Manual import
Extraction
Extract archive
Prerequisites
OpenClaw
Primary doc
SKILL.md

Package facts

Download mode
Yavira redirect
Package format
ZIP package
Source platform
Tencent SkillHub
What's included
README.md, SKILL.md, dist/lib/directions.js, dist/lib/directions5.js, dist/lib/smartDirections.js, dist/scripts/index.js

Validation

  • Use the Yavira download entry.
  • Review SKILL.md after the package is downloaded.
  • Confirm the extracted package contains the expected setup assets.

Install with your agent

Agent handoff

Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.

  1. Download the package from Yavira.
  2. Extract it into a folder your agent can access.
  3. Paste one of the prompts below and point your agent at the extracted folder.
New install

I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.

Upgrade existing

I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.

Trust & source

Release facts

Source
Tencent SkillHub
Verification
Indexed source record
Version
1.0.8

Documentation

ClawHub primary doc Primary doc: SKILL.md 19 sections Open source page

Prompt

When a user requests a route calculation with addresses or coordinates, use this skill to calculate driving time, distance, and cost. Usage: /skill ncloud-maps <start> <goal> [waypoints] Start and goal must be in longitude,latitude format OR addresses (convert using goplaces/naver-local-search first) Returns: distance, duration, toll fare, taxi fare, fuel cost Examples: /skill ncloud-maps "126.9633,37.5524" "127.0165,37.4889" (coordinates) /skill ncloud-maps ์•„ํ˜„์—ญ ์„œ์ดˆ์—ญ (addresses - requires geocoding skill first)

Ncloud Maps

Query Naver Cloud Maps APIs for intelligent routing (Directions5 + Directions15).

Key Feature: Smart Routing

v1.0.8+ โ€” By default, the skill uses Directions5 for queries with fewer than 5 waypoints, and automatically switches to Directions15 when you have 5 or more waypoints. No manual selection needed. WaypointsAPI UsedMax Waypoints0โ€“4Directions555+Directions1515

Setup

Get API credentials from Naver Cloud Console: Create/register an Application in Naver Cloud Console Obtain Client ID (API Key ID) and Client Secret (API Key) Enable "Maps Directions15" API Set environment variables (or use .env file): export NCLOUD_API_KEY_ID="your-api-key-id" export NCLOUD_API_KEY="your-api-key-secret" Or create a .env file: NCLOUD_API_KEY_ID=your-api-key-id NCLOUD_API_KEY=your-api-key-secret Install dependencies: cd ~/.openclaw/workspace/skills/ncloud-maps npm install

Using with Address-to-Coordinate Skills

ncloud-maps requires coordinates in longitude,latitude format. If you have address-based location data, use one of these compatible skills to convert addresses to coordinates: Available Options (choose based on your environment): SkillProviderCoordinatesSetup RequiredgoplacesGoogle Places APIYes (lon,lat)GOOGLE_PLACES_API_KEYnaver-local-searchNaver Local SearchYes (lon,lat)NAVER_CLIENT_ID, NAVER_CLIENT_SECRETCustom APIYour choiceYes (lon,lat)Your setup Example workflow with goplaces: # Get coordinates from address COORDS=$(goplaces resolve "๊ฐ•๋‚จ์—ญ, ์„œ์šธ" --json | jq -r '.places[0] | "\(.location.longitude),\(.location.latitude)"') # Use coordinates with ncloud-maps npx ts-node scripts/index.ts --start "$COORDS" --goal "127.0049,37.4947" Example workflow with naver-local-search: # Get coordinates from address COORDS=$(naver-local-search search "๊ฐ•๋‚จ์—ญ" --format json | jq -r '.[0] | "\(.x),\(.y)"') # Use coordinates with ncloud-maps npx ts-node scripts/index.ts --start "$COORDS" --goal "127.0049,37.4947" Or integrate any other geocoding service that returns longitude,latitude coordinates.

Smart Routing (Default Behavior)

By default, no --api flag needed. The skill automatically: Uses Directions5 for 0โ€“4 waypoints (faster) Switches to Directions15 for 5+ waypoints (necessary) Provide coordinates in longitude,latitude format: # 0โ€“4 waypoints โ†’ Directions5 (automatic) npx ts-node scripts/index.ts \ --start "127.0683,37.4979" \ --goal "126.9034,37.5087" \ --waypoints "127.0100,37.5000|127.0200,37.5100" # 5+ waypoints โ†’ Directions15 (automatic) npx ts-node scripts/index.ts \ --start "127.0683,37.4979" \ --goal "126.9034,37.5087" \ --waypoints "127.0100,37.5000|127.0200,37.5100|127.0300,37.5200|127.0400,37.5300|127.0500,37.5400"

Basic route query by coordinates (direct)

npx ts-node scripts/index.ts \ --start "127.0683,37.4979" \ --goal "126.9034,37.5087"

Force specific API (optional)

If you need to override the smart routing: # Force Directions5 (max 5 waypoints) npx ts-node scripts/index.ts \ --start "127.0683,37.4979" \ --goal "126.9034,37.5087" \ --api directions5 \ --waypoints "127.0100,37.5000|127.0200,37.5100" # Force Directions15 (max 15 waypoints) npx ts-node scripts/index.ts \ --start "127.0683,37.4979" \ --goal "126.9034,37.5087" \ --api directions15 \ --waypoints "127.0100,37.5000|127.0200,37.5100|127.0300,37.5200|127.0400,37.5300|127.0500,37.5400"

With waypoints (coordinates only)

npx ts-node scripts/index.ts \ --start "127.0683,37.4979" \ --goal "126.9034,37.5087" \ --waypoints "127.0100,37.5000" Multiple waypoints: npx ts-node scripts/index.ts \ --start "127.0683,37.4979" \ --goal "126.9034,37.5087" \ --waypoints "127.0100,37.5000|127.0200,37.5100"

Route options

Choose from: trafast (fast), tracomfort (comfort), traoptimal (default), traavoidtoll (toll-free), traavoidcaronly (avoid car-only roads) npx ts-node scripts/index.ts \ --start "127.0683,37.4979" \ --goal "126.9034,37.5087" \ --option "traavoidtoll"

Vehicle and fuel settings

npx ts-node scripts/index.ts \ --start "127.0683,37.4979" \ --goal "126.9034,37.5087" \ --cartype 2 \ --fueltype "diesel" \ --mileage 10.5 Vehicle types: 1 (default): Small sedan 2: Medium van/cargo 3: Large vehicle 4: 3-axle cargo truck 5: 4+ axle special cargo 6: Compact car Fuel types: gasoline (default), highgradegasoline, diesel, lpg

Output

{ "success": true, "start": "127.0683,37.4979", "goal": "126.9034,37.5087", "distance": 12850, "duration": 1145000, "toll_fare": 0, "taxi_fare": 18600, "fuel_price": 1550, "departure_time": "2026-02-21T14:10:00" }

Response Fields

success - Whether the query succeeded start - Starting point coordinates goal - Destination coordinates distance - Total distance in meters duration - Total duration in milliseconds (รท1000 = seconds) toll_fare - Toll/highway fare in KRW taxi_fare - Estimated taxi fare in KRW fuel_price - Estimated fuel cost in KRW departure_time - Query timestamp error - Error message (if success=false)

How It Works

Address Resolution (Optional - any geocoding skill) Use any available skill that provides coordinates (goplaces, naver-local-search, etc.) Extract longitude,latitude format from the result Pass coordinates to ncloud-maps Coordinate Validation Input: Coordinates in longitude,latitude format (direct input or from geocoding skill) Validates format and range Returns error if format is invalid Route Calculation (Directions15 or Directions5) Coordinates sent to appropriate Directions API Returns distance, duration, tolls, taxi fare, fuel cost Only for vehicle (car) routes โ€” not for pedestrian or public transit Waypoints Support Each waypoint must be in longitude,latitude format All coordinates sent to Directions API

Limitations

โš ๏ธ This skill only calculates vehicle (car) routes. It does not support: Public transportation (subway, bus, etc.) Walking routes Multi-modal journeys Transit-specific features (fare, stops, schedules) For those use cases, use transit-specific APIs (e.g., Kakao Map, Naver Map Transit API).

Environment Variables

Required: NCLOUD_API_KEY_ID - Naver Cloud API Key ID NCLOUD_API_KEY - Naver Cloud API Key Secret

API Limits

Smart Routing: 0โ€“4 waypoints: Directions5 API (max 5 waypoints) 5+ waypoints: Directions15 API (max 15 waypoints) General: Real-time traffic information included Request rate limits apply per your Naver Cloud plan

Error Handling

Common errors: ์ขŒํ‘œ ํ˜•์‹ ์˜ค๋ฅ˜ - Invalid coordinate format (use longitude,latitude) Authentication Failed - Invalid API credentials Quota Exceeded - API rate limit hit No routes found - No valid route between points Check Naver Cloud Console for: API enablement for your application Quota/rate limit status Valid coordinates

References

See api-spec.md for detailed API specifications.

Category context

Code helpers, APIs, CLIs, browser automation, testing, and developer operations.

Source: Tencent SkillHub

Largest current source with strong distribution and engagement signals.

Package contents

Included in package
4 Scripts2 Docs
  • SKILL.md Primary doc
  • README.md Docs
  • dist/lib/directions.js Scripts
  • dist/lib/directions5.js Scripts
  • dist/lib/smartDirections.js Scripts
  • dist/scripts/index.js Scripts