Zooq

API de datos de LinkedIn y servidor MCP para agentes de IA: perfiles públicos, empresas y publicaciones como JSON limpio, sin inicio de sesión, 300 créditos gratuitos.

Ver en zooq.devPrueba este MCPPatrocinado

Documentación

El servidor MCP de Zooq

Añade Zooq a cualquier cliente compatible con MCP (Claude Desktop, Cursor, Codex, Hermes, Openclaw) y tu agente obtiene el catálogo completo de Zooq: los 44 endpoints envueltos como herramientas MCP facturadas por créditos.

Obtén tu clave + 300 créditos gratis →

Instalación: elige tu cliente

Instalar en Claude Desktop

Abre Configuración → Conectores → Añadir conector personalizado y pega esta URL (tu clave va dentro — no se necesitan cabeceras):

https://zooq.dev/api/mcp?key=zq_...

Reemplaza zq_... con tu clave desde /dash. Reinicia Claude. Las herramientas aparecen en el menú de herramientas bajo "zooq".

Mantén esa URL privada — la clave está dentro. Si alguna vez se filtra, rota la clave desde tu panel. Reinicia Claude Desktop después de añadirla; las herramientas aparecen en la siguiente conversación.

Instalar en Cursor

Configuración de Cursor → MCP → pega:

{
  "mcpServers": {
    "zooq": {
      "url": "https://zooq.dev/api/mcp",
      "headers": { "X-API-Key": "zq_..." }
    }
  }
}

Instalar en Codex

Edita ~/.codex/config.toml — añade:

[mcp_servers.zooq]
url = "https://zooq.dev/api/mcp"
http_headers = { "X-API-Key" = "zq_..." }

Instalar en Hermes

Edita ~/.hermes/config.yaml — fusiona bajo mcp_servers:

mcp_servers:
  zooq:
    url: "https://zooq.dev/api/mcp"
    headers:
      X-API-Key: "zq_..."
    enabled: true

Instalar en Openclaw

Edita ~/.openclaw/openclaw.json — fusiona en el objeto raíz (o ejecuta openclaw mcp set zooq '<json>'):

{
  "mcp": {
    "servers": {
      "zooq": {
        "url": "https://zooq.dev/api/mcp",
        "headers": {
          "X-API-Key": "zq_..."
        }
      }
    }
  }
}

Lo que obtiene tu agente (44 herramientas)

El catálogo completo — 44 endpoints en 8 categorías, todos invocables desde tu cliente MCP. Los nombres de las herramientas siguen la convención category_endpoint (p. ej. profile_full, companies_info_v2, search_jobs).

Empresas (11)

companies_entity_id

Resuelve un slug de empresa al id numérico de organización usado por los endpoints de empresa en vivo (posts, similares, afiliadas, insights). Resuelve una vez, reutiliza el id.

companies_universal_name_to_id

Resuelve un slug de empresa (la parte después de linkedin.com/company/) a su org_ id estable — el id de dataset usado por /companies/info. Para los endpoints de empresa en vivo (posts, similares, afiliadas, insights) usa /api/v1/companies/entity-id en su lugar; los dos ids no son intercambiables. Devuelve el registro COMPLETO de la empresa (idéntico a /companies/info) — lee data.id\.

companies_info

Firmografía completa de la empresa — descripción, industria, plantilla, sede, número de seguidores, especialidades.

companies_enrich

Perfil de empresa EN VIVO más reciente. Devuelve tres cosas que el registro de dataset detrás de /api/v1/companies/info no incluye: señales de financiación, la lista COMPLETA de ubicaciones (no solo la sede), y páginas padre/afiliadas/relacionadas. Pasa slug\ y Zooq lo resuelve al id numérico sin coste extra de créditos, o pasa id\ desde /api/v1/companies/entity-id para omitir la búsqueda. No encontrado es gratis en el upstream.

companies_name_lookup

Busca empresas por nombre, con el conjunto completo de filtros firmográficos. Paginado por cursor. Mismo upstream que /api/v1/search/companies — usa el punto de entrada que te resulte más claro; son equivalentes.

companies_employees_data

Personas que trabajan o trabajaron en una organización (registros profesionales, misma forma que /search/people). Paginado por cursor.

companies_similar

Empresas similares / pares (id, nombre, industria, seguidores, url). Clave por el id numérico de organización: pasa slug\ y Zooq lo resuelve por ti sin coste extra de créditos, o pasa id\ desde /api/v1/companies/entity-id para omitir la búsqueda.

companies_affiliated_pages

Páginas afiliadas / subsidiarias / de escaparate de una empresa. Clave por el id numérico de organización: pasa slug\ y Zooq lo resuelve por ti sin coste extra de créditos, o pasa id\ desde /api/v1/companies/entity-id para omitir la búsqueda.

companies_insights

Total de empleados + buckets de distribución (por departamento, antigüedad, ubicación). Clave por el id numérico de organización: pasa slug\ y Zooq lo resuelve por ti sin coste extra de créditos, o pasa id\ desde /api/v1/companies/entity-id para omitir la búsqueda.

companies_posts

Posts recientes de una empresa. data.activities[].entityId es el id de actividad consumido por /posts/info, /posts/comments, /posts/likes. Clave por el id numérico de organización: pasa slug\ y Zooq lo resuelve por ti sin coste extra de créditos, o pasa id\ desde /api/v1/companies/entity-id para omitir la búsqueda.

companies_jobs

Ofertas de empleo abiertas en una o más organizaciones.

Email (5)

email_verify

Comprueba si una dirección de correo puede recibir mensajes, con un veredicto de entregabilidad y banderas de riesgo (catch-all, desechable, sin-MX).

email_find

Descubre el correo laboral de una persona a partir de su nombre, apellido y dominio de empresa. Devuelve la dirección más una puntuación de confianza.

email_find_by_profile

Identifica a una persona y su empresa actual desde una URL de perfil profesional (o handle), y luego encuentra su correo laboral — resuelve nombre + dominio por ti.

email_reverse

Resuelve la persona y la empresa detrás de una dirección de correo EMPRESARIAL. Los buzones públicos/de rol/desechables son rechazados (422, sin cargo) antes de que se ejecute cualquier trabajo.

email_prospects

Correos de página ya conocidos para un dominio de empresa. Paginado por cursor; devuelve hasta 20 contactos por página con nombre y apellido.

Empleos (5)

jobs_details_v2

Detalles completos de una oferta de empleo — título, descripción, funciones, URL de solicitud, organización, ubicación.

jobs_similar

Ofertas de empleo similares (título, organización, ubicación, rango salarial, fecha de publicación).

jobs_people_also_viewed

Publicaciones de 'personas también vieron' (relación conductual).

jobs_hiring_team

Perfiles de miembros del equipo de contratación para una oferta. Miembros vacíos pueden significar que la oferta realmente no lista equipo O que el id de la oferta no fue reconocido.

jobs_posted_by_profile

Ofertas de empleo publicadas por una persona (los roles de un reclutador, gerente de contratación o fundador). Incluye ofertas cerradas (jobState\). Solo las personas que han publicado empleos devuelven resultados: para cualquier otra persona el upstream responde 422 "los datos no se pueden mostrar o no existen" — eso es un no encontrado, no un id incorrecto. Encuentra a los publicadores vía /api/v1/jobs/hiring-team en una oferta en vivo.

Búsquedas (3)

g_title_skills_lookup

Búsqueda en el catálogo de habilidades por nombre (coincidencia parcial) — solo habilidades, a pesar del nombre del endpoint. Paginado por página. Úsalo para encontrar el skl_ id o normalized_name de una habilidad para el filtro de habilidades de /search/people.

g_institution_lookup

Resuelve una institución por su nombre normalizado — devuelve el nombre de la escuela, la url y el inst_ id estable. Obtén el normalized_name de /api/v1/search/schools primero.

g_skill_lookup

Resuelve una habilidad por su skl_ id estable — devuelve el nombre mostrado y el nombre normalizado. Obtén el id de /api/v1/g/title-skills-lookup (búsqueda de habilidades).

Posts (4)

posts_all

Posts recientes / flujo de actividad de una persona. Paginado por cursor u offset. Clave por el entityId de la persona: pasa handle\ y Zooq lo resuelve por ti sin coste extra de créditos, o pasa entityId\ desde /api/v1/profile/entity-id para omitir la búsqueda.

posts_info

Contenido completo de un post (devuelto bajo data.post). Para comentarios usa /posts/comments.

posts_likes

Personas que reaccionaron a un post + tipo de reacción y total.

Perfil (7)

profile_full

Perfil completo en una sola llamada — puestos, educación, habilidades, certificaciones, geografía, recuentos de seguidores/conexiones y banderas. Esta es la lectura canónica del perfil; las otras rutas profile/* (overview, details, about, education, skills, certifications, full-experience, social-matrix) son alias con nombre que devuelven exactamente el mismo registro.

profile_entity_id

Resuelve un handle público al entityId de la persona usado por los endpoints de persona en vivo (posts, comentarios, intereses, lookalikes). Resuelve una vez, reutiliza el id.

profile_enrich

Instantánea EN VIVO más reciente de un perfil, por handle o entityId — no el registro de dataset deduplicado que devuelven los otros endpoints profile/*. Lleva banderas solo-en-vivo (openToWork, isHiring, isTopVoice) y devuelve el entityId de la persona, el id que necesita cualquier otro endpoint de persona en vivo.

profile_employment_history

Historial laboral EN VIVO completo de una persona: organización por rol, título, descripción, ubicación, fechas analizadas, habilidades por rol y agrupaciones de posiciones paralelas (títulos concurrentes mantenidos distintos en lugar de aplanados). Se superpone con /api/v1/profile/full-experience, que lee el registro de dataset — usa este cuando necesites frescura, habilidades por rol o manejo correcto de roles concurrentes. Pasa handle\ y Zooq lo resuelve sin coste extra de créditos, o pasa entityId\ desde /api/v1/profile/entity-id para omitir la búsqueda. No encontrado es gratis en el upstream.

profile_recommendations

Recomendaciones escritas para la persona, con detalles del autor y texto.

profile_similar

Perfiles profesionales similares — amplía una lista corta desde un ejemplo.

profile_interests

Entidades que la persona sigue (empresas, grupos, personas, newsletters).

Búsqueda (8)

search_people

Busca registros profesionales con filtros ricos — nombre, título, empresa, habilidades, educación, antigüedad, geografía. Paginado por cursor.

search_companies

Busca organizaciones por nombre o sitio web con filtros firmográficos. Paginado por cursor.

search_jobs

Búsqueda de empleos/oportunidades con el conjunto completo de filtros. El filtrado por ubicación funciona: pasa locations\ un id de geo de LinkedIn (p. ej. 101570771 para Tel Aviv-Yafo) — consulta ese parámetro para saber cómo encontrar uno, y ten en cuenta que es una coincidencia EXACTA, así que usa un id de ciudad en lugar de un id de país. Siguen siendo de tipo id y aún no utilizables: títulos, industrias, funciones, beneficios, compromisos. Paginado por offset. data.jobs[].id es el opportunityEntityId consumido por /jobs/details-v2, /jobs/similar, /jobs/people-also-viewed, /jobs/hiring-team.

search_people_live

Búsqueda de personas EN VIVO — el único endpoint que filtra por empresa actual, empresa anterior Y escuela a la vez. Complementa a /api/v1/search/people (el dataset deduplicado, paginado por cursor, geo de cadena simple): usa este para el historial de empresas, aquel para filtrado firmográfico amplio. Paginado por offset. No encontrado es gratis en el upstream.

search_companies_live

Búsqueda de empresas EN VIVO. Su atractivo es hasJobs\ — un filtro de contratación activa disponible en ningún otro lugar del catálogo — además de búsqueda por tamaño de plantilla en buckets. Para filtrado firmográfico (recuentos de personal/seguidores, año de fundación, sitio web) usa /api/v1/search/companies en su lugar. Paginado por offset. No encontrado es gratis en el upstream.

search_schools

Busca instituciones por nombre (coincidencia parcial). Paginado por página. Úsalo para descubrir el inst_ id o normalized_name de una institución.

search_job_changes

Eventos recientes de cambio de empleo profesional — personas que se unieron, dejaron o cambiaron de título en organizaciones. Paginado por página. Diseñado para prospección basada en disparadores y monitoreo de territorios.

search_alumni

Exalumnos y estudiantes actuales de una institución (registros profesionales + el vínculo educativo). Paginado por página. Diseñado para reclutamiento y búsqueda de presentaciones en frío.

Cada herramienta cuesta la misma tarifa por llamada que su contraparte REST — consulta tu saldo en vivo y el coste por llamada en /dash.

¿Qué es MCP?

Model Context Protocol es el estándar abierto de Anthropic para permitir que los clientes de IA (Claude, etc.) descubran y llamen herramientas externas en tiempo de ejecución. En lugar de que tú escribas wrappers de API en el código de tu agente, tu agente lee una lista de herramientas desde un servidor MCP y las llama directamente vía JSON-RPC. Zooq expone sus endpoints de datos de esta manera.

Por qué es seguro instalarlo

Límite de consumo por hora

Una clave filtrada no puede vaciar tu saldo — el servidor aplica un límite de créditos máximos por hora por usuario (por defecto 10.000/h, ~1.000 llamadas). Incluso el daño de una clave comprometida está acotado.

Deducción atómica de créditos

Cada llamada a herramienta deduce créditos atómicamente. ¿El upstream devuelve 5xx? Los créditos se reembolsan automáticamente en segundos. Sin reintentos que cobren dos veces.

Lista blanca estricta de argumentos

Los argumentos de las herramientas se comparan con el esquema declarado del endpoint. Las claves desconocidas se descartan; los valores sobredimensionados se truncan. Detiene intentos de inyección en el proxy upstream.

Revocable con un clic

¿Sospechas que tu clave se filtró? Abre /dash y regenérala. La clave antigua deja de funcionar inmediatamente.

Ejemplos de uso

Una vez instalado, tu agente ve todas las herramientas listadas arriba. Ejemplos de prompts y la herramienta que el agente elegirá:

"Obtén el perfil completo de LinkedIn de satyanadella " → profile_full
"¿Qué dice la página de LinkedIn de Stripe?" → companies_name_lookup y luego companies_info
"Encuentra 10 VPs de Ingeniería en empresas SaaS en San Francisco" → search_people
"Extrae todas las vacantes abiertas en Microsoft" → companies_universal_name_to_id y luego search_jobs con el filtro companies
"Mapea el crecimiento de personal de la empresa X durante el último año" → companies_insights

Los agentes pueden encadenar herramientas de forma nativa: el protocolo MCP expone el esquema completo de parámetros para que el modelo sepa qué ID pasar y dónde.

Precios

Cada llamada a una herramienta MCP descuenta créditos en vivo, igual que la API REST. Sin mínimo mensual, sin recargo por MCP. Consulta /pricing para los paquetes de créditos y los niveles de suscripción.

Solución de problemas

Las herramientas no aparecen en el cliente: reinicia la aplicación por completo (cierra, no solo minimices). Verifica que tu JSON de configuración sea válido.
"Clave API inválida": revisa que copiaste la clave completa desde /dash (empieza con zq_).
"Créditos insuficientes" / "Pago requerido": recarga en /billing.
"Límite de créditos por hora alcanzado": el valor predeterminado es 10,000/h. Envía un correo a hello@zooq.dev para aumentarlo.
La herramienta no devuelve datos: el proveedor podría estar temporalmente degradado: consulta /status. Si es un error 5xx, tus créditos se reembolsan automáticamente.