← 返回 Skills 市场

Japan Seasons API

Name: Japan Seasons API
Author: ko-syun

作者 Ko Syun / Gu Jun · GitHub ↗ · v1.0.0 · MIT-0

cross-platform ✓ 安全检测通过

122

总下载

当前安装

版本数

在 OpenClaw 中安装

/install japan-seasons

功能描述

Query Japanese seasonal data — cherry blossom forecasts, autumn foliage tracking, and festival search. Use when a user asks about sakura bloom dates, best ti...

使用说明 (SKILL.md)

Japan Seasons API

Query cherry blossom, autumn foliage, and festival data for Japan.

Setup

Get a free API key at https://jpseasons.dokos.dev/dashboard (100 req/day).

Store the key as an environment variable or pass directly in headers.

Base URL

https://jpseasons.dokos.dev

Authentication

All requests need X-API-Key header:

curl -H "X-API-Key: YOUR_KEY" https://jpseasons.dokos.dev/v1/sakura/forecast?city=tokyo

Endpoints

Sakura (Cherry Blossom)

# Current bloom status (which cities have bloomed)
curl -H "X-API-Key: $KEY" "https://jpseasons.dokos.dev/v1/sakura/status"

# Bloom forecast (historical average-based)
curl -H "X-API-Key: $KEY" "https://jpseasons.dokos.dev/v1/sakura/forecast?city=tokyo"

# Historical records (1953-present)
curl -H "X-API-Key: $KEY" "https://jpseasons.dokos.dev/v1/sakura/historical?city=tokyo"

# All 57 observation stations
curl -H "X-API-Key: $KEY" "https://jpseasons.dokos.dev/v1/sakura/locations"

# Travel recommendation
curl -H "X-API-Key: $KEY" "https://jpseasons.dokos.dev/v1/sakura/recommend?city=kyoto&dates=2026-03-25/2026-04-05"

Kouyou (Autumn Foliage)

Same pattern as sakura, under /v1/kouyou/:

status, forecast, historical?city=, locations, recommend?city=&dates=

Matsuri (Festivals)

# Search by region/month/category
curl -H "X-API-Key: $KEY" "https://jpseasons.dokos.dev/v1/matsuri/search?region=kansai&month=7"

# Upcoming festivals (next N days, default 30, max 90)
curl -H "X-API-Key: $KEY" "https://jpseasons.dokos.dev/v1/matsuri/upcoming?days=60"

# Festival detail (ID is kebab-case, e.g. gion-matsuri, aomori-nebuta)
curl -H "X-API-Key: $KEY" "https://jpseasons.dokos.dev/v1/matsuri/gion-matsuri"

Error Handling

401 — Missing or invalid API key
404 — Unknown city ID or festival ID
429 — Rate limit exceeded (100/day free, 10K/day pro)
400 — Invalid parameters (bad date format, missing required param)

Common City IDs

tokyo, osaka, kyoto, yokohama, nagoya, sapporo, fukuoka, sendai, hiroshima, kobe, naha, kagoshima, nagano, kanazawa, matsuyama

Regions

hokkaido, tohoku, kanto, chubu, kansai, chugoku, shikoku, kyushu, okinawa

Usage Pattern

Use web_fetch or exec (curl) to call endpoints
Parse JSON response
Present data to user in natural language

Example — answering "When should I visit Kyoto for cherry blossoms?":

curl -s -H "X-API-Key: $KEY" "https://jpseasons.dokos.dev/v1/sakura/recommend?city=kyoto&dates=2026-03-25/2026-04-10"

Response includes likelihood, confidence, best_days, and alternatives.

安全使用建议

This skill is coherent: it calls a third‑party API that requires an X-API-Key. Before installing, confirm the registry metadata is updated to declare the API key requirement (so the platform can surface the secret prompt), and only provide a key you trust to the jpseasons.dokos.dev service. Be aware the agent will make outbound HTTP requests (curl or web_fetch) to that domain and is subject to the service's rate limits (free tier 100/day). If you need stronger privacy, consider using a dedicated key with limited scope or rate limits, and verify the jpseasons.dokos.dev domain and dashboard are legitimate.

功能分析

Type: OpenClaw Skill Name: japan-seasons Version: 1.0.0 The skill is a standard API wrapper for retrieving Japanese seasonal data such as cherry blossom forecasts and festival information from jpseasons.dokos.dev. The documentation in SKILL.md provides clear instructions for API authentication and endpoint usage without any evidence of malicious intent, data exfiltration, or harmful prompt injection.

能力评估

ℹ Purpose & Capability

The SKILL.md documents endpoints for sakura, kouyou, and matsuri on https://jpseasons.dokos.dev which matches the skill's name and description. However, the registry metadata lists no required env vars or primary credential while the runtime instructions explicitly require an X-API-Key; this metadata omission is inconsistent.

✓ Instruction Scope

Instructions are narrow and consistent: call the documented API endpoints (via web_fetch or curl), parse JSON, and present results to the user. The instructions do reference an environment variable ($KEY) or passing the key in headers, which is expected for this API.

✓ Install Mechanism

No install spec and no code files — instruction-only skills have minimal disk footprint and nothing is downloaded or executed by default beyond normal network calls.

ℹ Credentials

The SKILL.md requires a per-user API key (X-API-Key) from jpseasons.dokos.dev, which is appropriate for this purpose. The registry metadata, however, does not declare any required env vars or primary credential; this mismatch should be resolved so users know what secrets to supply.

✓ Persistence & Privilege

The skill does not request persistent presence (always is false), does not modify other skills or system config, and does not declare writing to disk. Autonomous invocation is allowed (platform default) but is not combined with other concerning privileges.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install japan-seasons
安装完成后，直接呼叫该 Skill 的名称或使用 /japan-seasons 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.0.0

- Initial release of japan-seasons skill. - Provides endpoints for cherry blossom forecasts, autumn foliage tracking, and festival search in Japan. - Users can query bloom dates, historical data, and travel recommendations for sakura and kouyou. - Search for Japanese festivals by region, month, and category; view upcoming events and festival details. - Requires a free API key from https://jpseasons.dokos.dev/dashboard.

元数据

Slug japan-seasons

版本 1.0.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题