← Back to Skills Marketplace
187
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install map-address-query-skills
Description
Map service address lookup and distance-query workflow. MUST use this skill when the user asks for coordinates (坐标), latitude/longitude, POI locations (e.g.,...
Usage Guidance
This skill appears to do what it says: it downloads a third-party CLI from a GitHub release to query Tencent's Location Service and asks you to store your Tencent API key in ~/.qq_map_cli_config.json or an env var. Before installing or running: (1) verify the GitHub repository and release (scottkiss/qq-map-cli) and, if available, check release checksums or source code; (2) prefer supplying the minimum-scoped Tencent key and store it in an environment variable or secure store rather than committing it into project files; (3) be aware that running a downloaded binary can run arbitrary code — if you can't validate the binary, consider implementing equivalent calls directly to Tencent's API from audited code instead. If you want higher assurance, ask the publisher for source/build reproducibility or a checksum for the release artifacts.
Capability Analysis
Type: OpenClaw Skill
Name: map-address-query-skills
Version: 0.1.0
The skill downloads and executes a pre-compiled binary from an external GitHub repository (github.com/scottkiss/qq-map-cli) via the scripts/qq_map_cli.sh script. While this is functionally necessary for the stated purpose of providing a map query tool, the execution of unverified remote binaries is a high-risk behavior. There is no explicit evidence of intentional malice or data exfiltration in the provided scripts or instructions.
Capability Assessment
Purpose & Capability
Name/description (geocode, distance, Tencent Location Service) align with the included CLI and usage instructions. Requiring a Tencent Location Service key is expected; no unrelated credentials, binaries, or config paths are requested.
Instruction Scope
SKILL.md stays within mapping tasks: it instructs downloading a CLI, creating a home config (~/.qq_map_cli_config.json), and using the CLI for geocoding and distance queries. It does instruct persisting the user's Tencent key globally in their home config (expected for usability) but otherwise does not ask to read unrelated files or exfiltrate data.
Install Mechanism
The included script downloads a zip from a GitHub releases URL and unzips it into scripts/bin (then marks the binary executable). GitHub releases is a common host, but extracting and running a downloaded binary is an elevated-risk action; the behavior is coherent with the stated purpose but worth auditing before running.
Credentials
No required env vars are declared by the registry metadata. The tool accepts a Tencent API key via --key, config file, or QQ_MAP_KEY which is proportionate to the service it integrates with. There are no unrelated secrets requested.
Persistence & Privilege
Skill is not always-enabled and does not request system-wide changes beyond writing a config file in the user's home directory (~/.qq_map_cli_config.json) and placing a binary in the skill's scripts/bin folder. It does not modify other skills or system settings.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install map-address-query-skills - After installation, invoke the skill by name or use
/map-address-query-skills - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
- Initial release of map-address-query skill for querying addresses, coordinates, and calculating distances using Tencent map.
- Features address geocoding, address-to-address distance queries, and flexible coordinate or distance-matrix lookups.
- Provides detailed CLI setup and workflow, including API key management and config file usage.
- Supports structured (`--json`) and human-readable output modes for diverse use cases.
- Includes troubleshooting tips, especially for SSL errors on macOS.
- Designed to handle user queries for coordinates, POI locations, and travel metrics efficiently.
Metadata
Frequently Asked Questions
What is Map Address Query?
Map service address lookup and distance-query workflow. MUST use this skill when the user asks for coordinates (坐标), latitude/longitude, POI locations (e.g.,... It is an AI Agent Skill for Claude Code / OpenClaw, with 187 downloads so far.
How do I install Map Address Query?
Run "/install map-address-query-skills" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Map Address Query free?
Yes, Map Address Query is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Map Address Query support?
Map Address Query is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Map Address Query?
It is built and maintained by sirk (@scottkiss); the current version is v0.1.0.
More Skills