{
  "data_type": "zidooka_calendar_agent_data_index",
  "generated_at": "2026-05-29T07:44:12.040Z",
  "locale": "ja-JP",
  "timezone": "Asia/Tokyo",
  "available_range": {
    "from": "2026-01-01",
    "to": "2028-12-31"
  },
  "years": [
    2026,
    2027,
    2028
  ],
  "layers": {
    "human_ui": {
      "description": "Human-facing calendar pages.",
      "lucky_calendar": "/jp/calendar",
      "caution_calendar": "/jp/avoid-calendar"
    },
    "static_agent_data": {
      "description": "CSV/JSON files for search crawlers and agents that need a broad data dump without API calls.",
      "labels": "/data/calendar/labels.json",
      "files": [
        "/data/calendar/days-2026.json",
        "/data/calendar/days-2026.csv",
        "/data/calendar/lucky-days-2026.json",
        "/data/calendar/lucky-days-2026.csv",
        "/data/calendar/avoid-days-2026.json",
        "/data/calendar/avoid-days-2026.csv",
        "/data/calendar/days-2027.json",
        "/data/calendar/days-2027.csv",
        "/data/calendar/lucky-days-2027.json",
        "/data/calendar/lucky-days-2027.csv",
        "/data/calendar/avoid-days-2027.json",
        "/data/calendar/avoid-days-2027.csv",
        "/data/calendar/days-2028.json",
        "/data/calendar/days-2028.csv",
        "/data/calendar/lucky-days-2028.json",
        "/data/calendar/lucky-days-2028.csv",
        "/data/calendar/avoid-days-2028.json",
        "/data/calendar/avoid-days-2028.csv"
      ]
    },
    "api": {
      "description": "Programmatic endpoints for embedded integrations that need filtering by date range, purpose, or profile.",
      "lucky_days": "/api/lucky-days",
      "lucky_days_today": "/api/lucky-days/today",
      "avoid_days": "/api/avoid-days",
      "avoid_days_today": "/api/avoid-days/today"
    }
  },
  "usage_notes": [
    "Use static_agent_data for broad crawling, retrieval, or one-shot ingestion.",
    "Use api endpoints for live integrations that need query parameters.",
    "Use human_ui URLs as citation/source links for end users.",
    "Calendar data is cultural reference data and does not guarantee outcomes."
  ]
}