amap

使用高德地图Web服务API进行地点搜索、天气查询和路线规划。

Security Scan

The skill's instructions and required inputs (an Amap Web Service API key and curl) match its stated purpose (place search, weather, routing); minor metadata mismatches are present but not harmful.

Purpose & Capability

The skill's name/description (Amap Web Service: search, weather, routing) align with the runtime instructions which call Amap endpoints. The SKILL.md and its embedded metadata require an AMAP_KEY and curl, which are appropriate. However, the registry metadata at the top of the report lists no required env vars or binaries — that discrepancy between registry fields and SKILL.md is inconsistent and should be reconciled.

Instruction Scope

SKILL.md contains concrete curl commands to official Amap endpoints and explicitly instructs the agent to read a single environment variable (AMAP_KEY). It does not ask the agent to read unrelated files, other credentials, or to transmit data to unexpected endpoints.

Install Mechanism

This is an instruction-only skill with no install spec (low risk). The SKILL.md metadata declares a dependency on curl; the absence of an install block means the environment must already provide curl. The registry summary omitted this dependency — check that the runtime environment provides curl or the agent will fail.

Credentials

The only secret the skill needs is AMAP_KEY (a Web Service API key), which is proportionate for calling Amap's APIs. The inconsistency: the top-level registry said 'Required env vars: none' while SKILL.md instructs users to set AMAP_KEY. Ensure the platform will supply the environment variable as documented and that it won't be logged or exposed.

Persistence & Privilege

The skill does not request always:true, has no install script, and does not seek persistent system-wide privileges. It is user-invocable and can be called autonomously (default platform behavior), which is expected for a service-integration skill.

Assessment

This skill appears to do what it claims: it issues curl requests to official Amap API endpoints and needs a single API key (AMAP_KEY). Before installing, confirm: (1) you will provide AMAP_KEY as an environment variable and the platform will not log or expose it; (2) the runtime has curl available (the SKILL.md metadata requires it); (3) you are comfortable with the Amap key's permissions and rate limits — avoid using a highly privileged or shared key. Also ask the publisher or registry admin to fix the metadata mismatch (registry fields vs SKILL.md) so required env vars and binaries are accurately declared. If the skill later requests additional credentials, downloads code from external URLs, or obtains always:true, re-evaluate (these would raise the risk).

高德地图 (Amap)

本技能使用高德地图 Web 服务 API 提供丰富的地理位置服务。

重要： 使用本技能前，你必须在高德开放平台申请一个 Web 服务 API Key，并将其设置为环境变量 AMAP_KEY。

export AMAP_KEY="你的Web服务API Key"

Clawdbot 会自动读取这个环境变量来调用 API。

何时使用 (触发条件)

当用户提出以下类型的请求时，应优先使用本技能：

• "帮我查一下[城市]的天气"
• "搜索[地点]附近的[东西]"
• "查找[关键词]的位置"
• "从[A]到[B]怎么走？"
• "查询[地址]的经纬度"
• "这个坐标[经度,纬度]是哪里？"

核心功能与用法

1. 天气查询

用于查询指定城市的实时天气或天气预报。

注意： API 需要城市的 adcode。如果不知道 adcode，可以先通过 行政区划查询 功能获取。

查询实时天气

# 将 [城市adcode] 替换为实际的行政区编码, 例如北京是 110000
curl "https://restapi.amap.com/v3/weather/weatherInfo?key=$AMAP_KEY&city=[城市adcode]&extensions=base"

查询天气预报

# 将 [城市adcode] 替换为实际的行政区编码
curl "https://restapi.amap.com/v3/weather/weatherInfo?key=$AMAP_KEY&city=[城市adcode]&extensions=all"

2. 地点搜索 (POI)

用于根据关键字在指定城市搜索地点信息。

# 将 [关键词] 和 [城市] 替换为用户提供的内容
curl "https://restapi.amap.com/v3/place/text?key=$AMAP_KEY&keywords=[关键词]&city=[城市]"

3. 驾车路径规划

用于规划两个地点之间的驾车路线。

注意： API 需要起终点的经纬度坐标。如果用户提供的是地址，需要先通过 地理编码 功能将地址转换为坐标。

# 将 [起点经纬度] 和 [终点经纬度] 替换为实际坐标，格式为 "经度,纬度"
curl "https://restapi.amap.com/v3/direction/driving?key=$AMAP_KEY&origin=[起点经纬度]&destination=[终点经纬度]"

4. 地理编码 (地址 → 坐标)

将结构化的地址信息转换为经纬度坐标。

# 将 [地址] 替换为用户提供的地址
curl "https://restapi.amap.com/v3/geocode/geo?key=$AMAP_KEY&address=[地址]"

5. 逆地理编码 (坐标 → 地址)

将经纬度坐标转换为结构化的地址信息。

# 将 [经纬度] 替换为实际坐标，格式为 "经度,纬度"
curl "https://restapi.amap.com/v3/geocode/regeo?key=$AMAP_KEY&location=[经纬度]"

6. 行政区划查询 (获取 adcode)

用于查询省、市、区、街道的行政区划信息，包括 adcode 和边界。

# 将 [关键词] 替换为城市或区域名称，例如 "北京市"
curl "https://restapi.amap.com/v3/config/district?key=$AMAP_KEY&keywords=[关键词]&subdistrict=0"