<p align="center">
  <img src="banner.png" alt="gupy candidate — servidor MCP para empregabilidade orientada por IA" width="100%">
</p>

<p align="center">
  <strong>Servidor MCP que transforma vagas do Gupy em dados, análise e templates de preparação para a sua IA.</strong>
</p>

<p align="center">
  <a href="https://github.com/leonardobora/gupy-candidate-mcp/blob/main/LICENSE"><img src="https://img.shields.io/github/license/leonardobora/gupy-candidate-mcp?color=7c3aed&style=flat-square" alt="License"></a>
  <a href="https://github.com/leonardobora/gupy-candidate-mcp/actions"><img src="https://img.shields.io/github/actions/workflow/status/leonardobora/gupy-candidate-mcp/ci.yml?branch=main&label=ci&style=flat-square" alt="CI"></a>
  <a href="https://github.com/leonardobora/gupy-candidate-mcp/issues"><img src="https://img.shields.io/github/issues/leonardobora/gupy-candidate-mcp?style=flat-square" alt="Issues"></a>
  <a href="https://github.com/leonardobora/gupy-candidate-mcp/pulls"><img src="https://img.shields.io/github/issues-pr/leonardobora/gupy-candidate-mcp?style=flat-square" alt="Pull Requests"></a>
  <a href="https://github.com/leonardobora/gupy-candidate-mcp"><img src="https://img.shields.io/github/stars/leonardobora/gupy-candidate-mcp?style=flat-square" alt="Stars"></a>
  <a href="https://github.com/leonardobora/gupy-candidate-mcp"><img src="https://img.shields.io/github/last-commit/leonardobora/gupy-candidate-mcp?style=flat-square" alt="Last commit"></a>
</p>

O **gupy candidate** é um servidor MCP que ajuda pessoas candidatas a se candidatarem a vagas hospedadas no Gupy. Ele entrega **dados + análise + templates de preparação** para a sua IA (opencode, Claude, Gemini CLI etc.) — o raciocínio e a redação ficam na IA cliente. Nenhuma chave de LLM é embutida.

**Empregabilidade orientada por IA, não "corrida atrás de vaga".** Este projeto não se candidata no seu nome nem decide por você — ele te entrega dados reais das vagas e um ponto de partida, para que *você* entenda onde se encaixa e chegue melhor preparado. É uma ferramenta de capacitação, com transparência sobre como a IA pode (e não pode) ajudar na sua jornada de candidatura.

## O que faz

| Tool | Descrição |
| --- | --- |
| `buscar_vagas` | Busca vagas públicas no Gupy (termo, estado, modalidade, tipo, empresa). |
| `detalhe_vaga` | Lê os detalhes de uma vaga pelo ID. |
| `carregar_perfil` | Carrega e valida o perfil do candidato a partir de um arquivo JSON. |
| `analisar_aderencia` | Cruza perfil x requisitos da vaga e gera score e pontos fortes/atenção. |
| `preparar` | Gera o template de prompt para `curriculo`, `carta` ou `formulario`. |
| `monitorar` | Verifica prazos de candidatura (urgente/proximo/ok). |

## Como usar

```bash
npm install
npm run build
```

Perfil do candidato: crie um JSON no formato de `src/schema/profile.schema.json` e passe o caminho para `carregar_perfil` / `analisar_aderencia` / `preparar`.

Para registrar no opencode, adicione ao seu `opencode.json`:

```json
"gupy-candidate": {
  "type": "local",
  "command": ["node", "C:\\caminho\\ate\\gupy-candidate-mcp\\dist\\index.js"],
  "enabled": true
}
```

## Desenvolvimento

```bash
npm test        # rodar testes
npm run build   # compilar
npm run dev     # watch mode (tsx)
```

---

<p align="center">
  <small>Feito por <a href="https://github.com/leonardobora">Leonardo Bora</a> · MIT License</small>
</p>