社保公积金查询助手 🇨🇳
🏢 打工人必备工具 —— 一键查询社保公积金,轻松计算五险一金,精准估算退休金
✨ 核心功能
| 功能 | 描述 | 适用场景 |
|---|
| 📋 社保查询 | 查询缴纳记录、缴费基数、账户余额 | 换工作、落户、买房资格 |
| 🏦 公积金查询 |
查询余额、缴存记录、贷款额度估算 | 买房、租房、提取 |
| 💰
五险一金计算 | 计算个人/企业缴纳部分、实发工资 | 谈薪资、算成本 |
| 👴
退休金估算 | 根据缴费年限估算每月养老金 | 养老规划 |
🎯 触发条件
当用户询问以下内容时,使用此技能:
社保相关
- - "查询我的社保"
- "社保怎么查"
- "社保缴纳比例是多少"
- "社保断了怎么办"
- "我的社保交了多久了"
公积金相关
- - "公积金怎么查"
- "公积金贷款额度"
- "公积金提取条件"
- "公积金余额多少"
计算相关
- - "五险一金怎么算"
- "月薪 1 万到手多少"
- "退休金估算"
- "公司用人成本怎么算"
🚀 快速使用
方式一:统一入口(推荐)
CODEBLOCK0
方式二:独立脚本
CODEBLOCK1
方式三:JSON 输出(程序调用)
CODEBLOCK2
📊 输出示例
五险一金计算
CODEBLOCK3
退休金估算
CODEBLOCK4
查询指引
CODEBLOCK5
🗺️ 支持城市
✅ | ✅ | ✅ |
| 🇨🇳 广州 | ✅ | ✅ | ✅ |
| 🇨🇳 深圳 | ✅ | ✅ | ✅ |
| 🇨🇳 杭州 | ✅ | ✅ | ✅ |
| 🇨🇳 成都 | ✅ | ✅ | ✅ |
💡 更多城市持续更新中...
📦 文件结构
CODEBLOCK6
🔧 安装与配置
安装依赖
CODEBLOCK7
依赖说明
| 依赖 | 版本 | 用途 |
|---|
| INLINECODE0 | >=2.28.0 | HTTP 请求 |
| INLINECODE1 |
>=4.11.0 | 网页解析(可选) |
📋 参数说明
calculate.py - 五险一金计算
| 参数 | 必填 | 说明 | 示例 |
|---|
| INLINECODE2 | ✅ | 税前月薪 | INLINECODE3 |
| INLINECODE4 |
❌ | 城市名称,默认北京 |
上海 |
|
--fund-ratio | ❌ | 公积金比例 (0.05-0.12) |
0.12 |
|
--json | ❌ | JSON 格式输出 | - |
pension_estimate.py - 退休金估算
| 参数 | 必填 | 说明 | 示例 |
|---|
| INLINECODE9 | ✅ | 缴费年限 | INLINECODE10 |
| INLINECODE11 |
✅ | 平均缴费工资 |
8000 |
|
--local-avg | ❌ | 当地社平工资,默认 10000 |
12000 |
|
--balance | ❌ | 个人账户余额 |
100000 |
|
--retirement-age | ❌ | 退休年龄,默认 60 |
55 |
|
--json | ❌ | JSON 格式输出 | - |
querysocialsecurity.py / query_fund.py - 查询工具
| 参数 | 必填 | 说明 | 示例 |
|---|
| INLINECODE20 | ❌ | 城市名称,默认北京 | INLINECODE21 |
| INLINECODE22 / INLINECODE23 |
❌ | 身份证/账号(模拟用) |
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.sh.gov.cn |
www.shgjj.com | 12333 / 12329 |
| 广州 |
rsj.gz.gov.cn |
gjj.gz.gov.cn | 12333 / 12329 |
| 深圳 |
hrss.sz.gov.cn/szsi/ |
zjj.sz.gov.cn | 12333 / 12329 |
| 杭州 |
hrss.hangzhou.gov.cn |
gjj.hangzhou.gov.cn | 12333 / 12329 |
| 成都 |
cdhrss.chengdu.gov.cn |
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 本项目
- 创建功能分支 (
git checkout -b feature/AmazingFeature) - 提交更改 (
git commit -m 'Add some AmazingFeature') - 推送到分支 (
git push origin feature/AmazingFeature) - 开启 Pull Request
🎯 让社保公积金查询更简单!
社保公积金查询助手 🇨🇳
🏢 打工人必备工具 —— 一键查询社保公积金,轻松计算五险一金,精准估算退休金
✨ 核心功能
| 功能 | 描述 | 适用场景 |
|---|
| 📋 社保查询 | 查询缴纳记录、缴费基数、账户余额 | 换工作、落户、买房资格 |
| 🏦 公积金查询 |
查询余额、缴存记录、贷款额度估算 | 买房、租房、提取 |
| 💰
五险一金计算 | 计算个人/企业缴纳部分、实发工资 | 谈薪资、算成本 |
| 👴
退休金估算 | 根据缴费年限估算每月养老金 | 养老规划 |
🎯 触发条件
当用户询问以下内容时,使用此技能:
社保相关
- - 查询我的社保
- 社保怎么查
- 社保缴纳比例是多少
- 社保断了怎么办
- 我的社保交了多久了
公积金相关
- - 公积金怎么查
- 公积金贷款额度
- 公积金提取条件
- 公积金余额多少
计算相关
- - 五险一金怎么算
- 月薪 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
socialsecurity.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 # 退休金估算工具
│ ├── querysocialsecurity.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 格式输出 | - |
querysocialsecurity.py / query_fund.py - 查询工具
| 参数 | 必填 | 说明 | 示例 |
|---|
| --city | ❌ | 城市名称,默认北京 | 深圳 |
| --idcard / --account |
❌ | 身份证/账号(模拟用) | 110101
* |
| --guide | ❌ | 仅显示查询指引 | - |
| --json | ❌ | JSON 格式输出 | - |
📊 费率参考 (2024