dsh-social-insurance

In Chinese workplaces, the contribution bases, ratios, and caps for the five social insurances and the housing provident fund change from year to year. Doing the math by hand usually means cross-referencing several policy documents and risks missing a single detail. dsh-social-insurance turns that process into one clean tool call: pass in the region and parameters, and you get a line-by-line breakdown with plain-text explanations, eliminating the back-and-forth of table lookups.

The core capability is a tool called social_insurance that precisely calculates the base and amount for pension, medical, unemployment, work-injury, and maternity insurance, as well as the housing provident fund, based on the parameters you supply. Every line item is returned alongside a short textual note. The entire implementation runs in a pure Node environment with zero network calls, making it a natural fit for offline or intranet deployments where external APIs are unavailable or undesirable.

If you are a frontend or full-stack developer who needs to embed a reliable social-insurance calculator into an HR dashboard, a salary-trial widget, or any internal tool, this plugin offers a lightweight, fully local option with a simple invocation interface. The MIT license keeps integration friction-free for commercial projects as well.