Búsqueda de Personas
Produce una lista corta y auditable sin pretender que la habilidad misma otorgue acceso a datos de LinkedIn.
Elige el modo de datos
Usa el modo más fuerte ya disponible: CSV/perfiles/exportación proporcionados; búsqueda web pública; una sesión autenticada autorizada; o un proveedor conectado como HarvestAPI o Apify. Si no hay una fuente de descubrimiento disponible, devuelve un plan de búsqueda normalizado, filtros listos para ejecutar y una plantilla de entrada. Nunca fabriques perfiles.
Flujo de trabajo
- Traduce la solicitud al esquema canónico.
- Separa los requisitos estrictos de las preferencias de clasificación. Trata los criterios vagos como preferencias a menos que sean explícitamente obligatorios.
- Indica el modo seleccionado y sus límites de cobertura.
- Mapea los filtros canónicos a los campos del proveedor y divulga cada filtro aplicado, aproximado, descartado o no compatible.
- Ejecuta la prueba más barata y útil antes de una búsqueda paga/completa. Detente en resultados no válidos, silenciosamente vacíos o fuera de objetivo.
- Deduplica por URL de perfil estable, luego por nombre normalizado más empresa actual.
- Clasifica según el resumen original, conserva las URL de evidencia y distingue los hechos obtenidos de la inferencia.
- Devuelve la lista corta, la receta de búsqueda, las advertencias y el refinamiento de mayor valor.
Límites
- Una habilidad es orquestación, no una licencia de datos. Nunca impliques acceso integrado a LinkedIn.
- Nunca expongas, incrustes o persistas credenciales de proveedores.
- Deja claro el modo que conlleva costo antes de una búsqueda paga; prefiere vistas previas y expansión gradual.
- Nunca interpretes cero resultados como que no hay personas coincidentes hasta que se verifiquen la validez de la solicitud y la compatibilidad de filtros.
- No envíes solicitudes de conexión ni mensajes sin autorización separada.
Para el comportamiento del adaptador y los contratos de resultados, lee references/provider-contract.md.
Ejecutor determinista
Usa scripts/people_search.py para ejecución solo de plan, importación/clasificación de CSV y prueba de verificación de proveedor. Las credenciales del proveedor deben ingresar a través de la variable de entorno nombrada a nivel de proceso; nunca pases un token como argumento.