← Back to Skills Marketplace
uynewnas

map-query

by Slava Chan · GitHub ↗ · v1.0.1 · MIT-0
cross-platform ✓ Security Clean
206
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install map-query
Description
Query nearby restaurants, shops, promotions, and POIs by address using AMap, Baidu, or Tencent Maps with geocoding and filters.
README (SKILL.md)

\r ---\r name: map-query\r description: Map Query Skill - Query nearby food and promotions by address, supports AMap/Baidu/Tencent Maps\r metadata:\r version: 1.0.0\r author: uynewnas\r category: location-services\r tags: [map, poi, food, location, amap, baidu, tencent]\r env:\r required:\r - name: AMAP_KEY\r description: AMap (高德地图) API Key\r required: false\r - name: BAIDU_MAP_KEY\r description: Baidu Maps API Key\r required: false\r - name: TENCENT_MAP_KEY\r description: Tencent Maps API Key\r required: false\r note: At least one map provider API key must be configured\r ---\r \r

Map Query Skill\r

\r Query nearby restaurants, shops, promotions and other POI information by specific address.\r \r

Core Features\r

\r

  • Address Geocoding: Convert detailed address to latitude and longitude coordinates\r
  • Nearby Search: Query POIs (Points of Interest) around specified location\r
  • Multi-map Support: Integrate AMap, Baidu Maps, Tencent Maps APIs\r
  • Food Search: Specialized search for nearby restaurants and food places\r
  • Promotions Search: Query nearby merchant promotions and deals\r \r

Supported Map Providers\r

\r | Provider | Features | Notes |\r |---------|---------|-------|\r | AMap (高德) | ✅ Geocoding, POI Search, Food Search | API Key required |\r | Baidu Maps | ✅ Geocoding, POI Search, Food Search | API Key required |\r | Tencent Maps | ✅ Geocoding, POI Search, Food Search | API Key required |\r \r

Main Functions\r

\r

1. Address Geocoding\r

  • Support detailed addresses: e.g., "No. 47, Shangjiao xx Street, Panyu District, Guangzhou"\r
  • Support city + landmark: e.g., "Beijing Tiananmen"\r
  • Auto-resolve and return coordinates\r \r

2. Nearby Search\r

  • Search by type: food, hotel, bank, gas station, etc.\r
  • Filter by distance: 1km, 2km, 5km, etc.\r
  • Sort by rating: prioritize high-rated merchants\r
  • Sort by distance: prioritize nearby merchants\r \r

3. Food Search\r

  • Cuisine filter: Sichuan, Cantonese, Japanese, etc.\r
  • Price range: per capita consumption range\r
  • Business hours filter\r
  • User rating filter\r \r

4. Promotions Search\r

  • Find nearby merchant deals\r
  • New store opening information\r
  • Limited-time discount activities\r \r

Dependencies\r

\r

  • Node.js >= 18\r
  • Map provider API Key (at least one configured)\r \r

Quick Start\r

\r

# Configure API Key\r
export AMAP_KEY=your_amap_api_key\r
export BAIDU_MAP_KEY=your_baidu_map_key\r
export TENCENT_MAP_KEY=your_tencent_map_key\r
\r
# Search for food near address\r
node scripts/search.mjs "Sanlitun, Chaoyang District, Beijing" --type food\r
\r
# Search for promotions\r
node scripts/search.mjs "Sanlitun, Chaoyang District, Beijing" --type promotion\r
```\r
\r
---\r
\r
## References\r
\r
- 12306 Skill: https://github.com/kirorab/12306-skill\r
- AMap API: https://lbs.amap.com/\r
- Baidu Maps API: https://lbsyun.baidu.com/\r
- Tencent Maps API: https://lbs.qq.com/\r
Usage Guidance
This package appears coherent for running local map/POI queries. Before installing: (1) only provide API keys with appropriate usage restrictions (IP/referrer limits) to limit misuse; (2) be aware that addresses and coordinates are sent to third-party map providers (AMap/Baidu/Tencent) when queries run; (3) verify you trust the skill source since it will execute JavaScript locally and make network requests; (4) ensure Node.js >=18 is used so global fetch is available. If you want higher assurance, ask the publisher for a verifiable homepage/repo or review the code locally before enabling the skill.
Capability Analysis
Type: OpenClaw Skill Name: map-query Version: 1.0.1 The map-query skill provides legitimate functionality for geocoding and searching for points of interest (food, promotions) using AMap, Baidu, and Tencent Map APIs. The implementation uses standard Node.js fetch calls to official API endpoints (e.g., restapi.amap.com, api.map.baidu.com) and requires user-provided API keys via environment variables. The code logic is transparent, lacks obfuscation, and contains no evidence of data exfiltration, malicious execution, or harmful prompt injection instructions.
Capability Assessment
Purpose & Capability
Name/description, SKILL.md, and the code files all implement geocoding and nearby-POI searches using AMap/Baidu/Tencent; requested env vars are exactly the provider API keys needed.
Instruction Scope
SKILL.md and CLAUDE.md only instruct checking/using map API keys and running the shipped scripts. The runtime instructions do not ask the agent to read unrelated files, credentials, or system paths.
Install Mechanism
No install spec or remote downloads are present; code is shipped in the skill bundle. There are no URL shorteners, external installers, or extract/execute steps that would raise concern.
Credentials
Only AMAP_KEY, BAIDU_MAP_KEY, and TENCENT_MAP_KEY are referenced and used. Those credentials are appropriate and necessary for the described functionality; no unrelated secrets or broad credentials are requested.
Persistence & Privilege
Flags show default behavior (not always), the skill does not request persistent system-wide privileges, and scripts do not modify other skill configs or system settings.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install map-query
  3. After installation, invoke the skill by name or use /map-query
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
- Added scripts for food search, geocoding, promotions, and general POI search: food.mjs, geocode.mjs, promotion.mjs, search.mjs. - Documented environment variable requirements for map provider API keys in SKILL.md.
v1.0.0
Initial release of map-query: - Query nearby food, shops, and promotions by address. - Supports geocoding and POI (Points of Interest) search. - Integrates AMap, Baidu Maps, and Tencent Maps APIs (API key required). - Specialized food search with cuisine, price, business hours, and rating filters. - Find nearby merchant promotions and deals.
Metadata
Slug map-query
Version 1.0.1
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 2
Frequently Asked Questions

What is map-query?

Query nearby restaurants, shops, promotions, and POIs by address using AMap, Baidu, or Tencent Maps with geocoding and filters. It is an AI Agent Skill for Claude Code / OpenClaw, with 206 downloads so far.

How do I install map-query?

Run "/install map-query" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is map-query free?

Yes, map-query is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does map-query support?

map-query is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created map-query?

It is built and maintained by Slava Chan (@uynewnas); the current version is v1.0.1.

💬 Comments