🎆 Japan Fireworks Live Feed (This Week's Hanabi Events)

Get a rolling 7-day feed of Japanese fireworks (hanabi) festivals — event name, date, prefecture, start time, venue, and GPS coordinates — sourced from hanabi.cloud, a specialist hanabi-event tracking site. Every run returns what's happening today through the next 6 days, nationwide.

Why this Actor

Fireworks season in Japan runs May–October with thousands of local events, most with no English coverage and no structured feed. Static "top 10 fireworks" listicles go stale within weeks. This Actor scrapes the site's own daily event pages — the same pages the site itself keeps current — so every run reflects what's actually happening this week, not a cached snapshot from months ago.

Sample output

{
  "event_name": "隅田川花火大会",
  "event_date": "2026-08-01",
  "prefecture": "東京都",
  "start_time": "19:00～",
  "location": "台東区・墨田区(隅田川)",
  "latitude": 35.7148,
  "longitude": 139.8003,
  "detail_url": "https://hanabi.cloud/html/Tokyo/tokyo/2026/2026-08-01_sumidagawa-hanabi.html",
  "scraped_at": "2026-08-01T11:30:37.935Z"
}

Every record includes source-verified coordinates ready to drop onto a map, and a link back to the event page for full details.

Who uses this

• Travel-app / itinerary-planner developers surfacing "what's happening near you this week" for visitors to Japan
• Tourism boards and local-event aggregators building a live events widget
• Map/dashboard builders needing geocoded event data with no manual lookup
• Anyone automating a weekly "upcoming fireworks" digest (Slack/LINE bot, newsletter)

Pricing

Pay per event: 1 fireworks-event charged per record returned. No subscription. A full unfiltered weekly run currently returns roughly 500 records — actual per-event rate is set in the Apify Store listing.

Input parameters

Optional. See .actor/input_schema.json for the authoritative schema.

Parameter	Description
prefectures	Filter to specific prefectures, exact Japanese name match (array). Omit for nationwide.

Data freshness & scope

Each run scrapes hanabi.cloud live for the current date through +6 days — data reflects what the site shows at run time, not a cached snapshot. This is a live/recurring dataset by design: re-run it weekly (or via Apify's scheduler) to keep results current. Only the site's explicitly robots.txt-permitted daily/today pages are used (/servlet/GetToday, /html/dayEvent/YYYYMMDD.html); the site's bulk database endpoints are intentionally never accessed. See DESIGN_NOTE.md for the robots.txt analysis.

---

For developers (this repo)

This is a lightweight-pipeline project (single DESIGN_NOTE.md instead of full SRS/SDD, unit tests only) — see DESIGN_NOTE.md for source/ToS/architecture notes.

Setup

$npm install

Run locally

npm start
# or via Apify CLI
npx apify run

Local runs write to storage/ (Apify SDK's local-dev storage emulation, gitignored) — no Apify account needed to test.

Tests

$npm test