Provides route planning for driving, walking, cycling, and transit, alongside POI searches for attractions and restaurants.
- GitHub stars
- 785
- Files
- 5
- Last commit
- Oct 30, 2026
- License
- MIT
- Allowed tools
- —
What does the map skill do?
map provides route planning for driving, walking, cycling, and transit, alongside POI searches for attractions and restaurants.
Summary generated from the skill's SKILL.md.
About the map skill
Planning travel itineraries and finding local points of interest is what this skill enables for developers building location-aware agents. It utilizes the Amap API to provide specific routing information and location data. An agent should load this tool when a user asks for directions, trip planning, or recommendations for places to visit.
The tool offers several distinct commands including driving, walking, transit, and cycling for route planning. It also includes specialized search functions for attractions and restaurants within a specific city. Users can provide either address names or latitude and longitude coordinates as starting points or destinations. For transit requests, the system requires specific city codes to function correctly. All search commands can produce JSON output to facilitate easier data processing by the AI client.
What an agent can do with it
- 1Plan multi-day travel itinerariesAsk the agent to find attractions in a specific city to build a travel schedule.
- 2Find local dining optionsRequest a list of restaurants in a particular city to discover where to eat.
- 3Get public transportation directionsInquire about the best subway or bus route between two landmarks using city codes.
- 4Calculate driving routes between locationsDetermine the driving path from one specific landmark to another within a city.
Written from the skill's SKILL.md. Every use case is checked against a quote from it.
How to install the map skill
Each command copies the skill folder into the client's skills directory. Restart the client or start a new session to load it.Install the map skill in Claude Code
~/.claude/skills/map/SKILL.md
$ npx degit countbot-ai/CountBot/workspace/skills/map ~/.claude/skills/mapInstall the map skill in Claude Code (project)
.claude/skills/map/SKILL.md
$ npx degit countbot-ai/CountBot/workspace/skills/map .claude/skills/mapInstall the map skill in Codex
~/.agents/skills/map/SKILL.md
$ npx degit countbot-ai/CountBot/workspace/skills/map ~/.agents/skills/mapInstall the map skill in Gemini CLI
~/.gemini/skills/map/SKILL.md
$ npx degit countbot-ai/CountBot/workspace/skills/map ~/.gemini/skills/mapInstall the map skill in Claude.ai
npx degit countbot-ai/CountBot/workspace/skills/map map && zip -r map.zip map # claude.ai → Customize → Skills → + → Create skill → Upload a skill → map.zip
Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the scripts before you let an agent run them. How checks work · What to fix for more points
- Source repository linked and reachablecountbot-ai/countbot/workspace/skills/map is public and reachablegithub.com/countbot-ai/countbot/tree/HEAD/workspace/skills/m ↗Pass
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit 2026-10-30github.com/countbot-ai/countbot/commits ↗Pass
- No download-and-run or credential theft in scripts2 scripts read; no download-and-run, remote eval, base64 execution or credential uploadPass
- No hidden instructions in SKILL.mdNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/countbot-ai/countbot/blob/HEAD/workspace/skills/m ↗Pass
- Pre-approved tools are scopedNo pre-approved tools; the agent asks before using onegithub.com/countbot-ai/countbot/blob/HEAD/workspace/skills/m ↗Pass
- SKILL.md follows the Agent Skills formatthe description does not say when to use the skillgithub.com/countbot-ai/countbot/blob/HEAD/workspace/skills/m ↗Finding
SKILL.md
View on GitHub地图路线规划与 POI 搜索
基于高德地图 API 的路线规划和 POI 搜索服务。
配置
编辑 skills/map/scripts/config.json,填写高德地图 API Key:
{
"amap_key": "YOUR_AMAP_KEY"
}
AI 调用示例
用户说"我想去东莞玩3天":
# 1. 搜索景点
python3 skills/map/scripts/map.py attractions --city 东莞 --page-size 20 --json
# 2. 查询景点间路线
python3 skills/map/scripts/map.py driving --origin "旗峰公园" --destination "可园博物馆" --origin-city 东莞 --dest-city 东莞
用户说"东莞有什么好吃的":
python3 skills/map/scripts/map.py restaurants --city 东莞 --page-size 20 --json
用户说"从天安门到鸟巢坐地铁怎么走":
python3 skills/map/scripts/map.py transit --origin "天安门" --destination "鸟巢" --city1 010 --city2 010
命令行参考
路线规划
# 驾车
python3 skills/map/scripts/map.py driving --origin "起点" --destination "终点" --origin-city 城市 --dest-city 城市
# 步行
python3 skills/map/scripts/map.py walking --origin "起点" --destination "终点" --origin-city 城市 --dest-city 城市
# 公交(需要城市编码)
python3 skills/map/scripts/map.py transit --origin "起点" --destination "终点" --city1 编码 --city2 编码
# 显示详细步骤
python3 skills/map/scripts/map.py driving --origin "起点" --destination "终点" --show-steps
POI 搜索
# 景点搜索(风景名胜 + 博物馆)
python3 skills/map/scripts/map.py attractions --city 城市 --page-size 20
# 餐厅搜索(排除快餐)
python3 skills/map/scripts/map.py restaurants --city 城市 --page-size 20
# 通用搜索
python3 skills/map/scripts/map.py search --keywords 关键词 --city 城市
常用城市编码
| 城市 | 编码 | 城市 | 编码 |
|---|---|---|---|
| 北京 | 010 | 上海 | 021 |
| 广州 | 020 | 深圳 | 0755 |
| 东莞 | 0769 | 杭州 | 0571 |
注意事项
- 支持地址名称或经纬度坐标作为起终点,系统自动识别
- 建议提供城市参数以提高地址解析准确性
- 公交路线必须提供城市编码
- 所有搜索命令支持
--json输出
Files in this skill
5map skill questions
How do I install the map skill in Claude Code?
Run npx degit countbot-ai/CountBot/workspace/skills/map ~/.claude/skills/map. Claude Code loads skills from ~/.claude/skills (all projects) or .claude/skills (one project) and uses a skill when its description matches the task.
Which clients can use the map skill?
Any client that reads the Agent Skills format: Claude Code, Codex, Gemini CLI and claude.ai (upload as a ZIP). Scripts in the skill run only where the client allows code execution.
What modes of transportation are supported for route planning?
The tool supports driving, walking, cycling, and public transit routes.
How can I search for places to eat or visit?
You can use the attractions command to find scenic spots and museums, or the restaurants command to find dining options.
What is required to plan a public transit route?
When planning transit routes, you must provide the specific city codes.