Zooq

Fuera del sigilo: el eslabón perdido entre los agentes de IA y los datos de LinkedIn.

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 50 endpoints empaquetados como herramientas MCP facturadas por créditos.

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

Instalar: elige tu cliente

Instalar en Claude Desktop

Abre ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%/Claude/claude_desktop_config.json (Windows) y fusiona:

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

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

Instalar en Cursor

Configuración de Cursor → MCP → pega:

{ "mcp": { "servers": { "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 (50 herramientas)

El catálogo completo: 50 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).

Comentarios (1)

comments_all

Comentarios escritos por una persona en publicaciones. Paginados con cursor.

Empresas (11)

companies_entity_id

Resuelve el slug de una empresa al ID numérico de organización que usan los endpoints de empresa en vivo (posts, similares, afiliadas, insights). Resuelve una vez, reutiliza el ID.

companies_universal_name_to_id

Resuelve el slug de una 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; 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, sector, plantilla, sede, número de seguidores, especialidades.

companies_info_v2

Firmografía de la empresa como un registro de empresa plano (no anidado bajo una clave company\). Payload idéntico a /companies/info.

companies_name_lookup

Busca empresas por nombre. Devuelve registros de empresa coincidentes; el cursor de paginación no está disponible actualmente en este endpoint.

companies_employees_data

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

companies_similar

Empresas similares / pares (id, nombre, sector, 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\ de /api/v1/companies/entity-id para omitir la búsqueda.

companies_affiliated_pages

Páginas afiliadas / subsidiarias / showcase 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\ de /api/v1/companies/entity-id para omitir la búsqueda.

companies_insights

Total de empleados + categorías de distribución (por departamento, nivel de 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\ de /api/v1/companies/entity-id para omitir la búsqueda.

companies_posts

Publicaciones recientes de una empresa. data.activities[].entityId es el ID de actividad que consumen /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\ de /api/v1/companies/entity-id para omitir la búsqueda.

companies_jobs

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

Correo electrónico (5)

email_verify

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

email_find

Descubre el correo electrónico 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 y 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 ejecutar ningún trabajo.

email_prospects

Pagina los correos ya conocidos para un dominio de empresa. Paginados con cursor; devuelve hasta 20 contactos por página con nombre y apellido.

Empleos (5)

jobs_details_v2

Detalle completo de la 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 de comportamiento).

jobs_hiring_team

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

jobs_posted_by_profile

Ofertas de empleo creadas por una persona (p. ej., roles abiertos de un reclutador o fundador).

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áginas. Usa 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).

Publicaciones (5)

posts_featured

Feed de actividad de una persona (no hay un filtro 'destacado' separado — devuelve el feed). Clave por el entityId de la persona: pasa handle\ y Zooq lo resuelve por ti sin coste extra de créditos, o pasa entityId\ de /api/v1/profile/entity-id para omitir la búsqueda.

posts_all

Publicaciones recientes / flujo de actividad de una persona. Paginado con 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\ de /api/v1/profile/entity-id para omitir la búsqueda.

posts_info

Contenido completo de una publicación (devuelto bajo data.post). Para comentarios usa /posts/comments.

posts_comments

Comentarios/respuestas en hilo en una publicación.

posts_likes

Personas que reaccionaron a una publicación + tipo de reacción y total.

Perfil (14)

profile_overview

Registro profesional por handle o prsn_ id estable (devuelve el perfil completo).

profile_full

Perfil completo en una sola llamada: puestos, educación, habilidades, certificaciones.

profile_entity_id

Resuelve un handle público al entityId de la persona que usan los endpoints de persona en vivo (posts, comments, interests, lookalikes). Resuelve una vez, reutiliza el ID.

profile_details

Registro profesional completo por prsn_ id estable (o handle).

profile_about

Resumen del perfil + porción de ubicación del registro completo.

profile_full_experience

Historial laboral completo (porción full_positions del registro de perfil).

profile_education

Historial educativo (porción education del registro de perfil).

profile_skills

Habilidades (porción skills del registro de perfil). Una matriz vacía es legítima: algunos perfiles no listan habilidades.

profile_certifications

Certificaciones (porción certifications del registro de perfil). Una matriz vacía es legítima: algunos perfiles no listan ninguna.

profile_social_matrix

Recuentos de seguidores + conexiones y marcas de perfil (porción del registro).

profile_username_to_urn

Resuelve un handle público a su prsn_ id de perfil estable (el ID de dataset usado por las búsquedas /profile/*). Para los endpoints de persona en vivo — posts, comments, interests — usa /api/v1/profile/entity-id; los dos IDs no son intercambiables. La respuesta es el registro de perfil completo — lee data.id; no se necesita una segunda llamada.

profile_recommendations

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

profile_similar

Perfiles profesionales similares — expande una lista corta desde un ejemplo.

profile_interests

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

Búsqueda (6)

search_people

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

search_companies

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

search_jobs

Búsqueda de empleos/oportunidades con el conjunto completo de filtros: ubicación, salario, experiencia, tipo de trabajo y más. Paginado por offset. data.jobs[].id es el opportunityEntityId que consumen /jobs/details-v2, /jobs/similar, /jobs/people-also-viewed, /jobs/hiring-team.

search_schools

Busca instituciones por nombre (coincidencia parcial). Paginado por páginas. Usa 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 cargo en organizaciones. Paginado por páginas. Diseñado para prospección basada en desencadenantes y monitoreo de territorio.

search_alumni

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

Cada herramienta tiene el mismo coste 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 que permite a los clientes de IA (Claude, etc.) descubrir y llamar herramientas externas en tiempo de ejecución. En lugar de que escribas wrappers de API en el código de tu agente, tu agente lee una lista de herramientas de 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 drenar tu saldo: el servidor impone un límite de créditos máximos por hora por usuario (10.000/h por defecto, ~1.000 llamadas). Incluso el daño de una clave comprometida está acotado.

Deducción de créditos atómica

Cada llamada de 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 contra el esquema declarado del endpoint. Las claves desconocidas se descartan; los valores demasiado grandes se truncan. Detiene intentos de inyección en el proxy upstream.

Revocable con un clic

¿Sospechas que tu clave se filtró? Abre /dash y vuelve a generarla. La clave anterior deja de funcionar de inmediato.

Ejemplos de uso

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

• "Dame el perfil completo de LinkedIn de satyanadella" → profile_full
• "¿Qué dice la página de LinkedIn de Stripe?" → companies_name_lookup luego companies_info
• "Encuentra 10 VPs de Ingeniería en empresas SaaS en San Francisco" → search_people
• "Extrae cada rol abierto en Microsoft" → companies_universal_name_to_id luego search_jobs con filtro companies
• "Mapea el crecimiento de plantilla de la empresa X en 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 dónde.

Precios

Cada llamada de herramienta MCP deduce 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 niveles de suscripción.

Resolución de problemas

• Las herramientas no aparecen en el cliente: reinicia la aplicación por completo (sal de ella, no solo la cierres). Verifica que tu JSON de configuración sea válido.
• "Clave API no válida": vuelve a verificar 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 servicio upstream podría estar temporalmente degradado — consulta /status. Si es 5xx, tus créditos se reembolsan automáticamente.

Obtén una clave API →