社保公积金查询助手 🇨🇳

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

✨ 核心功能

🎯 触发条件

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

社保相关

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

公积金相关

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

计算相关

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

🚀 快速使用

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

# 五险一金计算
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

方式二：独立脚本

# 五险一金计算
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 输出（程序调用）

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 参考文档

🔧 安装与配置

安装依赖

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

依赖说明

📋 参数说明

calculate.py - 五险一金计算

pension_estimate.py - 退休金估算

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

📊 费率参考 (2024 年)

北京

上海

深圳

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

⚠️ 注意事项

隐私保护

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

数据说明

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

地区差异

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

查询限制

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

🔗 官方查询渠道

🛣️ 开发路线图

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

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