Social Security Fund

全国社保公积金查询助手。支持查询社保缴纳记录、公积金余额、五险一金计算、退休金估算。覆盖北京、上海、广州、深圳、杭州、成都等主要城市。

社保公积金查询助手 🇨🇳

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

✨ 核心功能

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

---

🎯 触发条件

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

社保相关

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

公积金相关

• "公积金怎么查"
• "公积金贷款额度"
• "公积金提取条件"
• "公积金余额多少"

计算相关

• "五险一金怎么算"
• "月薪 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

---

📊 输出示例

五险一金计算

text

💰 五险一金计算结果
━━━━━━━━━━━━━━━━
📍 城市：北京
💵 税前工资：¥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

退休金估算

text

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

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

📉 养老金替代率：54.0%

查询指引

text

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

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

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

---

🗺️ 支持城市

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

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

---

📦 文件结构

text

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	gjj.beijing.gov.cn	12333 / 12329
上海	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 本项目
2. 创建功能分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 开启 Pull Request

---

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