Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx skills add amap-demo/amap-sdk-skills --skill personal-mapgit clone --depth 1 https://github.com/amap-demo/amap-sdk-skillsWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/amap-demo/amap-sdk-skills/personal-map)<a href="https://agentmods.dev/skills/amap-demo/amap-sdk-skills/personal-map"><img src="https://agentmods.dev/badge/skills/amap-demo/amap-sdk-skills/personal-map/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/amap-demo/amap-sdk-skills/personal-map"><img src="https://agentmods.dev/badge/skills/amap-demo/amap-sdk-skills/personal-map.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00210 | $0.02663 |
| Opus 5 | $0.00105 | $0.01332 |
| Sonnet 5 | $0.00042 | $0.00533 |
| Haiku 4.5 | $0.00021 | $0.00266 |
Grade A, and why
personal-map scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 11d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Makes network callslowCapability
Not a fault in itself. Listed so you know the mod talks to something, and to what.
import urllib.request How it starts
The opening of the file, as written. The whole thing — 249 lines — stays where its author put it; the contents beside it link to each section on GitHub.
高德个人地图 Skill
概述
本 Skill 封装了高德开放平台的 Web 服务 API,提供地理编码、POI 搜索、路径规划等核心能力,根据用户描述生成个人专属地图,并支持在高德地图 App 中扫码打开。
重要:所有调用此技能的会话,最终都应调用 maps_schema_personal_map 生成个人地图二维码,并通过以下方式展示给用户:
- 下载二维码图片到本地(推荐保存到工作目录)
- 使用
present工具展示图片 - 在回复中直接嵌入 Markdown 图片(双重保障)
- 提供备用 URL 链接(防止图片展示失败)
这样可以确保用户能够可靠地看到并保存二维码。
接口说明
1. 地理编码
-
maps_geo:地址 → 经纬度坐标- 参数:
address(详细地址)、city(城市,可选) - 返回:经纬度坐标、格式化地址
- 参数:
-
maps_regeocode:经纬度坐标 → 结构化地址- 参数:
longitude(经度)、latitude(纬度) - 返回:国家、省份、城市、区县等完整地址信息
- 参数:
2. POI 搜索
-
maps_text_search:关键词搜索兴趣点- 参数:
keywords(搜索关键词)、city(城市,可选)、offset(每页记录数,默认 20) - 返回:POI 列表(名称、坐标、地址、电话)
- 参数:
-
maps_around_search:周边兴趣点搜索- 参数:
keywords、location(中心点"经度,纬度")、radius(搜索半径,单位米,默认 1000)、types(POI 类型,可选)、offset(默认 20)、page(默认 1) - 返回:周边 POI 列表(含距离信息)
- 参数:
3. 路径规划
-
maps_direction_walking:步行路线规划- 参数:
origin(起点"经度,纬度")、destination(终点"经度,纬度")
- 参数:
-
maps_direction_driving:驾车路线规划- 参数:
origin、destination
- 参数:
-
maps_direction_transit_integrated:公共交通路线规划- 参数:
origin、destination、city(城市,默认"北京")
- 参数:
4. 位置服务
maps_ip_location:IP 地址 → 地理位置- 参数:
ip(IP 地址) - 返回:省份、城市、行政区、ISP 等信息
- 参数:
5. 地图生成(核心)
-
maps_schema_personal_map:生成个人地图小程序二维码- 参数:
orgName(地图名称)lineList(行程列表,每条路线最多 16 个点)sceneType(场景类型,可选,默认1):1— 创建资源点且创建路线(默认,通用场景)2— 仅创建资源点(搜索类数据,多个点之间无关联关系)3— 仅创建路线(路径规划类数据,多个点有关联关系,如起终点、换乘点)
- 返回:
qr_code_url(二维码图片链接)、lineList(行程数据)
sceneType 选择指引:
- 用户做的是搜索(找餐厅、找景点、找周边 POI 等)→ 用
sceneType=2 - 用户做的是路径规划(从 A 到 B、导航、换乘等)→ 用
sceneType=3 - 两者都有,或不确定 → 用默认
sceneType=1
- 参数:
使用前提
- 申请高德地图开发者账号并获取 API Key(https://lbs.amap.com/)
- 配置环境变量:
export AMAP_API_KEY='your_api_key_here' - 确保网络连接正常
异常处理
所有接口在出错时均返回结构化错误信息,不会抛出异常:
{"error": "错误类型", "message": "具体原因"}
常见错误类型:API Key 缺失、请求失败、搜索失败、路径规划失败、生成地图行程失败。
检查返回值的推荐方式:
result = client.maps_text_search("餐厅", "北京")
if isinstance(result, list) and result and "error" in result[0]:
print(f"错误: {result[0]['message']}")
What ships with it
5 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 11d ago First seen · 249 lines · 210 tokens per session scan A dd08911f3c1d
personal-map is a skill published in the GitHub repository amap-demo/amap-sdk-skills (55 stars, last pushed 4mo ago), licensed MIT. It adds 210 tokens to every session and 2,663 once invoked, about $0.0011 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other skills, from other repositories
systematic-debugging
Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes.
local-ai-agents
Build local-first AI agents that run entirely on a developer workstation with Microsoft Foundry Local and Qwen function-calling models. Covers Small Language Models (SLMs), the OpenAI-compatible local endpoint, sandboxed local tools, local RAG with Chroma, local MCP servers, hybrid cloud/local routing, and the…
next-cache-components-adoption
Turn on Cache Components in a Next.js app and resolve the blocking routes it surfaces. Use when the user wants to enable, adopt, or migrate to Cache Components, flip the cacheComponents flag, work through a flood of blocking-prerender / instant validation errors, run the cache-components-instant-false codemod, or…
insight-error-page
Write or audit an insight-kind error page for the Next.js dev overlay. Use when creating a new errors/ .mdx page, auditing an existing one, or checking that a page matches the framework fix cards. Covers page structure, title alignment, FixCard cards with Copy prompt button, code snippets, terminology verification…
next-cache-components-optimizer
Drive a Next.js route to instant navigation by setting up an agentic loop, under Cache Components / PPR, on initial load (hard navigation) and client-side navigation (soft navigation). Encode the goal as a failing @next/playwright instant() e2e and work it to green, one verified route at a time; the shipped test then…
next-partial-prefetching-adoption
Turn on Partial Prefetching in a Next.js app and work through the insights it surfaces. Use when the user wants to enable or adopt Partial Prefetching, flip the partialPrefetching flag, opt routes in with export const prefetch = 'partial', audit Link prefetch={true} behavior, preserve existing prefetched UI with…