Xiaozhaobao 校招宝

Pesquise vagas de recrutamento de campus na China por cidade, lote, grau, setor e empresa, além de perfis de empregadores. MCP remoto, gratuito, somente leitura, sem chave de API.

GitHub

Documentação

🌐 Experiência online (30 segundos, sem instalação): https://xiaozhaobao.com.cn —— dados reais de recrutamento atualizados diariamente, clique e veja o resultado.

🎯 recruit-hub · Edição Open Source do Xiaozhaobao 校招宝

⭐ Se este projeto te ajudou, dá uma estrela! Sua estrela é a maior motivação para projetos open source. 🌐 Experiência online completa: https://xiaozhaobao.com.cn

Agregador de informações de recrutamento universitário com zero dependências — git clone rode com um único comando, sem npm install, sem build, sem serviço de banco de dados.

O Xiaozhaobao é um hub de inteligência de recrutamento universitário para recém-formados: busca de vagas, perfis de empresas, guias de preparação, quizzes práticos e referências salariais. Este repositório é a edição open source com dados de demonstração totalmente desidentificados; a instância de produção é independente deste repositório.

✨ Recursos

Capacidade	Descrição
🚀 Zero dependências	Node 22 nativo `node:sqlite`, sem pacotes de terceiros
📱 SSR + SPA	Visível para mecanismos de busca (sitemap / llms.txt / JSON-LD / PWA), frontend e backend integrados
🔍 Filtragem precisa	Por empresa / vaga / cidade / escolaridade / turma / lote / setor / situação da prova
🏢 Perfis de empresas	Agrega todas as vagas abertas e experiências de entrevista por empresa controladora
📖 Guias de preparação	Guias de prova / entrevista / salário por vaga
✏️ Quizzes práticos	Responda online com correção automática
💰 Referências salariais	Faixas salariais e relatos reais agregados
🔑 Sistema de contas	Registro por e-mail / login com senha / favoritos / alertas de assinatura
🛡 Segurança	Autenticação do painel administrativo, cabeçalhos de segurança, proteção contra força bruta, páginas de conformidade

📊 Conjunto de dados reais desidentificados (exclusivo deste repositório)

O Xiaozhaobao publica dados reais agregados de recrutamento público desidentificados como um conjunto de dados aberto junto com o repositório. Você pode usá-los diretamente para pesquisa, visualização ou amostras de treinamento de IA:

data/jobs-YYYY-MM-DD.csv / .json — amostras de vagas públicas exportadas a cada edição (empresa / vaga / cidade / lote / escolaridade / prazo / fonte / faixa salarial), sem nenhuma informação pessoal
digest/校招情报周报-YYYY-MM-DD.md — relatório semanal de inteligência de recrutamento universitário agregado automaticamente (Top empresas com vagas, cidades populares, distribuição por lote e setor)

Os dados são amostras públicas agregadas de anúncios públicos de recrutamento universitário e plataformas de emprego, apenas para demonstração técnica e pesquisa. Não são oficiais e não constituem um serviço de recrutamento. Os direitos autorais pertencem aos publicadores originais; o repositório inclui atribuição de fonte e um canal de remoção.

🚀 Experiência em um clique (rode em 30 segundos)

Requisito: Node.js ≥ 22.5 (Node 22 já inclui node:sqlite, sem etapas de instalação).

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

Abra http://localhost:3600 — vagas de demonstração desidentificadas + perfis de empresas já carregados.

Ou use GitHub Codespaces: abra o repositório → Code → Codespaces → Create, e rode direto no navegador.

Ou rode manualmente sem instalação:

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

🛠 Stack tecnológica

Node.js 22 + node:sqlite (SQLite nativo, zero dependências externas)
SSR nativo (renderização no servidor) / SPA, sem frameworks
PWA (instalável, cache offline)
SEO/GEO prontos para uso: sitemap.xml, llms.txt, JSON-LD Schema, Open Graph

📁 Estrutura do projeto

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         # 环境变量模板

🤖 Integração com assistentes de IA (MCP) — deixe a IA responder perguntas sobre recrutamento universitário na China

O Xiaozhaobao oferece um MCP Server (sem API Key · sem registro · somente leitura). Assistentes de IA como Claude, ChatGPT, Cursor, Tencent WorkBuddy e Gemini CLI podem pesquisar diretamente vagas de recrutamento universitário em todo o país.

Instalação em um clique: usuários do Cursor podem clicar no botão Add to Cursor acima. Após clonar este repositório, os arquivos .mcp.json e .vscode/mcp.json na raiz já estão prontos — Claude Code / VS Code Copilot podem usar diretamente ao abrir o repositório, sem precisar copiar configurações manualmente.

Configuração manual (qualquer cliente MCP):

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

Cliente	Como configurar
Cursor	Clique no botão Add to Cursor acima, ou escreva em `~/.cursor/mcp.json`
Claude Code	`claude mcp add --transport http xiaozhaobao https://xiaozhaobao.com.cn/mcp` (este repositório já inclui `.mcp.json`)
Claude Desktop	Escreva o JSON acima em `claude_desktop_config.json`
VS Code (GitHub Copilot)	Este repositório já inclui `.vscode/mcp.json`; ou execute `MCP: Add Server` na paleta de comandos
Tencent WorkBuddy	Escreva o mesmo JSON em `~/.workbuddy/mcp.json` e clique em "Confiar" na página de gerenciamento de conectores
Gemini CLI	Este repositório já é uma extensão (`gemini-extension.json`); após instalar, o serviço MCP remoto é carregado automaticamente

Ferramentas disponíveis (todas somente leitura): search_campus_jobs · get_job_detail · get_company_profile · list_urgent_deadlines · get_stats

Detalhes do endpoint e documentação completa: https://xiaozhaobao.com.cn/mcp ｜ API autodescritiva: https://xiaozhaobao.com.cn/api/open/v1/meta

⛔ Este servidor não oferece envio de candidaturas (requisito de conformidade) — para se candidatar, abra a página interna nos resultados retornados.

🔌 Pipeline de dados: como conectar seus próprios dados

A edição open source inclui dados de demonstração. Há duas formas de conectar dados:

Inserção direta no banco: escreva linhas de vagas na tabela jobs (consulte os campos em examples/gen_seed.js); vagas duplicadas são removidas automaticamente via fingerprint (MD5 de company|position|batch|education|city).
Importação pelo painel administrativo: defina ADMIN_KEY e use a interface de importação CSV em /admin para inserir em lote.

⚠️ Direitos autorais dos dados: importe apenas dados de vagas que você tem o direito de usar. Este repositório não fornece dados licenciados de terceiros.

🔧 Variáveis de ambiente (todas opcionais)

Copie .env.example para .env. Nenhum campo é obrigatório para rodar:

Variável	Uso	Padrão
`XZB_SITE_BASE`	Domínio público do site (afeta sitemap/canonical/JSON-LD)	`http://localhost:3600`
`PORT`	Porta do serviço	`3600`
`ADMIN_KEY`	Chave do painel administrativo (sem ela, as rotas administrativas ficam indisponíveis)	-
`JWT_SECRET`	Chave do token de login (sem ela, gerada aleatoriamente)	-
`SMTP_*` / `MAIL_FROM`	Envio de e-mail (sem ela, o código de verificação usa modo de demonstração)	-
`DEEPSEEK_*`	Modelo DeepSeek (sem ela, os recursos de IA são rebaixados)	-

🌐 Experiência online e serviço hospedado

Experiência completa: https://xiaozhaobao.com.cn (dados atualizados diariamente)
Não quer hospedar você mesmo? Oferecemos um serviço gerenciado (integração de dados + deploy + manutenção), ideal para grupos de estudantes / escritórios de empregabilidade universitária / instituições de treinamento — veja as Discussions do repositório ou fale conosco.

🤝 Contribuições

Sua participação é bem-vinda! Veja CONTRIBUTING.md para as diretrizes de desenvolvimento e fluxo de contribuição.

Reporte bugs / sugestões de recursos / fontes de dados: abra uma Issue
Discussões e feedback: GitHub Discussions
Contribuição de código: Fork + PR (mantenha o princípio de zero dependências)

📄 Licença

Licença MIT — uso, modificação e distribuição livres (inclusive comercial). Veja LICENSE.

A edição open source do Xiaozhaobao (recruit-hub) é independente da instância de produção: este repositório não contém dados reais de usuários nem dados licenciados de terceiros.

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

⭐ Star this repo if you find it useful · 🌐 xiaozhaobao.com.cn