social-security-fund

by testmtcode

Install this Skill

curl -fsSL -o social-security-fund.zip https://skill.seembox.com/api/v1/skills/social-security-fund/download && unzip social-security-fund.zip

Download social-security-fund.zip

SKILL.md About

---
name: social-security-fund
description: "全国社保公积金查询助手。支持查询社保缴纳记录、公积金余额、五险一金计算、退休金估算。覆盖北京、上海、广州、深圳、杭州、成都等主要城市。"
version: 1.0.0
author: testc0de
license: MIT-0
tags:
  - 社保
  - 公积金
  - 五险一金
  - 退休金
  - 计算器
  - 查询
---

# 社保公积金查询助手 🇨🇳

> 🏢 打工人必备工具 —— 一键查询社保公积金，轻松计算五险一金，精准估算退休金

## ✨ 核心功能

| 功能 | 描述 | 适用场景 |
|------|------|---------|
| 📋 **社保查询** | 查询缴纳记录、缴费基数、账户余额 | 换工作、落户、买房资格 |
| 🏦 **公积金查询** | 查询余额、缴存记录、贷款额度估算 | 买房、租房、提取 |
| 💰 **五险一金计算** | 计算个人/企业缴纳部分、实发工资 | 谈薪资、算成本 |
| 👴 **退休金估算** | 根据缴费年限估算每月养老金 | 养老规划 |

---

## 🎯 触发条件

当用户询问以下内容时，使用此技能：

### 社保相关
- "查询我的社保"
- "社保怎么查"
- "社保缴纳比例是多少"
- "社保断了怎么办"
- "我的社保交了多久了"

### 公积金相关
- "公积金怎么查"
- "公积金贷款额度"
- "公积金提取条件"
- "公积金余额多少"

### 计算相关
- "五险一金怎么算"
- "月薪 1 万到手多少"
- "退休金估算"
- "公司用人成本怎么算"

---

## 🚀 快速使用

### 方式一：统一入口（推荐）

```bash
# 五险一金计算
python3 scripts/check_deals.py calculate --salary 10000 --city 北京

# 社保查询指引
python3 scripts/check_deals.py social-security --city 上海 --guide

# 公积金查询指引
python3 scripts/check_deals.py fund --city 深圳 --guide

# 退休金估算
python3 scripts/check_deals.py pension --years 25 --avg-salary 8000
```

### 方式二：独立脚本

```bash
# 五险一金计算
python3 scripts/calculate.py --salary 10000 --city 北京

# 社保查询（模拟）
python3 scripts/query_social_security.py --city 北京 --idcard 110101199001011234

# 公积金查询（模拟）
python3 scripts/query_fund.py --city 上海 --account 123456789

# 退休金估算
python3 scripts/pension_estimate.py --years 25 --avg-salary 8000
```

### 方式三：JSON 输出（程序调用）

```bash
python3 scripts/calculate.py --salary 10000 --city 北京 --json
```

---

## 📊 输出示例

### 五险一金计算

```
💰 五险一金计算结果
━━━━━━━━━━━━━━━━
📍 城市：北京
💵 税前工资：¥10,000.00
📊 缴费基数：¥10,000.00
🏦 公积金比例：12%

👤 个人缴纳部分：
   • 养老保险：¥800.00
   • 医疗保险：¥200.00
   • 失业保险：¥50.00
   • 住房公积金：¥1,200.00
   ─────────────
   • 个人合计：¥2,250.00 (22.5%)

🏢 企业缴纳部分：
   • 养老保险：¥1,600.00
   • 医疗保险：¥1,000.00
   • 失业保险：¥50.00
   • 工伤保险：¥40.00
   • 生育保险：¥80.00
   • 住房公积金：¥1,200.00
   ─────────────
   • 企业合计：¥3,970.00 (39.7%)

📋 最终结果：
   • 个人所得税：¥82.50
   • 实发工资：¥7,667.50
   • 企业用人成本：¥13,970.00
```

### 退休金估算

```
👴 退休金估算结果
━━━━━━━━━━━━━━━━
📊 缴费年限：25 年
💵 平均缴费工资：¥8,000.00
📍 当地社平工资：¥10,000.00

💰 每月养老金：
   • 基础养老金：¥2,250.00
   • 个人账户养老金：¥2,071.94
   ─────────────
   • 合计：¥4,321.94/月

📉 养老金替代率：54.0%
```

### 查询指引

```
🏦 深圳公积金查询指引
━━━━━━━━━━━━━━━━
🏛️ 机构：深圳市住房公积金管理中心
🌐 官网：http://zjj.sz.gov.cn/
🔗 查询入口：https://zjj.sz.gov.cn/ztzl/zwfw/gjjzhfw/
📞 热线：0755-12329

📱 查询方式：
   1. 官方网站查询
   2. 12329 热线查询
   3. 公积金 APP 查询
   4. 支付宝市民中心
   5. 微信城市服务
   6. 公积金柜台查询

📝 需要准备：
   • 身份证号
   • 公积金账号（可选）
   • 手机号（接收验证码）
```

---

## 🗺️ 支持城市

| 城市 | 社保 | 公积金 | 费率配置 |
|------|------|--------|---------|
| 🇨🇳 北京 | ✅ | ✅ | ✅ |
| 🇨🇳 上海 | ✅ | ✅ | ✅ |
| 🇨🇳 广州 | ✅ | ✅ | ✅ |
| 🇨🇳 深圳 | ✅ | ✅ | ✅ |
| 🇨🇳 杭州 | ✅ | ✅ | ✅ |
| 🇨🇳 成都 | ✅ | ✅ | ✅ |

> 💡 更多城市持续更新中...

---

## 📦 文件结构

```
skills/social-security-fund/
├── SKILL.md                    # 技能定义（本文件）
├── README.md                   # 快速入门
├── requirements.txt            # Python 依赖
├── scripts/
│   ├── city_rates.py           # 城市费率配置（6 城）
│   ├── calculate.py            # 五险一金计算器
│   ├── pension_estimate.py     # 退休金估算工具
│   ├── query_social_security.py # 社保查询工具
│   ├── query_fund.py           # 公积金查询工具
│   └── check_deals.py          # 统一入口脚本
├── cache/                      # 缓存目录（可选）
│   └── last_query.json         # 上次查询结果
└── docs/                       # 文档目录（可选）
    └── api_reference.md        # API 参考文档
```

---

## 🔧 安装与配置

### 安装依赖

```bash
cd skills/social-security-fund
pip3 install -r requirements.txt
```

### 依赖说明

| 依赖 | 版本 | 用途 |
|------|------|------|
| `requests` | >=2.28.0 | HTTP 请求 |
| `beautifulsoup4` | >=4.11.0 | 网页解析（可选） |

---

## 📋 参数说明

### calculate.py - 五险一金计算

| 参数 | 必填 | 说明 | 示例 |
|------|------|------|------|
| `--salary` | ✅ | 税前月薪 | `10000` |
| `--city` | ❌ | 城市名称，默认北京 | `上海` |
| `--fund-ratio` | ❌ | 公积金比例 (0.05-0.12) | `0.12` |
| `--json` | ❌ | JSON 格式输出 | - |

### pension_estimate.py - 退休金估算

| 参数 | 必填 | 说明 | 示例 |
|------|------|------|------|
| `--years` | ✅ | 缴费年限 | `25` |
| `--avg-salary` | ✅ | 平均缴费工资 | `8000` |
| `--local-avg` | ❌ | 当地社平工资，默认 10000 | `12000` |
| `--balance` | ❌ | 个人账户余额 | `100000` |
| `--retirement-age` | ❌ | 退休年龄，默认 60 | `55` |
| `--json` | ❌ | JSON 格式输出 | - |

### query_social_security.py / query_fund.py - 查询工具

| 参数 | 必填 | 说明 | 示例 |
|------|------|------|------|
| `--city` | ❌ | 城市名称，默认北京 | `深圳` |
| `--idcard` / `--account` | ❌ | 身份证/账号（模拟用） | `110101***` |
| `--guide` | ❌ | 仅显示查询指引 | - |
| `--json` | ❌ | JSON 格式输出 | - |

---

## 📊 费率参考 (2024 年)

### 北京

| 项目 | 个人比例 | 企业比例 | 缴费基数范围 |
|------|---------|---------|-------------|
| 养老保险 | 8% | 16% | ¥6,326 - ¥33,891 |
| 医疗保险 | 2% | 10% | - |
| 失业保险 | 0.5% | 0.5% | - |
| 工伤保险 | 0% | 0.4% | - |
| 生育保险 | 0% | 0.8% | - |
| 住房公积金 | 5-12% | 5-12% | - |

### 上海

| 项目 | 个人比例 | 企业比例 | 缴费基数范围 |
|------|---------|---------|-------------|
| 养老保险 | 8% | 16% | ¥7,310 - ¥36,921 |
| 医疗保险 | 2% | 10% | - |
| 失业保险 | 0.5% | 0.5% | - |
| 工伤保险 | 0% | 0.25% | - |
| 生育保险 | 0% | 1% | - |
| 住房公积金 | 5-7% | 5-7% | - |

### 深圳

| 项目 | 个人比例 | 企业比例 | 缴费基数范围 |
|------|---------|---------|-------------|
| 养老保险 | 8% | 15% | ¥3,523 - ¥26,421 |
| 医疗保险 | 2% | 6% | - |
| 失业保险 | 0.3% | 0.7% | - |
| 工伤保险 | 0% | 0.5% | - |
| 生育保险 | 0% | 0.5% | - |
| 住房公积金 | 5-12% | 5-12% | - |

> ⚠️ 费率政策可能调整，请以当地人社局/公积金中心公布为准

---

## ⚠️ 注意事项

### 隐私保护
- 🔒 身份证号等敏感信息仅用于查询，**不会存储或上传**
- 🔒 所有计算在本地完成，数据不出设备

### 数据说明
- 📊 查询结果为**模拟数据**，实际数据请通过官方渠道查询
- 📊 费率数据参考 2024 年各地公布标准，可能随政策调整
- 📊 退休金估算为理论值，实际金额以社保局核算为准

### 地区差异
- 🗺️ 各城市社保/公积金政策不同
- 🗺️ 缴费基数上下限每年调整
- 🗺️ 部分城市有特殊政策（如深圳分档缴费）

### 查询限制
- 🌐 实际查询需要登录各地官方系统
- 🌐 部分城市支持 API，部分需要网页解析
- 🌐 建议优先使用官方 APP/小程序查询

---

## 🔗 官方查询渠道

| 城市 | 社保官网 | 公积金官网 | 热线 |
|------|---------|-----------|------|
| 北京 | [rsj.beijing.gov.cn](http://rsj.beijing.gov.cn/) | [gjj.beijing.gov.cn](http://gjj.beijing.gov.cn/) | 12333 / 12329 |
| 上海 | [rsj.sh.gov.cn](http://rsj.sh.gov.cn/) | [www.shgjj.com](http://www.shgjj.com/) | 12333 / 12329 |
| 广州 | [rsj.gz.gov.cn](http://rsj.gz.gov.cn/) | [gjj.gz.gov.cn](http://gjj.gz.gov.cn/) | 12333 / 12329 |
| 深圳 | [hrss.sz.gov.cn/szsi/](http://hrss.sz.gov.cn/szsi/) | [zjj.sz.gov.cn](http://zjj.sz.gov.cn/) | 12333 / 12329 |
| 杭州 | [hrss.hangzhou.gov.cn](http://hrss.hangzhou.gov.cn/) | [gjj.hangzhou.gov.cn](http://gjj.hangzhou.gov.cn/) | 12333 / 12329 |
| 成都 | [cdhrss.chengdu.gov.cn](http://cdhrss.chengdu.gov.cn/) | [gjj.chengdu.gov.cn](http://gjj.chengdu.gov.cn/) | 12333 / 12329 |

---

## 🛣️ 开发路线图

### v1.0 (当前版本)
- ✅ 五险一金计算（6 城）
- ✅ 退休金估算
- ✅ 社保/公积金查询指引

### v1.1 (计划中)
- [ ] 更多城市支持（武汉、重庆、南京等）
- [ ] 社保断缴补缴计算
- [ ] 生育津贴计算

### v1.2 (计划中)
- [ ] 对接官方 API（部分城市）
- [ ] 异地就医备案指引
- [ ] 社保转移接续指引

### v2.0 (未来)
- [ ] 公积金提取在线办理指引
- [ ] 工伤认定查询
- [ ] 失业保险金申领指引

---

## 📝 更新日志

### v1.0.0 (2026-03-16)
- 🎉 初始发布
- ✅ 支持 6 个城市费率配置
- ✅ 五险一金计算器
- ✅ 退休金估算工具
- ✅ 社保/公积金查询指引

---

## 📄 许可证

**MIT-0** - 自由使用、修改、分发，无需署名

---

## 🙋 常见问题

### Q: 为什么查询结果是模拟数据？
A: 各地社保/公积金系统独立，没有统一公开 API。本技能提供官方查询入口指引，帮助用户快速找到正确的查询渠道。

### Q: 如何获取真实数据？
A: 请使用各地官方渠道：
- 官方网站（见上方链接）
- 12333/12329 热线
- 支付宝/微信城市服务
- 官方 APP

### Q: 可以添加我所在的城市吗？
A: 欢迎贡献！请在 `scripts/city_rates.py` 中添加你所在城市的费率配置，然后提交 PR。

### Q: 计算结果准确吗？
A: 五险一金计算基于各地公布的费率标准，结果可靠。退休金估算为理论值，实际金额会受社平工资增长、政策调整等因素影响。

---

## 🤝 贡献指南

欢迎提交 Issue 和 PR！

1. Fork 本项目
2. 创建功能分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 开启 Pull Request

---

**🎯 让社保公积金查询更简单！**

_meta.json Metadata

{
  "ownerId": "kn78a26zm5scs7h8kdj55vw2hd82zj5j",
  "publishedAt": 1773659132644,
  "slug": "social-security-fund",
  "version": "1.0.1"
}