amap-maps
SKILL.md
Amap Maps Skill
Call Amap services via Streamable HTTP MCP.
Quick Start
1. Install Dependencies
cd amap-maps
npm install
2. Set Environment Variables
export AMAP_KEY="Your Amap Key"
Get Key: https://lbs.amap.com/api/javascript-api-v2/guide/abc/register
3. Use Command Line Tool
# View all commands
node scripts/amap.js help
# Query weather
node scripts/amap.js weather 北京
# Address to coordinates
node scripts/amap.js geo encode "北京市朝阳区望京 SOHO" 北京
# Coordinates to address
node scripts/amap.js geo decode "116.482384,39.998383"
# Search POI
node scripts/amap.js search text 麦当劳 北京
# Nearby search
node scripts/amap.js search around "116.48,39.99" 餐厅 1000
# Route planning
node scripts/amap.js route driving "116.48,39.99" "116.40,39.91"
node scripts/amap.js route walking "116.48,39.99" "116.40,39.91"
node scripts/amap.js route bicycling "116.48,39.99" "116.40,39.91"
node scripts/amap.js route transit "116.48,39.99" "116.40,39.91" "北京" "北京"
# Distance measurement
node scripts/amap.js distance "116.48,39.99" "116.40,39.91" 1
# IP location
node scripts/amap.js ip-location "114.114.114.114"
# Navigation Schema (generate Amap URI)
node scripts/amap.js navi "116.397428" "39.90923"
# Taxi Schema
node scripts/amap.js taxi "116.397428" "39.90923" "天安门"
Tool List (15 tools)
| Category | Command | Description |
|---|---|---|
| Weather | weather <city> |
Query city weather |
| Geocoding | geo encode <address> [city] |
Address → Coordinates |
geo decode <coordinates> |
Coordinates → Address | |
| Search | search text <keyword> [city] |
Keyword search POI |
search around <coordinates> <keyword> [radius] |
Nearby search | |
search detail <POI_ID> |
POI details | |
| Routes | route driving <origin> <destination> |
Driving route planning |
route walking <origin> <destination> |
Walking route planning | |
route bicycling <origin> <destination> |
Cycling route planning | |
route transit <origin> <destination> <city> <cityd> |
Transit route planning | |
| Distance | distance <origin> <destination> [type] |
Distance measurement (0=linear, 1=driving, 3=walking) |
| Location | ip-location <IP> |
IP location |
| Schema | navi <lon> <lat> |
Generate navigation URI |
taxi <lon> <lat> <name> |
Generate taxi URI |
Common Workflows
Workflow 1: Search Place → Plan Route
# 1. Search destination
node scripts/amap.js search text 天安门 北京
# 2. Get location (coordinates) from results
# 3. Plan driving route
node scripts/amap.js route driving "116.48,39.99" "116.397428,39.90923"
Workflow 2: Current Location Weather
# 1. Get city via IP location
node scripts/amap.js ip-location "114.114.114.114"
# 2. Query weather for that city
node scripts/amap.js weather 南京
Workflow 3: Nearby Exploration
# 1. Address to coordinates
node scripts/amap.js geo encode "北京市朝阳区望京 SOHO"
# 2. Search nearby restaurants
node scripts/amap.js search around "116.47,39.99" 餐厅 1000
Error Handling
Common Errors
| Error | Cause | Solution |
|---|---|---|
AMAP_KEY not set |
Missing environment variable | Run export AMAP_KEY="..." |
Invalid API Key |
Key is invalid or expired | Check if Key is correct |
Missing parameters |
Missing required parameters | Check command format |
Rate limit exceeded |
Request rate limit exceeded | Reduce request frequency |