← Back to Skills Marketplace
726
Downloads
1
Stars
8
Active Installs
2
Versions
Install in OpenClaw
/install amap-maps
Description
Amap LBS services. Call Amap services via Streamable HTTP MCP, supporting geocoding, route planning, POI search, weather query, distance measurement, and more.
README (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
Usage Guidance
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.
Capability Analysis
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.
Capability Assessment
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.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install amap-maps - After installation, invoke the skill by name or use
/amap-maps - Provide required inputs per the skill's parameter spec and get structured output
Version History
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.
Metadata
Frequently Asked Questions
What is amap-maps?
Amap LBS services. Call Amap services via Streamable HTTP MCP, supporting geocoding, route planning, POI search, weather query, distance measurement, and more. It is an AI Agent Skill for Claude Code / OpenClaw, with 726 downloads so far.
How do I install amap-maps?
Run "/install amap-maps" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is amap-maps free?
Yes, amap-maps is completely free (open-source). You can download, install and use it at no cost.
Which platforms does amap-maps support?
amap-maps is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created amap-maps?
It is built and maintained by elric2011 (@elric2011); the current version is v1.0.1.
More Skills