Recruit Hub MCP Server

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

---

🎯 recruit-hub · 校招宝开源版

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

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

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

---

✨ 特性

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

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

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

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

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

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

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 → 创建，浏览器里直接跑。

或者零安装手动跑：

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 直接回答中国校招问题

校招宝提供 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 客户端）：

{
  "mcpServers": {
    "xiaozhaobao": {
      "type": "http",
      "url": "https://xiaozhaobao.com.cn/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。无任何必填项即可运行：

🌐 在线体验与托管服务

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

🤝 贡献

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

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

📄 License

MIT 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.

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

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:

{
  "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. Issues and Discussions are welcome. Fork + PR (keep it zero-dependency).

License

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

---