Amap agent skill

Skill henrywen98/amap-agent-skill

高德地图 Agent Skill（无需 MCP）— geocoding/POI/weather/route planning for Claude Code · pi · any shell agent, pure curl. AMap (Gaode) maps, no MCP server.

Install

npx -y skills add henrywen98/amap-agent-skill

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

高德地图（无需 MCP，纯 REST/curl）：地理编码、逆地理、POI 周边/关键词搜索、POI 详情、天气、驾车/步行/骑行/公交路径规划、距离测算、IP 定位。当用户问基于位置的问题——「我在哪」「附近的…」「到 X 怎么走」「今天天气」「某地坐标」「两点距离」——时使用。没坐标时（macOS）可先用 whereami 取系统精确坐标再调本 skill 的 scripts/amap.sh。Use for any location / map / POI / weather / route / geocoding query; runs under pi, Claude Code, or any shell-capable agent — no MCP server needed.

SKILL.md

5.3 KB, ~1.8k tokens by cl100k_base, as published. Nobody here has run it

高德地图（amap，无需 MCP）

纯 curl 调高德 Web 服务 REST，不依赖任何 MCP server，能力全部经 scripts/amap.sh 暴露。任何带 shell 的 agent（pi、Claude Code…）都能直接用。

API Key

scripts/amap.sh 自己解析 key，优先级（系统环境变量 > .env）：

环境变量 $AMAP_KEY（回退 $AMAP_MCP_KEY）
从当前工作目录向上最近的 .env 里的 AMAP_KEY=（回退 AMAP_MCP_KEY=）—— 即把 key 放在项目的 .env，不随 skill 分发。

缺 key 时脚本报错并提示如何设置。去高德开放平台注册「Web 服务」类型的 key（需实名）。

scripts/amap.sh 命令

location 一律 经度,纬度。返回原始高德 JSON（status:"1" 为成功）。无参运行打印完整用法。

命令	说明	原 MCP 工具
`geo <address> [city]`	地址→经纬度	`maps_geo`
`regeocode <lng,lat>`	经纬度→行政区划地址	`maps_regeocode`
`around <lng,lat> [kw] [radius]`	周边搜 POI	`maps_around_search`
`text <kw> [city] [citylimit]`	关键词搜 POI	`maps_text_search`
`detail <poiid>`	POI 详情	`maps_search_detail`
`weather <city\|adcode> [base\|all]`	天气	`maps_weather`
`driving <o> <d>`	驾车路径	`maps_direction_driving`
`walking <o> <d>`	步行路径	`maps_direction_walking`
`bicycling <o> <d>`	骑行路径	`maps_direction_bicycling`
`transit <o> <d> <city> [cityd]`	公交/地铁（跨城需 city/cityd）	`maps_direction_transit_integrated`
`distance <origins> <dest> [type]`	距离测算（type 0直线/1驾车/3步行）	`maps_distance`
`ip [ip]`	IP 定位	`maps_ip_location`
`raw <path> [k v ...]`	透传任意 v3/v4 接口	—
`doctor [--refresh]`	校验 key + 缓存实时工具清单	—

工作原理（重要）

热路径直连 REST：amap.sh weather 北京 直接打 restapi.amap.com，不碰 MCP、不拉接口文档。上表的「命令 → REST 接口」映射是打包时由高德 MCP 的 tools/list 编译固化进脚本的。
doctor = 缓存式自描述：想看高德当前暴露哪些工具/参数，跑 amap.sh doctor——它一次性向 mcp.amap.com 拉 tools/list 缓存到本地（~/.cache/amap-agent-skill/tools.json），--refresh 重拉。仅用于发现，不在 query 主路径上（tools/list 不返回 REST 地址，所以日常 query 无需它）。

定位规则（基于位置的问题）

用户需要基于位置的结果（「我在哪」「附近的…」「到 X 怎么走」「今天天气」）但没给坐标时，先拿到精确坐标再调 amap.sh。别默认用 IP 定位——挂代理/VPN 时公网 IP 在境外，高德 IP 定位会定到错误城市。

取坐标

macOS（推荐）：用 whereami 走系统定位（CoreLocation，WiFi/GPS），与代理/出口 IP 无关，挂 VPN 也准：
```
/Applications/whereami.app/Contents/MacOS/whereami --json
# → {"latitude":31.246,"longitude":120.698,"accuracy":40,"address":{…}}
```
binary 不在该路径时依次试 $WHEREAMI_PATH / /opt/homebrew/bin/whereami / /usr/local/bin/whereami。
非 macOS / 无 whereami：让用户给坐标或地名（amap.sh geo <地名>），或**明确标注「基于 IP，挂代理可能不准」**后用 amap.sh ip。

喂给 amap.sh

⚠️ 高德 location 一律 经度,纬度（longitude 在前），别写反。用坐标拼 ${longitude},${latitude}：

S="$(dirname "$0")/scripts/amap.sh"   # 或 skill 内相对路径 scripts/amap.sh
LOC="120.698,31.246"
"$S" regeocode "$LOC"             # 我在哪：逆地理
"$S" around "$LOC" 咖啡 1000      # 附近的咖啡

坐标系注意

whereami/GPS 返回 WGS-84，高德用 GCJ-02（火星坐标），国内两者有约几百米偏移：

市/区级（regeocode、weather）：偏移可忽略，直接用。
街道/门牌/POI 级（around 找最近的店）：可能偏几百米，精度要紧时跟用户说明或做 WGS-84→GCJ-02 转换。

可视化输出

需要对比/出图（如多套房子的通勤与价格对比、行程路线）时：

优先生成 SVG 文件（自包含、可双击打开，像 examples/星合广场租房简图.svg 那样：地铁示意 + 对比卡片）。
降级：若当前 harness/终端无法内联渲染 SVG，就在回复里直接给简化版——markdown 表格或 ASCII 示意图。
始终附文本摘要：无论是否出 SVG，回复都要带一段文字结论（哪个更优、关键数字），绝不只依赖 SVG 被渲染。

What ships with it: 9 files

29.6 KB alongside SKILL.md, 1 of them executable

examples/

rental-decision.md2.2 KB
星合广场租房简图.svg9.0 KB

scripts/

amap.shruns7.1 KB