← 返回 Skills 市场

Get public holidays by country and year

Name: Get public holidays by country and year
Author: javainthinking

作者 javainthinking · GitHub ↗ · v1.0.0

cross-platform ✓ 安全检测通过

553

总下载

当前安装

版本数

在 OpenClaw 中安装

/install apipick-public-holidays

功能描述

Query public holidays for any country and year using the apipick Public Holidays API. Supports 100+ countries identified by ISO 3166-1 alpha-2 country codes....

使用说明 (SKILL.md)

apipick Public Holidays

Query public holidays for 100+ countries by ISO country code and year.

Endpoint

GET https://www.apipick.com/api/holidays

Authentication: x-api-key: YOUR_API_KEY header required. Get a free API key at https://www.apipick.com/dashboard/api-keys

Request Parameters

Parameter	Required	Description
`country`	Yes	ISO 3166-1 alpha-2 code (e.g. `US`, `GB`, `CN`, `DE`, `JP`)
`year`	No	4-digit year (defaults to current year). Range: 1900 to current year + 10

GET /api/holidays?country=US&year=2026

Response

{
  "success": true,
  "code": 200,
  "message": "Holidays retrieved successfully",
  "data": {
    "country": "US",
    "country_name": "United States",
    "year": 2026,
    "total": 11,
    "holidays": [
      {"date": "2026-01-01", "name": "New Year's Day"},
      {"date": "2026-07-04", "name": "Independence Day"},
      {"date": "2026-12-25", "name": "Christmas Day"}
    ]
  },
  "credits_used": 1,
  "remaining_credits": 99
}

Error Codes

Code	Meaning
400	Invalid country code or year
401	Missing or invalid API key
402	Insufficient credits

Cost: 1 credit per request

Usage Pattern

Use $APIPICK_API_KEY env var as the x-api-key header value; if not set, ask the user for their apipick API key
Convert a country name to ISO code if the user provides a full name (e.g. "China" → CN, "United Kingdom" → GB)
Make the GET request with country and optional year
Present the holidays as a sorted list with dates and names

See references/api_reference.md for full response field descriptions.

安全使用建议

This skill is instruction-only and appears to only make authenticated requests to apipick.com using the APIPICK_API_KEY you provide. Before installing: (1) confirm you trust apipick.com and are willing to consume credits (the SKILL.md says 1 credit per request); (2) keep your APIPICK_API_KEY secret — do not paste it into public chat or share it; (3) expect the agent to prompt you for the key if the env var isn't set; (4) if you need stricter control, avoid allowing autonomous agent invocation or restrict when the skill can run. Because there is no packaged code, the main risk is accidental disclosure of your API key or unexpected API usage (billing/credits), not hidden binaries or downloads.

功能分析

Type: OpenClaw Skill Name: apipick-public-holidays Version: 1.0.0 The skill bundle is designed to query public holidays from the apipick.com API. All files consistently describe this functionality, requiring an API key via an environment variable or user prompt. There is no evidence of data exfiltration, malicious execution, persistence mechanisms, obfuscation, or prompt injection attempts against the AI agent. The instructions in SKILL.md are clear, directly related to the skill's stated purpose, and do not instruct the agent to perform any unauthorized or harmful actions.

能力评估

✓ Purpose & Capability

Name/description match the required resources and behavior. The only declared secret is APIPICK_API_KEY, which is exactly what's needed to call the apipick Public Holidays API.

✓ Instruction Scope

SKILL.md instructs the agent to use the APIPICK_API_KEY header, convert names to ISO codes if needed, call https://www.apipick.com/api/holidays, and present results. It does not ask to read unrelated files, access other credentials, or contact unexpected endpoints.

✓ Install Mechanism

No install spec and no code files — instruction-only skill. This minimizes disk/execute risk.

✓ Credentials

Only APIPICK_API_KEY is required and declared as the primary credential. That single API key is proportional to the stated task. The SKILL.md uses that env var consistently.

✓ Persistence & Privilege

always is false, no config paths requested, and the skill does not request persistent or elevated platform privileges. Autonomous invocation is enabled by default but not combined with other red flags.

如何使用

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

版本历史

v1.0.0

apipick-public-holidays 1.0.0 initial release: - Query public holidays for 100+ countries by ISO country code and year. - Returns sorted lists of holidays with official names and dates. - Requires an apipick API key via the `APIPICK_API_KEY` environment variable. - Supports country name to ISO code conversion. - Ideal for checking holidays, planning, or verifying if a date is a holiday.

元数据

Slug apipick-public-holidays

版本 1.0.0

许可证 —

累计安装 0

当前安装数 0

历史版本数 1

常见问题