Weather Search

Query real-time weather information using Amap (高德地图) Weather API. Use when user asks about weather, temperature, wind, humidity for Chinese cities. Requires...

Security Scan

The skill behavior matches a simple Amap weather fetcher, but the package metadata omits the required AMAP_API_KEY and there are minor operational/privacy issues (API key appears in request URLs), so double-check before installing.

Purpose & Capability

Name/description, SKILL.md, and weather.sh consistently implement queries to Amap's weather REST API — that capability aligns with the stated purpose. However, the registry metadata lists no required environment variables or primary credential while the SKILL.md and weather.sh clearly require an AMAP_API_KEY, which is an incoherence in the manifest.

Instruction Scope

Runtime instructions and the script are narrowly scoped to building a curl request to restapi.amap.com and formatting the JSON. They do not read unrelated files or contact unexpected endpoints. Operational/privacy note: examples and the script embed the API key in the request URL which can expose the key in shell history, command logs, or process listings on multi-user systems.

Install Mechanism

Instruction-only skill with one small included script and no install spec — nothing is downloaded or executed during install. Risk from install mechanism is low.

Credentials

The only sensitive credential actually required is AMAP_API_KEY, which is proportionate to the functionality. However the registry metadata omitted declaring this required env var / primary credential; that mismatch is concerning because automated permission prompts or policy checks may not surface the need for the key. No other unrelated credentials are requested.

Persistence & Privilege

No elevated privileges requested. always is false, the skill does not declare permanent system presence, and it does not modify other skills or system configuration.

What to consider before installing

This skill appears to do exactly what it claims — call Amap's REST weather API — but the package metadata failed to declare the required AMAP_API_KEY. Before installing: (1) verify the skill listing is updated to require AMAP_API_KEY (or be prepared to set the env var yourself); (2) avoid pasting your API key directly into command lines on shared systems (the examples put the key in the URL which may leak via history/ps); (3) run the included weather.sh in a sandbox or inspect it (it is short and readable) and restrict the API key to least-privilege / per-application keys if possible; (4) if you need stricter guarantees, ask the publisher to correct the manifest so automated tooling can surface the credential requirement.

Weather Search Skill

Query real-time weather information using Amap (高德地图) Weather API.

API Documentation

https://lbs.amap.com/api/javascript-api/guide/services/weather

Prerequisites

1. Get Amap API Key

   • Visit: https://console.amap.com/
   • Create an application
   • Get your Web Service (Key)

2. Set Environment Variable

   export AMAP_API_KEY="your_api_key_here"
   

Usage

Query Weather by City Name

curl -X GET "https://restapi.amap.com/v3/weather/weatherInfo?city=BEIJING&key=YOUR_API_KEY&output=json"

Query Weather by City Code

curl -X GET "https://restapi.amap.com/v3/weather/weatherInfo?city=110000&key=YOUR_API_KEY&output=json"

Query Multiple Cities

curl -X GET "https://restapi.amap.com/v3/weather/weatherInfo?city=BEIJING|SHANGHAI|GUANGZHOU&key=YOUR_API_KEY&output=json"

Query by Coordinates (Latitude, Longitude)

curl -X GET "https://restapi.amap.com/v3/weather/weatherInfo?location=116.40,39.90&key=YOUR_API_KEY&output=json"

API Parameters

Parameter	Type	Required	Description
city	String	Yes (or location)	City name or city code
location	String	Yes (or city)	Format: longitude,latitude
key	String	Yes	Amap API Key
output	String	No	Response format: json or xml (default: json)

Response Example

{
  "status": "1",
  "infocode": "10000",
  "info": "Query Successful",
  "count": "1",
  "lives": [
    {
      "province": "Beijing",
      "city": "Beijing",
      "adcode": "110000",
      "weather": "Clear",
      "temperature": "25",
      "winddirection": "North",
      "windpower": "2",
      "humidity": "45",
      "reporttime": "2024-01-15 12:00:00"
    }
  ]
}

Quick Start Script

Create a weather query script:

#!/bin/bash
# weather.sh

API_KEY="${AMAP_API_KEY:-your_api_key_here}"
CITY="$1"

if [ -z "$CITY" ]; then
    echo "Usage: weather.sh <city_name_or_code>"
    exit 1
fi

curl -s "https://restapi.amap.com/v3/weather/weatherInfo?city=${CITY}&key=${API_KEY}&output=json" | jq '.'

Make it executable:

chmod +x weather.sh
./weather.sh BEIJING

City Code Reference

City	Code
Beijing	110000
Shanghai	310000
Guangzhou	440100
Shenzhen	440300
Hangzhou	330100
Chengdu	510100
Wuhan	420100
Xi'an	610100

Notes

• API Key is required for all requests
• Free tier: 1000 requests/day
• Response includes: weather condition, temperature, wind direction, wind power, humidity
• Supports both Chinese city names and city codes