← 返回 Skills 市场
726
总下载
1
收藏
8
当前安装
2
版本数
在 OpenClaw 中安装
/install amap-maps
功能描述
Amap LBS services. Call Amap services via Streamable HTTP MCP, supporting geocoding, route planning, POI search, weather query, distance measurement, and more.
使用说明 (SKILL.md)
Amap Maps Skill
Call Amap services via Streamable HTTP MCP.
Quick Start
1. Install Dependencies
cd amap-maps
npm install
2. Set Environment Variables
export AMAP_KEY="Your Amap Key"
Get Key: https://lbs.amap.com/api/javascript-api-v2/guide/abc/register
3. Use Command Line Tool
# View all commands
node scripts/amap.js help
# Query weather
node scripts/amap.js weather 北京
# Address to coordinates
node scripts/amap.js geo encode "北京市朝阳区望京 SOHO" 北京
# Coordinates to address
node scripts/amap.js geo decode "116.482384,39.998383"
# Search POI
node scripts/amap.js search text 麦当劳 北京
# Nearby search
node scripts/amap.js search around "116.48,39.99" 餐厅 1000
# Route planning
node scripts/amap.js route driving "116.48,39.99" "116.40,39.91"
node scripts/amap.js route walking "116.48,39.99" "116.40,39.91"
node scripts/amap.js route bicycling "116.48,39.99" "116.40,39.91"
node scripts/amap.js route transit "116.48,39.99" "116.40,39.91" "北京" "北京"
# Distance measurement
node scripts/amap.js distance "116.48,39.99" "116.40,39.91" 1
# IP location
node scripts/amap.js ip-location "114.114.114.114"
# Navigation Schema (generate Amap URI)
node scripts/amap.js navi "116.397428" "39.90923"
# Taxi Schema
node scripts/amap.js taxi "116.397428" "39.90923" "天安门"
Tool List (15 tools)
| Category | Command | Description |
|---|---|---|
| Weather | weather \x3Ccity> |
Query city weather |
| Geocoding | geo encode \x3Caddress> [city] |
Address → Coordinates |
geo decode \x3Ccoordinates> |
Coordinates → Address | |
| Search | search text \x3Ckeyword> [city] |
Keyword search POI |
search around \x3Ccoordinates> \x3Ckeyword> [radius] |
Nearby search | |
search detail \x3CPOI_ID> |
POI details | |
| Routes | route driving \x3Corigin> \x3Cdestination> |
Driving route planning |
route walking \x3Corigin> \x3Cdestination> |
Walking route planning | |
route bicycling \x3Corigin> \x3Cdestination> |
Cycling route planning | |
route transit \x3Corigin> \x3Cdestination> \x3Ccity> \x3Ccityd> |
Transit route planning | |
| Distance | distance \x3Corigin> \x3Cdestination> [type] |
Distance measurement (0=linear, 1=driving, 3=walking) |
| Location | ip-location \x3CIP> |
IP location |
| Schema | navi \x3Clon> \x3Clat> |
Generate navigation URI |
taxi \x3Clon> \x3Clat> \x3Cname> |
Generate taxi URI |
Common Workflows
Workflow 1: Search Place → Plan Route
# 1. Search destination
node scripts/amap.js search text 天安门 北京
# 2. Get location (coordinates) from results
# 3. Plan driving route
node scripts/amap.js route driving "116.48,39.99" "116.397428,39.90923"
Workflow 2: Current Location Weather
# 1. Get city via IP location
node scripts/amap.js ip-location "114.114.114.114"
# 2. Query weather for that city
node scripts/amap.js weather 南京
Workflow 3: Nearby Exploration
# 1. Address to coordinates
node scripts/amap.js geo encode "北京市朝阳区望京 SOHO"
# 2. Search nearby restaurants
node scripts/amap.js search around "116.47,39.99" 餐厅 1000
Error Handling
Common Errors
| Error | Cause | Solution |
|---|---|---|
AMAP_KEY not set |
Missing environment variable | Run export AMAP_KEY="..." |
Invalid API Key |
Key is invalid or expired | Check if Key is correct |
Missing parameters |
Missing required parameters | Check command format |
Rate limit exceeded |
Request rate limit exceeded | Reduce request frequency |
References
安全使用建议
This package appears to be a straightforward Node.js CLI for Amap MCP. Before installing, verify the publisher/source (there's no homepage), and run npm install in a controlled environment. Use a dedicated, minimally-privileged AMAP_KEY (restrict by referrer/IP if possible) because the key is placed in the request URL and could appear in logs. Optionally inspect scripts/amap.js yourself (it's short and readable) and run 'npm audit' on dependencies before using in production.
功能分析
Type: OpenClaw Skill
Name: amap-maps
Version: 1.0.1
The skill is a legitimate wrapper for Amap (AutoNavi) Location Based Services, allowing users to perform geocoding, route planning, and weather queries via Amap's official Model Context Protocol (MCP) endpoint (mcp.amap.com). The code in `scripts/amap.js` is straightforward, using the provided `AMAP_KEY` solely for authenticating requests to the mapping service. No evidence of data exfiltration, malicious execution, or prompt injection was found.
能力评估
Purpose & Capability
Name/description (Amap LBS services) match the implementation: a Node.js CLI that posts JSON-RPC calls to https://mcp.amap.com/mcp to perform geocoding, routing, POI search, weather, distance, and related operations.
Instruction Scope
SKILL.md and scripts/amap.js only direct the agent/user to run node/npm and execute the included script; the script only contacts the Amap MCP endpoint and does not read local files, other environment variables, or send data to any third-party endpoints.
Install Mechanism
There is no special installer spec; the README instructs 'npm install' which pulls node-fetch and its dependencies from the public npm registry — expected for a Node CLI but a moderate-risk install vector compared with instruction-only skills. No downloads from untrusted URLs or archive extraction are present.
Credentials
The skill only requires a single API key (AMAP_KEY), which is appropriate for this purpose. One caution: the key is appended to the MCP request URL (?key=...), which can be logged in transit or server logs — prefer a restricted API key (referrer/IP restrictions) and verify Amap's recommended auth method if leakage is a concern.
Persistence & Privilege
The skill does not request always:true, does not modify other skill configs, and does not claim persistent system-wide privileges. It behaves as a normal user-invokable Node CLI.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install amap-maps - 安装完成后，直接呼叫该 Skill 的名称或使用
/amap-maps触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.1
- Updated metadata section to include additional configuration details such as emoji, required binaries, environment variables, and primary environment variable.
- No changes to APIs, features, or command usage.
v1.0.0
Initial release of the amap-maps skill.
- Provides access to Amap LBS services via Streamable HTTP MCP.
- Supports geocoding (address <-> coordinates), route planning (driving, walking, cycling, transit), POI search, weather queries, distance measurement, and more.
- Includes 15 command-line tools covering common location and mapping workflows.
- Requires Node.js 18+ and AMAP_KEY environment variable.
- Offers detailed usage examples, workflows, and error handling guidance.
元数据
常见问题
amap-maps 是什么？
Amap LBS services. Call Amap services via Streamable HTTP MCP, supporting geocoding, route planning, POI search, weather query, distance measurement, and more. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 726 次。
如何安装 amap-maps？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install amap-maps」即可一键安装，无需额外配置。
amap-maps 是免费的吗？
是的，amap-maps 完全免费（开源免费），可自由下载、安装和使用。
amap-maps 支持哪些平台？
amap-maps 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 amap-maps？
由 elric2011（@elric2011）开发并维护，当前版本 v1.0.1。
推荐 Skills