# Amap

Places, routes, travel times, distances and weather in China through the 高德地图 (Amap)...

- Repository: https://github.com/nano-muse/nanoMuse (2980 stars)
- Category: AI and agents
- License: GPL-3.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add nano-muse/nanoMuse --skill amap -g -a claude-code -y`
Codex: `npx skills add nano-muse/nanoMuse --skill amap -g -a codex -y`
Cursor: `npx skills add nano-muse/nanoMuse --skill amap -g -a cursor -y`
Gemini CLI: `npx skills add nano-muse/nanoMuse --skill amap -g -a gemini-cli -y`

## Description

Places, routes, travel times, distances and weather in China through the 高德地图 (Amap) MCP server. Use when the user asks how far, how long, how to get somewhere (car, transit, bike, foot), what is near a place, or about the weather in a Chinese city.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 高德地图 (Amap) through MCP

高德 publishes an MCP server with twelve tools; configured, they appear to you as `amap__maps_*`. No browser, no phone, no screenshots: a question about a place is one or two tool calls.

## Is it there?

Look for `amap__maps_geo` in your tools. If it is not there, say so in one line and give the user the four lines to add to `config.toml`, then stop. Your tools list is the only place it can be: do not run shell commands or scripts to look for it, and when the user asked for an app on their phone and you have read it there, the answer is complete without this skill:

```toml
[[mcp.servers]]
name = "amap"
url = "https://mcp.amap.com/mcp?key={{vault:AMAP_KEY}}"   # a free Web 服务 key from console.amap.com
risk = "safe"
```

and `nanomuse vault set AMAP_KEY`. Without Node, the hosted URL is the way; with it, `command = "npx"`, `args = ["-y", "@amap/amap-maps-mcp-server"]`, `env = { AMAP_MAPS_API_KEY = "{{vault:AMAP_KEY}}" }` does the same.

## The tools

- `amap__maps_geo`: an address or a landmark (`北京南站`, `上海市浦东新区世纪大道100号`) → coordinates `lng,lat`; `amap__maps_regeocode` the other way round. Almost everything else wants coordinates, so this comes first.
- `amap__maps_text_search`: places by keyword (`咖啡`, `汉庭酒店`) in a `city`; `amap__maps_around_search`, the same within `radius` metres of a `location`; `amap__maps_search_detail`, one place's details by its `id` (opening hours, rating, phone, address).
- `amap__maps_direction_driving`, `amap__maps_direction_walking`, `amap__maps_bicycling`: a route between two coordinates with distance, duration and the steps; `amap__maps_direction_transit_integrated`, bus, metro and train together, and across cities with `city` and `cityd`.
- `amap__maps_distance`: just the distance and time between points (`type` 1 = driving, 3 = straight line).
- `amap__maps_weather`: today and the next few days for a `city` name or adcode.

The rest: https://github.com/nano-muse/nanoMuse/blob/HEAD/nanomuse/skills/builtin/amap/SKILL.md