nano-muse/nanoMuse / nanomuse/skills/builtin/amap
amap
VerifiedPlaces, 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.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 3.9 KB |
SKILL.md
View on GitHub---
name: amap
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.
channel: api
metadata:
author: nanoMuse
version: "1"
---
# 高德地图 (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.
Coordinates are `经度,纬度` (longitude first, GCJ-02). Durations come in seconds and distances in metres: say them as minutes and kilometres.
## How to answer
- Resolve both ends first, then one route call per mode the user cares about. When they did not say how they travel, compare transit and driving in one line each and say which you would take at that hour.
- A "what's near" question: geocode the centre, one `around_search`, then give three places at most with what makes each worth it (rating, distance, open now), not the whole list.
- Travel time is an estimate for now; for a departure later or tomorrow say so, and for a real day-of-travel plan add slack.
- Weather goes into plans the user is making (an outdoor day, a trip) without being asked when it changes the plan (rain on the day of the hike).
## With the other hands
- 高德 + 12306: the route to the station (this skill) and the train itself (the `train-tickets` skill on the phone) make one plan: leave home at 07:10, G1 at 08:00.
- 高德 + 飞书: a route or an address the user wants to share goes to a colleague with the `feishu` skill; a meeting's location is checked before the event is created.
- 高德 + the workspace: a day's itinerary with places, times and the routes between them is a page in `trips/`, written with the `trip-plan` skill; the coordinates and distances come from here.
## Finish
A few lines: where, how far, how long, by what, and the weather when it matters. Save nothing unless asked. `remember` the user's home and workplace once they name them, so that the next "how long to get to …" needs no question.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |