How do I install the Amap Maps skill?

Run npx skillmds@latest add dvcrn/amap-maps in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Amap Maps safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts, makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Amap Maps?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Amap Maps free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Amap Maps?

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Amap Maps by dvcrn — Agent Skill

Name: Amap Maps
Rating: 4.2 (5 reviews)
Author: dvcrn

File contents

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

References

Amap MCP Server Official Documentation

---name: amap-mapsdescription: Amap LBS services. Call Amap services via Streamable HTTP MCP, supporting geocoding, route planning, POI search, weather query, distance measurement, and more.---# Amap Maps SkillCall Amap services via Streamable HTTP MCP.## Quick Start### 1. Install Dependencies```bashcd amap-mapsnpm install```### 2. Set Environment Variables```bashexport AMAP_KEY="Your Amap Key"```Get Key: https://lbs.amap.com/api/javascript-api-v2/guide/abc/register### 3. Use Command Line Tool```bash# View all commandsnode scripts/amap.js help# Query weathernode scripts/amap.js weather 北京# Address to coordinatesnode scripts/amap.js geo encode "北京市朝阳区望京 SOHO" 北京# Coordinates to addressnode scripts/amap.js geo decode "116.482384,39.998383"# Search POInode scripts/amap.js search text 麦当劳北京# Nearby searchnode scripts/amap.js search around "116.48,39.99" 餐厅 1000# Route planningnode 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 measurementnode scripts/amap.js distance "116.48,39.99" "116.40,39.91" 1# IP locationnode scripts/amap.js ip-location "114.114.114.114"# Navigation Schema (generate Amap URI)node scripts/amap.js navi "116.397428" "39.90923"# Taxi Schemanode 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```bash# 1. Search destinationnode scripts/amap.js search text 天安门北京# 2. Get location (coordinates) from results# 3. Plan driving routenode scripts/amap.js route driving "116.48,39.99" "116.397428,39.90923"```### Workflow 2: Current Location Weather```bash# 1. Get city via IP locationnode scripts/amap.js ip-location "114.114.114.114"# 2. Query weather for that citynode scripts/amap.js weather 南京```### Workflow 3: Nearby Exploration```bash# 1. Address to coordinatesnode scripts/amap.js geo encode "北京市朝阳区望京 SOHO"# 2. Search nearby restaurantsnode 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 |---## References- [Amap MCP Server Official Documentation](https://lbs.amap.com/api/mcp-server/summary)

Frequently asked questions

Amap Maps