Weather Skill

Installation

npm

npm install -g skills-weather

pnpm

pnpm add -g skills-weather

Parameters

• -V, --version: output the version number
• -l, --location <string>: Location to get the weather for
• -d, --days <number>: Specify the number of days to get the weather forecast for.
• -h, --hours <number>: Specify the number of hours to get the weather forecast for.
• -f, --config <string>: Path to the config file
• -c, --coordinates <string>: Latitude and longitude to get the weather for (format: lon,lat)
• --help: display help for command

Parameter constraints:

• --location and --coordinates cannot be used together. You must provide at least one of them.
• --days and --hours cannot be used together. If neither is provided, real-time weather will be returned.

Environment variables:

• SKILLS_WEATHER_CONFIG_FILE_PATH: Optional environment variable to specify the path to the configuration file. If not provided, the skill will look for a default config file in the current directory.

Examples

Get real-time weather:

• Get real-time weather for New York: skills-weather -l "New York"
• Get real-time weather for specific coordinates: skills-weather -c "-74.0060,40.7128"
• Get real-time weather for London (with a specified config file): skills-weather -l "London" -f "/path/to/config.json"

Get daily weather forecasts:

• Get today's weather forecast for Futian District, Shenzhen: skills-weather -l "futian" -d 1
• Get Beijing's weather forecast for the next 3 days: skills-weather -l "北京" -d 3
• Get a one-month weather forecast for specific coordinates: skills-weather -c "116.4074,39.9042" -d 30
• Get Shanghai's weather forecast for the next 2 days (with a specified config file): skills-weather -l "上海" -d 2 -f "/path/to/config.json"

Get hourly weather forecasts:

• Get Guangzhou's weather forecast for the next 12 hours: skills-weather -l "广州" -h 12
• Get a 6-hour weather forecast for specific coordinates: skills-weather -c "121.4737,31.2304" -h 6
• Get Shenzhen's weather forecast for the next 24 hours (with a specified config file): skills-weather -l "深圳" -h 24 -f "/path/to/config.json"

Supported Weather Data Providers

• 和风天气 (QWeather)

Configuration File

和风天气

Default config file path: ~/.skills-weather-config.json

Example:

{
	"privateKey": "G7refSYx9TWAPADGuOdyGycWVNr0POaebYddeNtDjxSSN01b0165TITV9fA=",
	"appId": "BB9A36BAB1",
	"credentialId": "3207A9092A",
	"apiHost": "0dfe03a7c3.re.qweatherapi.com"
}

Field Descriptions

• privateKey: A private key provided by QWeather for authentication.
• appId: The application ID provided by QWeather to identify the app.
• credentialId: A credential ID provided by QWeather for authentication.
• apiHost: The host address of the QWeather API.