> 🌐 **在线体验（30 秒，无需安装）**：**https://xiaozhaobao.com.cn** —— 真实校招数据每日更新，点开即看效果。

---

# 🎯 recruit-hub · 校招宝开源版

> **⭐ 如果这个项目对你有帮助，请点个 Star！** 你的 Star 是开源项目最大的动力。
> 🌐 完整在线体验：**https://xiaozhaobao.com.cn**

**零依赖的校园招聘信息聚合站** —— `git clone` 一条命令即可跑起来，无需 npm install、无需构建、无需数据库服务。

> 校招宝是面向应届生的校招情报站：岗位检索、企业档案、求职攻略、岗位练习、薪资参考。本仓库是它的**开源版**，演示数据完全脱敏；线上运营实例独立于本仓库。

[![Node](https://img.shields.io/badge/Node.js-%3E%3D22.5-339933?logo=nodedotjs&logoColor=white)](https://nodejs.org)
[![零依赖](https://img.shields.io/badge/dependencies-0-brightgreen)](https://github.com/kknee-dev/recruit-hub)
[![License](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
[![在招岗位](https://img.shields.io/badge/dynamic/json?url=https://xiaozhaobao.com.cn/api/meta&query=total&label=%E7%BA%BF%E4%B8%8A%E5%9C%A8%E6%8B%9B%E5%B2%97%E4%BD%8D&color=orange)](https://xiaozhaobao.com.cn)
[![Stars](https://img.shields.io/github/stars/kknee-dev/recruit-hub?style=social)](https://github.com/kknee-dev/recruit-hub/stargazers)

---

## ✨ 特性

| 能力 | 说明 |
|---|---|
| 🚀 **零依赖** | Node 22 原生 `node:sqlite`，无任何第三方包 |
| 📱 **SSR + SPA** | 搜索引擎可见（sitemap / llms.txt / JSON-LD / PWA），前后端一体 |
| 🔍 **精准筛选** | 按公司 / 岗位 / 城市 / 学历 / 届别 / 批次 / 行业 / 笔试情况 |
| 🏢 **企业档案** | 按母公司聚合全部在招岗位与笔面经 |
| 📖 **求职攻略** | 按岗位的笔试 / 面试 / 薪资备考指南 |
| ✏️ **岗位练习** | 在线作答、自动判分 |
| 💰 **薪资参考** | 薪资区间与真实爆料聚合 |
| 🔑 **账号体系** | 邮箱注册 / 密码登录 / 收藏 / 订阅提醒 |
| 🛡 **安全** | 管理后台鉴权、安全响应头、防爆破、合规页 |

## 📊 真实脱敏数据集（本仓库独有）

校招宝把**真实聚合的公开招聘数据**脱敏后作为公开数据集随仓库发布，你可以直接拿来做检索研究、可视化、AI 训练样本：

- `data/jobs-YYYY-MM-DD.csv` / `.json` —— 每期导出的公开招聘样本（公司 / 岗位 / 城市 / 批次 / 学历 / 截止日 / 来源 / 薪资区间），**不含任何个人信息**
- `digest/校招情报周报-YYYY-MM-DD.md` —— 自动聚合的校招情报周报（在招 Top 公司、热门城市、批次与行业分布）

> 数据为聚合自各企业公开校招公告与招聘平台的**公开样本**，仅作技术演示与检索研究，非官方、不构成招聘服务。版权归原发布方，仓库已附来源标注与下架通道。

## 🚀 一键体验（30 秒跑起来）

要求：**Node.js ≥ 22.5**（Node 22 自带 `node:sqlite`，无需任何安装步骤）。

```bash
git clone https://github.com/kknee-dev/recruit-hub.git
cd recruit-hub
# Linux / macOS
./start.sh
# Windows
start.bat
```

打开 `http://localhost:3600` —— 已自动加载脱敏演示岗位 + 企业档案。

**或者用 GitHub Codespaces**：打开仓库 → Code → Codespaces → 创建，浏览器里直接跑。

**或者零安装手动跑**：

```bash
node examples/gen_seed.js   # 生成演示数据（可选，首次启动会自动加载）
node app/server.js          # 启动
```

## 🛠 技术栈

- **Node.js 22 + node:sqlite**（原生 SQLite，零外部依赖）
- 原生 SSR（服务端渲染）/ SPA，无框架
- PWA（可安装、离线缓存）
- SEO/GEO 开箱即用：`sitemap.xml`、`llms.txt`、JSON-LD Schema、Open Graph

## 📁 项目结构

```
recruit-hub/
├── app/
│   ├── server.js        # 服务入口（Express 兼容中间件，零依赖自研）
│   ├── db.js            # SQLite schema（建表/索引）
│   ├── config.js        # 环境变量加载（.env）
│   ├── lib/             # ssr / web / auth / importer / llm / practice / offer ...
│   └── public/          # 前端（原生 JS + CSS，PWA）
├── examples/
│   ├── gen_seed.js      # 演示数据生成器（完全脱敏）
│   └── seed.sqlite      # 生成的演示库
├── scripts/
│   ├── gen_dataset.js   # 演示数据集导出（读 seed.sqlite）
│   ├── export_real_dataset.js  # 真实脱敏数据集导出（读真实库，需 XZB_DB_PATH）
│   └── gen_digest.js    # 周报生成
├── data/                # 真实脱敏数据集快照（根目录，维护者定期导出，永久保留）
│   └── demo/            # CI 自动生成的虚构演示数据（每周刷新，不覆盖根目录真实快照）
├── digest/              # 校招情报周报（根目录为真实快照）
│   └── demo/            # CI 自动生成的虚构演示周报
├── start.sh / start.bat # 一键启动
└── .env.example         # 环境变量模板
```

## 🤖 接入 AI 助手（MCP）—— 让 AI 直接回答中国校招问题

[![Add to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/install-mcp?name=xiaozhaobao&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8veGlhb3poYW9iYW8uY29tLmNuL21jcCJ9)

校招宝提供 **MCP Server**（免 API Key · 免注册 · 只读），Claude、ChatGPT、Cursor、腾讯 WorkBuddy、Gemini CLI 等 AI 助手可直接检索全国在招校招岗位。

**一键安装**：Cursor 用户点上方的 **Add to Cursor** 按钮即可。克隆本仓库后，根目录的 `.mcp.json` 与 `.vscode/mcp.json` 已就位，**Claude Code / VS Code Copilot 打开仓库即可直接使用**，无需手抄配置。

手动配置（任意 MCP 客户端）：

```json
{
  "mcpServers": {
    "xiaozhaobao": {
      "type": "http",
      "url": "https://xiaozhaobao.com.cn/mcp"
    }
  }
}
```

| 客户端 | 配置方式 |
|---|---|
| **Cursor** | 点上方 **Add to Cursor** 按钮，或写入 `~/.cursor/mcp.json` |
| **Claude Code** | `claude mcp add --transport http xiaozhaobao https://xiaozhaobao.com.cn/mcp`（本仓库已含 `.mcp.json`） |
| **Claude Desktop** | 上面的 JSON 写入 `claude_desktop_config.json` |
| **VS Code (GitHub Copilot)** | 本仓库已含 `.vscode/mcp.json`；或在命令面板执行 `MCP: Add Server` |
| **腾讯 WorkBuddy** | 同一段 JSON 写入 `~/.workbuddy/mcp.json`，再于连接器管理页点「信任」 |
| **Gemini CLI** | 本仓库即扩展（`gemini-extension.json`），安装后自动加载远程 MCP 服务 |

**可用工具**（全部只读）：`search_campus_jobs` · `get_job_detail` · `get_company_profile` · `list_urgent_deadlines` · `get_stats`

> 端点详情与完整说明：**https://xiaozhaobao.com.cn/mcp** ｜ 接口自描述：**https://xiaozhaobao.com.cn/api/open/v1/meta**

⛔ 本服务器**不提供投递入口**（合规要求）—— 需要投递时请打开返回结果里的站内页面。

---

## 🔌 数据管道：如何接入你自己的数据

开源版自带演示数据。接数据有两种方式：

1. **直接灌库**：向 `jobs` 表写入岗位行即可（参考 `examples/gen_seed.js` 的字段）；重复岗位通过 `fingerprint`（company|position|batch|education|city 的 MD5）自动去重。
2. **管理后台导入**：设置 `ADMIN_KEY` 后通过 `/admin` 的 CSV 导入接口批量灌入。

> ⚠️ 数据版权：请只导入你**有权使用**的岗位数据。本仓库不提供任何第三方授权数据。

## 🔧 环境变量（全部可选）

复制 `.env.example` 为 `.env`。**无任何必填项**即可运行：

| 变量 | 用途 | 默认 |
|---|---|---|
| `XZB_SITE_BASE` | 站点对外域名（影响 sitemap/canonical/JSON-LD） | `http://localhost:3600` |
| `PORT` | 服务端口 | `3600` |
| `ADMIN_KEY` | 管理后台密钥（不填则管理接口不可用） | - |
| `JWT_SECRET` | 登录令牌密钥（不填则随机生成） | - |
| `SMTP_*` / `MAIL_FROM` | 邮件发送（不填则验证码走演示模式） | - |
| `DEEPSEEK_*` | DeepSeek 大模型（不填则 AI 功能降级） | - |

## 🌐 在线体验与托管服务

- 完整版体验：https://xiaozhaobao.com.cn （数据每日更新）
- **不想自己部署？** 我们提供托管服务（数据接入 + 部署 + 维护），适合学生社团 / 高校就业办 / 培训机构——详见仓库 Discussions 或联系我们。

## 🤝 贡献

欢迎参与！请看 [CONTRIBUTING.md](CONTRIBUTING.md) 了解开发规范与提交流程。

- 提 Bug / 功能 / 数据源建议：新建 Issue
- 交流与反馈：GitHub Discussions
- 代码贡献：Fork + PR（保持零依赖原则）

## 📄 License

MIT License —— 可自由使用、修改、分发（含商用）。详见 [LICENSE](LICENSE)。

---

**校招宝开源版（recruit-hub）与线上运营实例相互独立**：本仓库不包含任何真实用户数据与第三方授权数据。

---

## English

# 🎯 recruit-hub · Xiaozhaobao (Campus Recruitment) Open Source

A **zero-dependency campus recruitment aggregator**. Clone and run with a single command — no `npm install`, no build step, no database server required.

> Xiaozhaobao is a campus-recruitment intelligence hub for new graduates: job search, company profiles, prep guides, practice quizzes, and salary references. This repo is the **open-source edition** with fully desensitized demo data; the production instance is independent.

[![Node](https://img.shields.io/badge/Node.js-%3E%3D22.5-339933?logo=nodedotjs&logoColor=white)](https://nodejs.org)
[![zero-deps](https://img.shields.io/badge/dependencies-0-brightgreen)](https://github.com/kknee-dev/recruit-hub)
[![License](https://img.shields.io/badge/license-MIT-blue)](LICENSE)

### Features
- 🚀 **Zero dependencies** — Node 22 native `node:sqlite`, no third-party packages
- 📱 **SSR + SPA** — SEO/GEO ready (sitemap, llms.txt, JSON-LD, PWA)
- 🔍 **Precise filtering** — by company / position / city / education / batch / industry
- 🏢 **Company profiles** — aggregate all open roles and interview experiences by parent company
- ✏️ **Practice quizzes** — online answering with auto-grading
- 💰 **Salary references** — salary ranges aggregated from public postings

### Real desensitized dataset (unique to this repo)
We publish real aggregated public recruitment data as a desensitized dataset:
- `data/jobs-YYYY-MM-DD.csv` / `.json` — public job samples (company / position / city / batch / education / deadline / source / salary range), **no personal information**
- `digest/校招情报周报-YYYY-MM-DD.md` — auto-aggregated weekly campus-recruitment report

### Quick start
```bash
git clone https://github.com/kknee-dev/recruit-hub.git
cd recruit-hub
./start.sh            # macOS / Linux
# start.bat           # Windows
# open http://localhost:3600
```
Live demo: **https://xiaozhaobao.com.cn**

### Use with AI assistants (MCP)

This repo ships an MCP server — no API key, no sign-up, **read-only**:

```json
{
  "mcpServers": {
    "xiaozhaobao": {
      "type": "http",
      "url": "https://xiaozhaobao.com.cn/mcp"
    }
  }
}
```

- **Cursor** — click the *Add to Cursor* badge above
- **Claude Code** — `claude mcp add --transport http xiaozhaobao https://xiaozhaobao.com.cn/mcp`
- **VS Code (Copilot)** — `.vscode/mcp.json` is already in this repo; just open the workspace
- **Gemini CLI** — this repo *is* a Gemini CLI extension (`gemini-extension.json`)

Tools (all read-only): `search_campus_jobs` · `get_job_detail` · `get_company_profile` · `list_urgent_deadlines` · `get_stats`

The server intentionally exposes **no apply/application endpoints** — users complete applications on the original posting page.

### Contributing
See [CONTRIBUTING.md](CONTRIBUTING.md). Issues and Discussions are welcome. Fork + PR (keep it zero-dependency).

### License
MIT — free to use, modify, and distribute (including commercial).

[![Star History Chart](https://api.star-history.com/svg?repos=kknee-dev/recruit-hub&type=Date)](https://star-history.com/#kknee-dev/recruit-hub&Date)

---

<p align="center">⭐ Star this repo if you find it useful · 🌐 <a href="https://xiaozhaobao.com.cn">xiaozhaobao.com.cn</a></p>