Skill: testmtcode/social-security-fund (version 1.0.1)

--- 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 --- **🎯 让社保公积金查询更简单！**


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (HIGH)