Malaysia Statutory Rates

Malaysian statutory rate data — EPF, SOCSO, EIS, PCB, minimum wage, HRDF, public holidays.

Data only, no calculation engine.

Install

pip install malaysia-statutory-rates

For scraping:

pip install malaysia-statutory-rates[scraper]

Quick Start

Python

from malaysia_statutory_rates import load_rates

rates = load_rates()

# EPF rates
epf = rates["epf_rates"]
employee_rate = epf["rates"]["malaysian_pr_nonmy_before_aug98_below_60"]["employee"]["rate"]  # 0.11
employer_rate = epf["rates"]["malaysian_pr_nonmy_before_aug98_below_60"]["employer"]["wage_lte_5000"]["rate"]  # 0.13

# Minimum wage
mw = rates["minimum_wage"]
min_salary = mw["rates"]["nationwide"]["monthly"]  # 1700

# SOCSO wage ceiling
socso = rates["socso_rates"]
ceiling = socso["wage_ceiling"]  # 6000

# Public holidays
holidays = rates["public_holidays"]
national = [h for h in holidays["holidays"] if h.get("national")]

CLI

malaysia-statutory-rates show
malaysia-statutory-rates show epf
malaysia-statutory-rates show holidays
malaysia-statutory-rates scrape --all

Data Files

Scraping

Scrapers fetch data from government websites. httpx is used first; blocked sites (kwsp.gov.my, hrdcorp.gov.my) fall back to Firecrawl.

Setup

pip install malaysia-statutory-rates[scraper]
cp .env.example .env  # add Firecrawl API key if needed

Run

malaysia-statutory-rates scrape --all

from malaysia_statutory_rates.scrapers import run_scrapers
results = run_scrapers()  # {"epf_rates": True, "minimum_wage": False, ...}

How it works

1. Checks local cache (.cache/fetch/) — returns if < 24h old
2. Checks robots.txt — skips if disallowed
3. Tries httpx first (no API cost)
4. Falls back to Firecrawl on 403/429 or JS-only pages (1 credit)
5. Caches responses for 24 hours
6. Writes to data/*.json with _metadata (scraped_at, source)
7. Change detection — only writes if data changed

Sources

Scraper Status

PDF Parsing

SOCSO and EIS rate tables (65 wage brackets each) are parsed from the PERKESO 2025 Booklet using pymupdf. Pages 36–39 for Act 4, 52–55 for Act 800.

Disclaimer

Data scraped from official government websites. Verify rates against official sources before making payroll or tax decisions.

License

MIT