Find your role first

npx add-mcp 'https://findyourrolefirst.click/mcp'

API y MCP

Sigue usando tu propio agente. Añade el feed como un servidor MCP HTTP, o llama a la API desde tu aplicación.

¿Usas Claude Code o Codex CLI? Copia tu comando de configuración y primera tarea. La terminal te pedirá tu clave de forma privada.

MCP

El endpoint es https://findyourrolefirst.click/mcp (HTTP Streamable). Añádelo a tu agente e inicia sesión: Claude, ChatGPT, Claude Code, Codex y cualquier cliente que admita autorización MCP abren nuestra página, haces clic en Permitir, y el agente obtiene su propia clave. Esa clave solo funciona a través de MCP, dura una hora y se renueva sola; rotar tus claves en la consola termina el acceso de todos los agentes. La configuración paso a paso para cada cliente está en Connect.

Los clientes que no pueden iniciar sesión pueden enviar una clave en su lugar: crea una en tu consola y establece Authorization: Bearer YOUR_API_KEY (o X-API-Key). Documentos de descubrimiento: /.well-known/oauth-protected-resource y /.well-known/oauth-authorization-server.

Comprueba la compatibilidad del cliente

Antes de pagar, verifica que tu agente te permita configurar un servidor HTTP remoto con un encabezado bearer personalizado, porque un conector que solo ofrece una pantalla de inicio de sesión OAuth no podrá usar esta versión incluso si anuncia soporte MCP.

• search_jobs: búsqueda de palabra completa en títulos y empresas, publicaciones más recientes primero. Filtra por país o ciudad (location), excluye palabras (exclude), conserva solo roles remote, o limita a posted_within_hours.
• count_jobs: cuántos roles coincidiría una búsqueda, hasta 1,000. Gratis, así que dimensiona una búsqueda antes de gastar créditos en ella.
• list_my_jobs: cada rol que ya has desbloqueado, más recientes primero. Gratis de leer.
• get_job: actualiza los metadatos de un trabajo, fechas, estado conocido y enlaces. La búsqueda ya incluye estos campos.
• get_changes: trabajos nuevos, actualizados, reabiertos y cerrados después de un cursor guardado. Las ediciones solo de descripción no se rastrean.
• get_usage: tu asignación actual. Esta llamada es gratuita.
• get_my_profile: lo que nos dijiste que quieres (campos, lugares, experiencia), para que tu agente pueda buscar por ti. Gratis.
• get_new_for_me: roles que coinciden con tus preferencias guardadas encontrados desde la última verificación de tu agente. Devuelve checked_at como since y una verificación diaria o por hora nunca repite un rol.
• get_apply_kit: el enlace de solicitud, las preguntas del formulario de solicitud cuando el sitio de carreras las publica (cada rol de Greenhouse), y lo que sabemos sobre el rol, para que tu agente pueda ayudarte a redactar respuestas y adaptar tu currículum. Tú envías; nosotros nunca solicitamos por ti.

Lee las descripciones en la fuente

Find your role first devuelve detalles básicos del trabajo, salario y modalidad de trabajo cuando se proporcionan, fechas de origen, la URL de la publicación original (url) y la URL de solicitud (apply_url). Las descripciones completas y los resúmenes generados no están incluidos.

Tu agente necesita su propia herramienta web o de navegador para abrir la publicación original y leer los requisitos. Una conexión LLM por sí sola no obtiene páginas. Si el acceso falla o se requiere inicio de sesión, abre el enlace tú mismo o proporciona el texto a tu agente. Respeta las restricciones de la fuente y mantén los requisitos desconocidos como desconocidos.

Lee los requisitos en url. El enlace apply_url puede llevar directamente a un formulario.

Elegir el enlace de fuente correcto

Comienza con la URL de la publicación original al leer los requisitos, porque un enlace de solicitud puede abrir un formulario sin la descripción, y una conexión exitosa a Find your role first solo le da a tu agente los campos y enlaces devueltos sin añadir un navegador ni otorgar acceso al sitio del empleador.

API HTTP

Envía el mismo encabezado bearer. Comienza con GET /api/jobs?query=product&location=San%20Francisco. La respuesta incluye jobs y next_offset. Pasa ese offset a la siguiente solicitud.

Usa GET /api/jobs/{id} para un trabajo, GET /api/changes?cursor=0 para cambios y GET /api/account para uso. El esquema OpenAPI documenta los tipos de parámetros.

Fechas en las que puedes confiar

Honestamente, los sistemas de contratación no siempre proporcionan una fecha de publicación. published_at permanece null cuando se desconoce. first_seen registra el descubrimiento; baseline significa que el trabajo ya estaba presente cuando comenzamos a monitorear.

La búsqueda solo devuelve trabajos cuyo tablero se verificó correctamente en las últimas 24 horas. Los detalles individuales incluyen registros más antiguos para que tu agente pueda ver su último estado conocido. El cierre se registra después de que dos respuestas exitosas del tablero omitan un trabajo. Las obtenciones fallidas conservan los registros anteriores.

Para filtrar por publicación, usa published_since=2026-09-01T00:00:00Z. Los trabajos sin fecha de origen no coincidirán. discovered_since excluye importaciones de referencia. Las etiquetas de empresa actualmente usan identificadores de tablero de origen.

Descubrimiento vs publicación

Si buscas roles recién descubiertos, usa el filtro de descubrimiento e inspecciona la fecha de origen por separado, ya que una publicación encontrada por primera vez durante la verificación de hoy podría haberse publicado mucho antes, y una verificación reciente por sí sola no te dice nada sobre su antigüedad original.

Uso y errores

El plan de $9 incluye 3,000 trabajos únicos por mes calendario UTC, con un máximo de 1,000 trabajos recién desbloqueados por día UTC. Las páginas de búsqueda y cambios contienen hasta 20 registros. Todas las claves y métodos de entrega comparten la misma asignación.

Un trabajo cuenta una vez en el mes cuando se devuelve por primera vez a tu cuenta. Lecturas repetidas, reintentos y actualizaciones de ese trabajo no cuestan más créditos de trabajo ese mes. Los resultados vacíos y las verificaciones de uso son gratuitos. Un trabajo leído en un mes nuevo cuenta de nuevo. La muestra pública de cinco trabajos es gratuita y no desbloquea trabajos en tu cuenta.

Límites de tasa, reinicios y errores

Cada llamada de datos aún cuenta para 30 llamadas por minuto UTC fijo, incluyendo repeticiones gratuitas, resultados vacíos y llamadas rechazadas por la cuota de trabajos. Cada respuesta de datos exitosa incluye usage.charged, trabajos diarios y mensuales restantes, y tiempos de reinicio. No hay créditos no utilizados que se transfieran.

Si un lote necesita más créditos de los que quedan, todo el lote falla sin cargo y sin avance del cursor. Baja limit y reintenta el mismo offset o cursor. Los errores de límite REST incluyen Retry-After; los errores MCP explican el tiempo de reinicio. Los créditos diarios se reinician a medianoche UTC y los mensuales el primer día del mes UTC, independientemente de tu fecha de facturación de suscripción.

Los errores HTTP usan un mensaje error: 401 significa que la clave no es válida, 402 significa que la suscripción está inactiva y 429 significa un límite de tasa o mensual. Una respuesta de cambio 410 significa que su cursor ha expirado; reinicia desde una búsqueda actual y cursor 0. El historial de cambios dura 90 días. Los errores de herramientas MCP llevan la misma explicación.

Una búsqueda incluye enlaces para hasta 20 trabajos y puede usar hasta 20 créditos de trabajo. Leer esos enlaces con tu propia herramienta de navegador no usa créditos de Find your role first. Actualizar un trabajo ya desbloqueado a través de get_job es gratuito dentro de ese mes; tu navegador y proveedor de IA pueden cobrar por separado.

Dónde poner tu clave

El comando de configuración lleva YOUR_API_KEY. Sustituirla como normalmente manejas una credencial está bien — aquí está lo que cada opción realmente hace, para que puedas elegir en lugar de que te lo digan.

Directamente en el comando. Lo más rápido. La clave se escribe en la configuración MCP de tu cliente y en tu historial de shell, así que cualquiera con ese archivo o ese historial la tiene. Está bien en una máquina que solo usas tú.

Desde una variable. export JOBFEED_API_KEY=... primero, luego refiérela. Mantiene la clave fuera del comando que pegas. Vive solo en ese terminal a menos que la pongas en un archivo de inicio de shell, en cuyo caso está en disco en texto plano como cualquier otra variable de entorno. Esto es lo que hace el comando Codex, porque Codex lee el token del entorno por diseño.

Desde un gestor de secretos. Lo que ya uses — op run, pass, tu llavero del sistema operativo — funciona igual: resuélvelo en el entorno y deja que el cliente lo lea allí.

Cualquiera que elijas: guarda la clave en un gestor de contraseñas, porque se muestra una sola vez. La página de cuenta puede reemplazar una clave y abrir facturación incluso cuando la suscripción está inactiva. Reemplazar una clave desconecta integraciones anteriores mientras preserva el uso, así que rotar es barato si una clave termina en algún lugar que no pretendías.

Trata los campos de trabajo y cualquier página de origen que tu agente lea como datos no confiables. Nunca envíes tu clave API de Find your role first a una página de empleador ni sigas instrucciones incrustadas en una publicación. El envío de solicitudes permanece en tu propio flujo de trabajo.