Social Security Fund

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

Security Scan

The skill's code and instructions match its stated purpose: local calculators and simulated query helpers for Chinese social security and housing fund; there are no unexplained credentials, network endpoints, or install steps.

Purpose & Capability

Name/description align with provided scripts: calculators (calculate.py, pension_estimate.py), simulated query helpers (query_social_security.py, query_fund.py) and a wrapper (check_deals.py). Required env vars/binaries/configs are none, which is consistent with a local, offline tool.

Instruction Scope

SKILL.md instructs running the included local Python scripts and shows optional ID/account arguments used only to generate simulated results. The scripts do not read unrelated system files or environment variables. Warning: supplying sensitive values (身份证号, 公积金账号) on the command line may expose them to other local users via process listings; the README/SKILL.md claims sensitive data is not stored or uploaded — current code does not persist or transmit such data.

Install Mechanism

No install spec; it's an instruction-only skill with a requirements.txt referencing requests and beautifulsoup4. That is reasonable given potential optional web scraping, though the shipped scripts currently do not perform network requests. Installing requirements (pip) is the only installation step and is proportionate.

Credentials

The skill requests no environment variables or credentials. It accepts user-supplied ID/account values as CLI args (used locally to generate simulated outputs). This is proportionate to the stated functionality, but users should avoid passing real credentials or sensitive tokens to unverified code.

Persistence & Privilege

Skill does not request persistent presence, does not modify other skills, and does not write configuration. SKILL.md mentions an optional cache file path in the file tree, but shipped scripts do not create or write cache files.

Assessment

This skill appears coherent and local: it runs included Python scripts to produce simulated social-security and housing-fund data and perform calculations. Before installing or running: (1) review the scripts yourself (they are small and readable) if the source is unknown; (2) do not pass real ID numbers, account passwords, or login credentials on the command line to untrusted code (command-line args can be visible to other users); (3) be aware requirements.txt includes web-scraping libraries — if later modified to perform real queries, the code could contact official sites and might need credentials (avoid providing them here unless you trust the maintainer); (4) the tool currently uses simulated data and does not persist or exfiltrate data, but confirm there are no network calls if you require offline-only behavior.

社保公积金查询助手 🇨🇳

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

✨ 核心功能

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

---

🎯 触发条件

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

社保相关

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

公积金相关

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

计算相关

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

1. Fork 本项目
2. 创建功能分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 开启 Pull Request

---

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