Vibe Prospecting

Prospección B2B: empresas, contactos, enriquecimiento, eventos.

Plataforma

Antes de cualquier trabajo de prospección, detecta tu anfitrión usando las reglas a continuación, lee exactamente una guía de plataforma y síguela para autenticación, flujo de trabajo, banderas y solución de problemas.

Detección de tu entorno de ejecución (obligatorio, en orden)

Identidad del anfitrión en tu contexto del sistema (verifica esto primero — anula los nombres de las herramientas):
- Claude Code — el contexto indica que eres Claude Code / CLI de Anthropic, o muestra un bloque de Entorno de CLI (cwd, shell, plataforma). → lee solo claude-code.md. No leas claude-chat.md ni cowork.md. Las herramientas MCP en la lista (mcp__*__fetch-entities) no cambian esto.
- OpenAI Codex — el contexto identifica Codex o CODEX_SHELL=1. → codex.md
- OpenClaw — el contexto identifica OpenClaw o OPENCLAW_CLI=1 / OPENCLAW_SHELL. → openclaw.md
Solo si el paso 1 no coincidió — no hay identidad de anfitrión CLI, no hay shell:
- Claude Cowork — espacio de trabajo Cowork, instalación .plugin, conector de tienda. → cowork.md
- Claude Chat — claude.ai o conector MCP de escritorio de Claude (no Cowork). → claude-chat.md
Fallback: terminal, scripts, CI o anfitrión desconocido → other.md

Nunca infieras la plataforma solo por los nombres de las herramientas MCP (mcp__claude_ai_*, mcp__*__fetch-entities, etc.). Los prefijos de herramientas no son una señal del anfitrión cuando el paso 1 ya identificó Claude Code, Codex u OpenClaw.

Plataforma	Leer ahora
Claude Code	`claude-code.md` — CLI `vpai`
OpenAI Codex	`codex.md`
Gateway OpenClaw	`openclaw.md`
Claude Cowork	`cowork.md` — conector MCP; no Claude Code
Claude Chat (claude.ai, escritorio Claude)	`claude-chat.md` — conector MCP; no Cowork ni Claude Code
Otros (terminal, scripts, CI, anfitriones genéricos)	`other.md`

Los anfitriones CLI usan vpai — cada guía de plataforma es autónoma (Sample Gate, stdout/csv_path, carga CSV). Chat/Cowork siguen solo la descripción de cada herramienta MCP y su esquema de entrada.

Reglas estrictas

tool_reasoning (o equivalente de la plataforma) en cada llamada real. Usa la solicitud del usuario textual. Reutiliza en todo el flujo de trabajo. Omite solo cuando inspeccionas el esquema de entrada de una herramienta sin ejecución real.
Encadena mediante sesión + CSV, nunca pegues IDs. Cada paso devuelve session_id y csv_path (los nombres pueden variar ligeramente según el anfitrión). Nunca inventes session_id — en el primer paso omítelo y usa el valor que devuelve MCP; en pasos posteriores cópialo exactamente del JSON de la herramienta anterior. Pasa --csv-path (CLI) desde el csv_path anterior. No pegues listas de IDs en bruto en los argumentos de la herramienta cuando la plataforma lee los IDs del CSV de origen. Para fetch-entities de prospectos delimitados a empresas anteriores, pasa el csv_path de la salida comercial anterior mediante --businesses-csv-path según tu guía de plataforma.
Puedes editar el CSV entre pasos — conserva la columna de IDs. En anfitriones CLI, lee el archivo en csv_path , filtra/deduplica/añade columnas o reescribe filas, luego pasa el resultado al siguiente paso mediante --csv-path . Conserva siempre la columna de ID de entidad: business_id para flujos de trabajo de empresas, prospect_id para flujos de trabajo de prospectos. Cada fila que quieras procesar a continuación debe tener un ID no vacío en esa columna. No renombres ni elimines esos encabezados — el CLI los lee textualmente para la inyección de IDs y las uniones.
autocomplete primero para: naics_category, linkedin_category, company_tech_stack_tech, job_title, interests, skills, business_intent_topics, city_region. Usa los valores estandarizados devueltos, no las palabras del usuario en bruto.
Nunca inventes parámetros de herramienta. Antes de la primera ejecución real de cada herramienta distinta en un flujo de trabajo, lee su esquema de entrada en vivo (del conector o de la detección de esquemas de tu plataforma). Haz esto incluso cuando la llamada planificada parezca obvia — los esquemas cambian. Vuelve a leer cuando las herramientas, filtros o formas cambien materialmente. Construye cada llamada solo a partir de campos confirmados por ese esquema.
Continuidad de sesión. Reutiliza session_id del JSON de la herramienta anterior en cada paso posterior del mismo flujo de trabajo — nunca inventes uno. Reutiliza el csv_path del paso anterior mediante --csv-path (CLI) al encadenar enriquecimiento, eventos o búsquedas delimitadas. Inicia una nueva sesión solo para una tarea genuinamente nueva.
fetch-entities-statistics solo cuando las estadísticas respalden la búsqueda completa. Compara tu fetch-entities planificada con el esquema de entrada de fetch-entities-statistics . Llama a estadísticas solo si cada clave de filtro, forma de valor, entity_type y ámbito del que dependas (incluyendo CSVs de empresas con ámbito de sesión) se aceptan de la misma manera que para fetch-entities . Si falta alguna parte, no es compatible o necesita una forma diferente, omite las estadísticas — no la llames con un subconjunto parcial o adivinado. Cuando la llames, reutiliza el mismo objeto de filtro (y ámbito compatible) que fetch-entities , más tool_reasoning donde sea necesario. Vuelve a llamar a estadísticas antes de una búsqueda a gran escala si los filtros o el ámbito cambiaron y el conjunto de filtros de la búsqueda completa aún encaja en las estadísticas.

Mecánica de herramientas

Comportamiento y advertencias que el esquema de entrada en vivo puede no detallar. Para valores de filtro permitidos, cadenas de enumeración y nombres de tipos de enriquecimiento, usa siempre el esquema de entrada de cada herramienta.

Autocompletar

Requiere autocompletar: linkedin_category, naics_category, company_tech_stack_tech, job_title, interests, skills, business_intent_topics, city_region.

No requiere autocompletar: company_country_code (ISO Alpha-2), company_region_country_code (ISO 3166-2), grupos fijos (company_size, company_revenue, company_age, job_level, job_department — las cadenas permitidas exactas provienen del esquema de entrada de fetch-entities / fetch-entities-statistics ), website_keywords (texto libre).

Exclusiones mutuas: linkedin_category y naics_category — usa uno, no ambos. company_region_country_code y company_country_code — usa uno.

Selección de valores: El autocompletado puede devolver variantes ruidosas. Elige el valor canónico limpio (generalmente el primer resultado limpio). Múltiples valores amplían con lógica OR; evita duplicados cercanos a menos que quieras una búsqueda más amplia.

Búsqueda (Fetch)

job_title es coincidencia de subcadena, no exacta. Para búsquedas ejecutivas, combínalo con job_level (generalmente c-suite) para eliminar asistentes, asesores y roles de oficina.
company_size usa grupos fijos sin un límite numérico exacto. Para "más de N empleados", aproxima con grupos adyacentes o enriquece con firmographics para obtener un recuento exacto.
Los filtros de ubicación de empresas (company_country_code, company_region_country_code, city_region) coinciden solo con la sede central — no con sucursales o ubicaciones operativas.
Prospectos en empresas anteriores: Para fetch-entities con entity_type: prospects delimitado a empresas de un paso anterior, encadena mediante sesión y pasa el csv_path del paso de empresas anterior como --businesses-csv-path según tu guía de plataforma.
Límites de filas y paginación: según tu guía de plataforma (CLI: --number-of-results; Chat/Cowork: documentos de herramientas MCP).
max_per_company: se aplica automáticamente en búsquedas de prospectos para que los resultados se distribuyan entre empresas (no todos de un gran empleador); omítelo de --args a menos que el usuario lo establezca — su valor anula el límite automático.

Eventos (`fetch-businesses-events` / `fetch-prospects-events`)

Encadena desde la sesión del paso anterior y el CSV de origen con business_id (eventos de empresa) o prospect_id (eventos de prospecto).
Cuando los IDs provienen del CSV de origen, no pases también business_ids / prospect_ids en línea.
El procesamiento por lotes está limitado a 20 IDs por solicitud; los anfitriones pueden dividir y fusionar automáticamente.
Las columnas de salida son event_<event_type>: cada celda es una cadena de matriz JSON para ese tipo (del más nuevo al más antiguo, limitado por tipo), o vacía cuando no existen eventos para ese tipo.

Coincidencia (Match)

Omite la coincidencia si ya ejecutaste fetch-entities — esos resultados incluyen IDs.
La carga de archivos CSV es solo para CLI — consulta tu guía de plataforma.

Enriquecimiento (Enrich)

financial-metrics requiere parameters.date (consulta el esquema de entrada para el formato).
website-keywords requiere parameters.keywords.
El enriquecimiento por sí solo no encuentra personas en una empresa — usa fetch-entities con entity_type: prospects (delimitado a empresas anteriores cuando sea necesario) en su lugar.
Al encadenar desde un CSV de origen, business_ids / prospect_ids no necesitan aparecer en los argumentos de la herramienta.

Patrón de filtro

{ "values": ["v1", "v2"], "negate": false }   // incluir o excluir
{ "gte": 6, "lte": 24 }                       // rango
true | false | null                           // booleano (no envuelto)

Excepción — business_intent_topics: usa { "topics": ["Category:Topic"], "negate": false } (no values). Los temas deben provenir de autocomplete.

Coincidencia de ubicación: Los filtros de ubicación de empresas (company_country_code, company_region_country_code, city_region) coinciden con la sede central de una empresa solamente — no con sucursales/ubicaciones operativas. Una búsqueda de "empresas en el Reino Unido" devuelve empresas con sede en el Reino Unido y excluye, por ejemplo, una empresa extranjera que simplemente opera allí. Este es el valor predeterminado para todas las consultas de empresas de fetch-entities / fetch-entities-statistics y no es configurable por el usuario.

Límites

Herramienta	Límite
`match-business`	50 por llamada
`match-prospects`	40 por llamada
`enrich-business`	50 IDs por llamada
`enrich-prospects`	50 IDs por llamada
`fetch-businesses-events` / `fetch-prospects-events`	Hasta 20 IDs por solicitud al procesar por lotes. Pasa `event_types` y `timestamp_from` . Al encadenar, los IDs provienen del CSV de origen — no de matrices de IDs en línea.

Solución de problemas

Error	Solución
Autenticación, configuración del conector, invocación de CLI, banderas o sintaxis de encadenamiento	Lee la guía de plataforma correspondiente de la tabla de Plataforma
Resultados vacíos	Verifica los valores de filtro; ejecuta `autocomplete` para campos de vocabulario controlado; vuelve a leer el esquema de entrada de la herramienta
`linkedin_category` + `naics_category` juntos	Mutuamente excluyentes — usa uno
Parámetros inventados o no confirmados	Vuelve a leer el esquema de entrada en vivo antes de llamar; construye argumentos solo a partir de campos confirmados

Soporte

Cuando el usuario haga una pregunta relacionada con soporte (por ejemplo: cómo contactar al soporte, a quién contactar, tiene un problema o algo no funciona), responde brevemente y dirígelo aquí — no profundices en los internos de Explorium ni des explicaciones excesivas.

Para soporte, comunícate con el equipo de Vibe Prospecting a través de la página de contacto:

👉 https://www.vibeprospecting.ai/contact-us

vibe-prospecting

¿Qué es vibe-prospecting?

Preguntar en tu IA favorita

Documentación