amap — скилл для Claude Code: что делает и как установить
Вызывает веб-API AMap через локальные скрипты для геокодинга, расчёта маршрутов, поиска POI и погоды. Помогает агенту работать с картами без MCP-сервера.
npx skills add kaichen/amap-skill --skill amap -a claude-codeЧто делает amap
Скилл подключается к AMap Web Service API через скрипты без запуска MCP-сервера. Он выполняет геокодирование и ищет POI. Скрипт также запрашивает погоду и определяет локацию по IP. Если передан обычный текстовый адрес, инструмент выбирает адресные команды для построения маршрута.
Для работы нужен интерпретатор Bun и переменная окружения AMAP_MAPS_API_KEY. Другие ключи сервис не принимает. Запуск идёт через bun scripts/amap.ts, а список команд описан в файле references/command-map.md.
Ответы API возвращаются в сыром виде как чистый JSON без дополнительных обёрток. Любой ненулевой статус считается ошибкой. Это защитит от скрытых сбоев при неверных координатах.
Какие задачи решает
- получить координаты по адресу через геокодирование AMap
- построить маршрут между точками по текстовым адресам
- найти объекты POI и погоду через Web Service API
- определить геопозицию по IP-адресу
Примеры запросов агенту
- Найди координаты и погоду для Пекина через AMap
- Построй маршрут между двумя адресами через скрипт AMap
- Найди рестораны рядом с текущей точкой через AMap POI
Как установить amap
1Через Skills CLI (Vercel)
npx skills add kaichen/amap-skill --skill amap -a claude-code2Вручную: положить файлы
~/.claude/skills/amap/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/amap/
1Через Skills CLI (Vercel)
npx skills add kaichen/amap-skill --skill amap -a codex2Вручную: положить файлы
.agents/skills/amap/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add kaichen/amap-skill --skill amap -a cursor2Вручную: положить файлы
.cursor/skills/amap/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install kaichen/amap-skill amap2Вручную: положить файлы
.github/skills/amap/SKILL.md1Через Skills CLI (Vercel)
npx skills add kaichen/amap-skill --skill amap -a gemini-cli2Командой платформы
gemini skills install https://github.com/kaichen/amap-skill --path skills/amapВручную: положить файлы
.devin/skills/amap/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add kaichen/amap-skill --skill amap -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Похожие
Рядом в теме «Настройка агента: память, контекст, субагенты»
Все скиллы по теме «Настройка агента: память, контекст, субагенты» →Вопросы о amap
Как установить amap в Claude Code?
Выполните команду npx skills add kaichen/amap-skill --skill amap -a claude-code в терминале.
Что делает скилл amap?
Он отправляет запросы к AMap Web Service API через локальные скрипты Bun. Скилл геокодирует адреса, строит маршруты, запрашивает погоду и находит точки интереса POI.
Нужен ли для работы amap запущенный MCP-сервер?
Нет, этот инструмент работает напрямую через скрипты без MCP-сервера. Для вызовов понадобятся установленный Bun и ключ в переменной AMAP_MAPS_API_KEY.
Исходный текст
SKILL.md · MIT
--- name: amap description: 通过脚本直连高德 Web Service API 完成地理编码、逆地理编码、IP 定位、天气、路径规划、距离测量和 POI 查询。用户要求“高德/AMap 查询”“路线规划”“地理编码”“POI 搜索”或需要用命令行脚本调用高德 API 时使用。 --- # AMap Skill ## Quick Start 1. Ensure `AMAP_MAPS_API_KEY` is set. 2. Run `bun scripts/amap.ts --help` in this skill directory. 3. Pick the matching command from `references/command-map.md`. ## Workflow 1. Validate user intent and select one command. 2. Prefer address commands for route planning when users provide plain addresses. 3. Keep output as raw AMap JSON without wrapping fields. 4. Treat any non-zero API business state as failure. ## Commands - Full command mapping: `references/command-map.md` - Ready-to-run examples: `references/examples.md` ## Notes - This skill is script-first and does not run an MCP server. - Only `AMAP_MAPS_API_KEY` is supported.
© kaichen · MIT · kaichen/amap-skill
