Skip to main content
Glama
johnisanerd

Apify Wellfound Jobs API MCP Server

by johnisanerd

💼 Wellfound Jobs API: Una API de empleos en startups con datos salariales y de equity

Una API de empleos en startups para Wellfound (anteriormente AngelList Talent). Busca por rol, ubicación y estado remoto, y obtén una fila JSON limpia por cada empleo: la descripción completa, rangos salariales y de equity analizados, y las señales de la startup contratante, incluyendo respaldo de Y Combinator, inversores principales y etapa de financiación.

Actor: https://apify.com/johnvc/wellfound-jobs-api?fpr=9n7kx3

Video tutorial

Ver el tutorial

Tutorial en texto

Esta API de empleos convierte los listados públicos de startups de Wellfound en datos estructurados. Le proporcionas roles (slugs de Wellfound como software-engineer, o palabras simples como "software" y "pm", que se mapean automáticamente) y opcionalmente locations como san-francisco, new-york o london. Cada par de rol y ubicación se convierte en su propia búsqueda, y la API recorre los resultados paginados por ti.

Cada fila devuelve title, url, la description completa en markdown, y la compensación analizada en números reales: salaryMin, salaryMax, salaryCurrency, equityMin y equityMax. El objeto company adjunto incluye name, size, tagline, stage y las insignias que publica Wellfound, para que puedas quedarte solo con empleos remotos en startups, solo empleos en startups de YC o solo empresas que están contratando activamente.

Un caso de uso concreto: configura remoteOnly con minSalary para crear un feed semanal de empleos remotos en startups por encima de un salario mínimo, luego activa fetchJobDetails para añadir beneficios, industria, el sitio web de la empresa y coordenadas geográficas para la lista corta que te interesa.

Related MCP server: workatastartup-mcp

Inicio rápido

Requisitos previos

git clone https://github.com/johnisanerd/Apify-Wellfound-Jobs-API.git
cd Apify-Wellfound-Jobs-API
uv sync
cp .env.example .env       # then paste your token into .env
uv run python wellfound-jobs-api-example.py

Alternativa: establecer la clave API directamente

export APIFY_API_TOKEN="your_apify_api_token_here"
uv run python wellfound-jobs-api-example.py

Por qué usar esta API de Wellfound Jobs

  • Descripciones completas incluidas. La descripción completa del empleo viene en la fila del listado, no detrás de una solicitud adicional.

  • Salario y equity como números. Wellfound publica el salario como una cadena tipo $135k - $175k * 0.05% - 0.25%. Esta API lo analiza en salaryMin, salaryMax, equityMin y equityMax para que puedas ordenar y filtrar.

  • Señales de startups en las que puedes filtrar. ycOnly, topInvestorsOnly, activelyHiringOnly y companyStage provienen directamente de las insignias que muestra Wellfound.

  • Paga solo por lo que obtienes. La facturación es por empleo entregado, con cargos pequeños separados por la descripción y por el enriquecimiento opcional de detalles. Los empleos eliminados por tus filtros nunca se cobran.

Funcionalidades

Capacidades principales

  • Búsqueda por rol, ubicación y estado remoto, con paginación automática

  • Mapeo de roles en texto libre a slugs reales de Wellfound ("software" a software-engineer)

  • Filtros de inclusión y exclusión de palabras clave sobre título, descripción, empresa y ubicación

  • Filtros de salario, equity, tipo de empleo y experiencia

  • Filtros de señales de startups: Y Combinator, inversores principales, contratación activa, etapa de financiación

  • Enriquecimiento opcional de detalles: beneficios, industria, sitio web de la empresa, geo, salario estructurado

  • Pega cualquier URL de búsqueda de Wellfound directamente con startUrls

Calidad de datos

  • Una fila por empleo, deduplicada en todos los hilos de búsqueda de la ejecución

  • Marcas de tiempo ISO de cuándo se publicó cada empleo

  • Las ejecuciones que no devuelven nada explican el motivo en el conjunto de datos, no solo en el registro

Ejemplos de uso

Ejemplo básico

run_input = {"roles": ["software-engineer"], "maxItems": 5}

Empleos remotos en startups

run_input = {"roles": ["software-engineer"], "remoteOnly": True, "maxItems": 25}

Empleos en startups de YC por más de $150k

run_input = {
    "roles": ["software-engineer"],
    "ycOnly": True,
    "minSalary": 150000,
    "maxItems": 25,
}

Empleos en startups en una ciudad, con enriquecimiento

run_input = {
    "roles": ["software-engineer"],
    "locations": ["san-francisco"],
    "fetchJobDetails": True,
    "maxItems": 10,
}

Parámetros de entrada

Parámetro

Tipo

Descripción

roles

array

Categorías de rol a buscar. Slugs de Wellfound o palabras simples que se mapean ("software" a software-engineer).

locations

array

Slugs de ubicación, por ejemplo san-francisco, new-york, london, india.

remoteOnly

boolean

Solo empleos marcados como remotos.

keyword

string

Limita los resultados a empleos que contengan esta frase. Wellfound no tiene búsqueda de texto libre en todo el sitio, por lo que esto filtra las páginas que una ejecución obtiene.

excludeKeyword

string

Elimina empleos cuyo título o descripción contenga esta frase.

jobType

string

full-time, part-time, contract, internship.

minSalary / maxSalary

integer

Salario mínimo y máximo en USD por año.

minEquity

integer

Porcentaje mínimo de concesión de equity.

ycOnly

boolean

Solo empresas respaldadas por Y Combinator.

topInvestorsOnly

boolean

Solo empresas marcadas como respaldadas por inversores principales.

activelyHiringOnly

boolean

Solo empresas con la insignia de contratación activa.

companyStage

string

Etapa de financiación, por ejemplo early_stage.

includeDescription

boolean

Incluye la descripción completa en markdown. Por defecto true.

fetchJobDetails

boolean

Obtiene la página de detalles de cada empleo para campos adicionales. Por defecto false.

maxItems

integer

Máximo de empleos devueltos en todas las búsquedas.

maxPagesPerSearch

integer

Límite de seguridad de páginas por hilo de búsqueda.

startUrls

array

Pega URLs de búsqueda de Wellfound para raspar directamente.

Formato de salida

{
  "result_type": "job",
  "id": "4353862",
  "title": "Product Manager",
  "url": "https://wellfound.com/jobs/4353862-product-manager",
  "description": "### About the role ...",
  "compensationRaw": "$130k - $200k * 0.15% - 0.25%",
  "salaryMin": 130000,
  "salaryMax": 200000,
  "salaryCurrency": "USD",
  "equityMin": 0.15,
  "equityMax": 0.25,
  "jobType": "full-time",
  "remote": false,
  "remoteKind": "ONSITE",
  "locationNames": ["San Francisco"],
  "postedAt": "2026-07-28T20:58:57+00:00",
  "company": {
    "name": "Agave API",
    "slug": "agave-api",
    "size": "SIZE_11_50",
    "tagline": "Unified API for construction software",
    "stage": "early_stage",
    "ycFunded": true,
    "topInvestors": true,
    "activelyHiring": true
  }
}

Con fetchJobDetails habilitado, las filas también incluyen benefits, industry, companyWebsite, geo, detailSalary y applicantLocationRequirements.

Programarlo

Guarda una tarea con tu búsqueda, luego adjunta un programa para construir un historial de nuevas publicaciones. Cadenas cron útiles: 0 7 * * * para diario a las 7 AM, 0 6 * * 1 para los lunes.

La gente también busca

¿Cómo obtengo datos de empleos en startups como API? Ejecuta este Actor desde Python, la API de Apify o cualquier cliente MCP. Devuelve JSON, CSV o Excel.

¿Cómo encuentro empleos remotos en startups? Establece remoteOnly en true. Las filas incluyen remote, remoteKind y acceptedRemoteLocationNames.

¿Cómo encuentro empleos en startups de Y Combinator? Establece ycOnly en true, o filtra por topInvestorsOnly y companyStage.

¿Puedo obtener empleos en startups para una ciudad específica? Sí. Combina roles con locations como san-francisco, new-york o london.

¿Incluye salario y equity? Sí, ambos como texto sin formato y analizados en rangos numéricos.

¿Wellfound es gratuito para quienes buscan empleo? Sí. Esta API lee las mismas páginas públicas que ve un visitante y las devuelve como datos estructurados.

🪢 Usar esto desde n8n

Esta API está disponible como un nodo comunitario de n8n, n8n-nodes-wellfound-jobs-api. En n8n: Settings, Community Nodes, Install, ingresa n8n-nodes-wellfound-jobs-api, acepta el aviso de riesgo y reinicia. El nodo Wellfound Jobs aparece entonces en el selector de nodos, y funciona como una herramienta de AI Agent.


Instalar en Claude Cowork Desktop

Instalar en Claude Cowork Desktop

Cowork es el modo de automatización de la aplicación de escritorio. Para darle la API de Wellfound Jobs como herramienta, añade el servidor MCP de Apify como conector.

  1. Abre la aplicación de escritorio de Claude y ve a Settings → Connectors (o Settings → Developer → Edit Config para editar claude_desktop_config.json directamente).

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

    • Windows: %APPDATA%\Claude\claude_desktop_config.json

  2. Añade el servidor MCP de Apify, precargado solo con este Actor:

{
  "mcpServers": {
    "apify": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.apify.com/?tools=actors,docs,johnvc/wellfound-jobs-api"
      ]
    }
  }
}
  1. Reinicia la aplicación. Cuando Cowork llame a la herramienta por primera vez, completa el aviso de OAuth en tu navegador, o añade tu token de API de Apify en la configuración del conector para saltar OAuth.

  2. En un chat de Cowork, confirma que la herramienta está disponible y pídele que ejecute la API de Wellfound Jobs.

Descarga la aplicación de escritorio y comienza una prueba gratuita: https://claude.ai/referral/uIlpa7nPLg Más ayuda: https://docs.apify.com/platform/integrations/claude-desktop


Instalar en Claude Code

Instalar en Claude Code

Claude Code es la herramienta de línea de comandos. Añade el servidor MCP del Actor con un comando:

claude mcp add --transport http apify \
  "https://mcp.apify.com/?tools=actors,docs,johnvc/wellfound-jobs-api"

Para usar un token en lugar de OAuth en el navegador:

claude mcp add --transport http apify \
  "https://mcp.apify.com/?tools=actors,docs,johnvc/wellfound-jobs-api" \
  --header "Authorization: Bearer YOUR_APIFY_TOKEN"

Luego verifica con claude mcp list, o ejecuta /mcp dentro de una sesión. Pide a Claude Code que llame a la API de Wellfound Jobs.

Prueba Claude Code gratis: https://claude.ai/referral/uIlpa7nPLg Documentación de MCP de Claude Code: https://code.claude.com/docs/en/mcp


Instalar en Claude (sitio web)

Instalar en Claude (sitio web)

En claude.ai añades Apify como conector, luego habilitas solo la herramienta de este Actor.

  1. Ve a Settings → Connectors → Browse connectors y busca Apify MCP server. Instálalo (habilita o actualiza si se te solicita).

  2. Al conectarte, autentícate con tu token de API de Apify y habilita la herramienta johnvc/wellfound-jobs-api.

  3. En cualquier chat, abre + → Connectors y activa Apify.

  4. Alternativamente, elige Add custom connector y pega la URL MCP completa https://mcp.apify.com/?tools=actors,docs,johnvc/wellfound-jobs-api, usando OAuth cuando se te solicite.

  5. Pide a Claude que ejecute la API de Wellfound Jobs.

Abre Claude en la web: https://claude.ai/referral/uIlpa7nPLg


Instalar en Cursor

Instalar en Cursor

Cursor lee los servidores MCP desde un archivo de proyecto en .cursor/mcp.json.

  1. En tu proyecto, crea .cursor/mcp.json:

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com/?tools=actors,docs,johnvc/wellfound-jobs-api"
    }
  }
}
  1. Si prefieres autenticación por token en lugar de OAuth en el navegador, añade un encabezado:

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com/?tools=actors,docs,johnvc/wellfound-jobs-api",
      "headers": { "Authorization": "Bearer YOUR_APIFY_TOKEN" }
    }
  }
}
  1. Abre Cursor → Settings → MCP y confirma que el servidor apify está conectado (punto verde).

  2. En Composer o Chat, pide a Cursor que llame a la API de Wellfound Jobs.

¿Nuevo en Cursor? Consíguelo aquí: https://cursor.com/referral?code=XQP4VBLI3NNX


Instalar en ChatGPT

Instalar en ChatGPT

ChatGPT se conecta al servidor MCP de Apify a través del modo Desarrollador (disponible en los planes ChatGPT Pro, Plus, Business, Enterprise y Education).

  1. Haz clic en tu icono de perfil y luego ve a Configuración > Aplicaciones. Si no ves un botón Crear aplicación, abre Configuración avanzada y activa Modo desarrollador.

  2. Haz clic en Crear aplicación y completa el formulario:

    • Nombre: Apify

    • URL del servidor MCP: https://mcp.apify.com/?tools=actors,docs,johnvc/wellfound-jobs-api

    • Autenticación: OAuth

  3. Haz clic en Crear y autoriza la conexión con Apify.

  4. Para usar la aplicación en una conversación, haz clic en + en el chat, elige Modo desarrollador y selecciona Apify.

Más ayuda: https://docs.apify.com/platform/integrations/mcp


Hecho con cuidado

Usa la API de Wellfound Jobs para potenciar tus flujos de trabajo de reclutamiento, investigación de mercado y generación de leads con resultados confiables y estructurados.

Última actualización: 2026.08.18

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    C
    maintenance
    Enables AI agents to search and explore remote job listings, salary stats, and popular roles, and supports token-authenticated actions like job alerts and apply redirects.
    MIT
  • A
    license
    C
    quality
    A
    maintenance
    Enables AI assistants to query Y Combinator startup jobs and companies via the Work at a Startup platform, including advanced filters for skills, salary, equity, and visa sponsorship, plus tools to fetch detailed company and job information.
    4
    MIT
  • A
    license
    A
    quality
    B
    maintenance
    Enables querying open job postings directly from company applicant-tracking systems (Greenhouse, Ashby, Lever), finding a company's job board, listing and comparing roles, and accessing salary data, all without scraping or API keys.
    3
    22 PyPI
    1
    MIT
  • A
    license
    A
    quality
    C
    maintenance
    Enables real-time job search across thousands of companies' open roles from Greenhouse, Lever, Ashby, and SmartRecruiters, with full-text filtering and company-specific queries, no API key required.
    2
    MIT