FastJob MCP
by Dargod1234
README.md
# FastJob MCP
**Tu asistente de búsqueda de empleo, dentro de Claude.**
Le cuentas qué trabajo quieres y FastJob MCP te ayuda a **encontrar ofertas**, **descartar las que no te sirven**, **preparar tu hoja de vida y tu carta** para cada una, **responder los formularios** y **llevar el control de tus postulaciones**. Funciona para **cualquier profesión y país**, y tú decides cuánto hace por ti: solo preparar, preparar y mostrarte todo, o enviar por ti.
Usa **tu propia suscripción de Claude**: sin claves de API ni pagos extra. Todo se guarda **en tu computador**.
> **Estado: experimento.** Ya funciona de punta a punta, pero es joven. Si algo falla, abre un *issue*.
## Instalación (3 pasos)
Necesitas **Claude Desktop o Claude Code**.
**1. Instala.** Pega una línea en la terminal (en Windows, PowerShell). Instala [uv](https://docs.astral.sh/uv/) si no lo tienes y conecta FastJob a Claude:
```powershell
# Windows (PowerShell)
irm https://raw.githubusercontent.com/Dargod1234/fastjob-mcp/main/instalar.ps1 | iex
```
```bash
# macOS / Linux
curl -LsSf https://raw.githubusercontent.com/Dargod1234/fastjob-mcp/main/instalar.sh | sh
```
¿Prefieres ver qué hará antes? Agrega `--dry-run` (con el script descargado) y solo te lo cuenta. Si ya tienes `uv`:
```bash
uvx --from git+https://github.com/Dargod1234/fastjob-mcp fastjob-mcp instalar
```
**2. Reinicia Claude** (ciérralo del todo y ábrelo).
**3. Escribe `/configurar`** y adjunta o pega tu hoja de vida. Claude crea tu perfil y te pregunta solo lo que le falte. Después `/buscar`.
Para quitarlo: `uvx --from git+https://github.com/Dargod1234/fastjob-mcp fastjob-mcp desinstalar`.
## Comandos
| Comando | Qué hace |
| --- | --- |
| `/configurar` | Crea o actualiza tu perfil desde tu hoja de vida |
| `/buscar` | Busca ofertas y te muestra las mejores, con razones |
| `/postular` | Prepara (y según tu modo, envía) una postulación completa |
| `/seguimiento` | Qué postulaciones necesitan que escribas al reclutador |
| `/entrevista` | Prepara una entrevista con tus propias historias |
| `/modo` | Cambia entre manual, semiautomático y automático |
| `/preferencias` | Tus interruptores y datos fijos |
| `/rutina_diaria` | La búsqueda del día completa |
| `/ayuda` | La guía, incluido el modo navegador |
(En algunos programas aparecen como `/mcp__fastjob__configurar`. También puedes simplemente hablarle: *"búscame ofertas de enfermería remotas"*.)
## Los tres modos
- **Manual:** busca, califica y prepara los documentos. Tú envías.
- **Semiautomático:** prepara todo, llena el formulario y te lo muestra. Tú confirmas.
- **Automático:** envía por ti hasta tu límite diario, sin pararse en cada una. Pide el *modo navegador* y se detiene ante captchas, contraseñas o preguntas que tu perfil no responde.
Además hay interruptores: ocultar ofertas en inglés, con demasiados postulantes o muy viejas, solo remoto, permitir o no puestos senior, comprobar que la oferta siga abierta, tono de las cartas… Ver `/ayuda`.
## Qué hace
- **Busca** en portales con acceso público (Get on Board, Remotive, RemoteOK, Jobicy, Himalayas, Arbeitnow, y los de empresas que sigas) y te deja **pegar una oferta** de cualquier página.
- **Califica cada oferta de 0 a 100** contra tu perfil, con las razones: habilidades, cargo, nivel, si aceptan tu país, salario, idioma, jornada, cuántos ya se postularon.
- **Genera tu hoja de vida adaptada** a cada oferta (PDF, o Word si tu equipo no tiene la librería Pango) y tu carta.
- **Nunca inventa cifras:** rechaza cualquier número que no esté en tu perfil.
- **Anota lo que respondiste** en cada formulario para que no te contradigas en la entrevista.
- **Lleva el seguimiento** y avisa cuándo toca escribir; te prepara las entrevistas.
## Límites honestos
- Las fuentes con API pública son **sobre todo de tecnología y trabajo remoto**. Para otros oficios (salud, educación, ventas, oficios técnicos…) lo más útil es pegar ofertas o usar el **modo navegador** (ver `/ayuda`) para revisar LinkedIn, Indeed, Computrabajo y similares con tus sesiones abiertas.
- El **modo navegador** necesita Claude Code con un plan de pago y la extensión *Claude in Chrome*. Está explicado paso a paso en `/ayuda`.
- Algunas páginas (LinkedIn, Indeed) **prohíben automatizar postulaciones** en sus términos; puede restringir tu cuenta. El modo semiautomático es el más prudente. Úsalo bajo tu responsabilidad.
- La calificación es una guía, no un veredicto: lee siempre las razones.
## Tus datos
Viven en una carpeta propia de tu usuario (no en el programa, así que actualizar no los borra):
| Sistema | Carpeta |
| --- | --- |
| Windows | `%LOCALAPPDATA%\fastjob-mcp` |
| macOS | `~/Library/Application Support/fastjob-mcp` |
| Linux | `~/.local/share/fastjob-mcp` |
Se cambia con la variable `FASTJOB_HOME`. Pregúntale a Claude *"¿dónde guardas mis datos?"* y te lo dice. Lo que Claude ve en la conversación pasa por tu cuenta de Claude, como cualquier otro chat; nada se sube a otro sitio.
## Para quien quiera programar
```bash
git clone https://github.com/Dargod1234/fastjob-mcp.git
cd fastjob-mcp
uv sync
uv run pytest
uv run ruff format . && uv run ruff check .
```
Para probar sin tocar tus datos reales: `FASTJOB_HOME=/tmp/prueba uv run fastjob-mcp`. El perfil ficticio de ejemplo está en `empleo/ejemplos/`.
## Créditos y licencia
FastJob MCP parte de **[MCP Chamba](docs/ORIGEN-MCP-CHAMBA.md)**, de Yeison Rey, y mantiene su licencia **MIT**. Ver [LICENSE](LICENSE).
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessOutdated data