social-security-fund
v1.0.1全国社保公积金查询助手。支持查询社保缴纳记录、公积金余额、五险一金计算、退休金估算。覆盖北京、上海、广州、深圳、杭州、成都等主要城市。
Sourced from ClawHub,
Authored by testc0de
Installation
Please help me install the skill `social-security-fund` from SkillHub official store.
npx skills add testmtcode/social-security-fund
社保公积金查询助手 🇨🇳
🏢 打工人必备工具 —— 一键查询社保公积金，轻松计算五险一金，精准估算退休金
✨ 核心功能
| 功能 | 描述 | 适用场景 |
|---|---|---|
| 📋 社保查询 | 查询缴纳记录、缴费基数、账户余额 | 换工作、落户、买房资格 |
| 🏦 公积金查询 | 查询余额、缴存记录、贷款额度估算 | 买房、租房、提取 |
| 💰 五险一金计算 | 计算个人/企业缴纳部分、实发工资 | 谈薪资、算成本 |
| 👴 退休金估算 | 根据缴费年限估算每月养老金 | 养老规划 |
🎯 触发条件
当用户询问以下内容时，使用此技能：
社保相关
- "查询我的社保"
- "社保怎么查"
- "社保缴纳比例是多少"
- "社保断了怎么办"
- "我的社保交了多久了"
公积金相关
- "公积金怎么查"
- "公积金贷款额度"
- "公积金提取条件"
- "公积金余额多少"
计算相关
- "五险一金怎么算"
- "月薪 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
依赖说明
| 依赖 | 版本 | 用途 |
|---|---|---|
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！
- Fork 本项目
- 创建功能分支 (
git checkout -b feature/AmazingFeature) - 提交更改 (
git commit -m 'Add some AmazingFeature') - 推送到分支 (
git push origin feature/AmazingFeature) - 开启 Pull Request
🎯 让社保公积金查询更简单！