> ## Documentation Index
> Fetch the complete documentation index at: https://docs.levios.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Encuentra contactos estratégicos

> Encuentra contactos existentes por seguidores y contexto sin ocultar los datos ausentes ni la cobertura parcial.

## Usa esta skill de agente

Copia las instrucciones de abajo en un archivo `SKILL.md` dentro de una carpeta
llamada `levios-strategic-contacts` y añádelo mediante el mecanismo de skills que
admita tu cliente. Si no carga archivos de skill, proporciona este contenido
al agente como instrucciones de la tarea. Esto no instala nada ni habilita
herramientas por sí solo. La skill usa inglés para mantener una sola versión
de las instrucciones y pide al agente que responda en tu idioma.

<Accordion title="SKILL.md">
  ```markdown theme={null}
  ---
  name: levios-strategic-contacts
  description: Find and assess strategic contacts already stored in levios, including people above 10k followers or a named Instagram contact. Use for account-scoped shortlists, follower thresholds, incomplete enrichment and authorized tagging. This is contact analysis, not Instagram-wide search or outbound messaging.
  ---

  # Find strategic contacts

  Answer in the user's language. Read `get_automation_guide` topic `contacts`.
  Resolve the account and the actual available `contacts:read_pii` permission.
  Do not run the automation-creation questionnaire for a contact lookup.

  ## Build an honest shortlist

  1. Clarify the requested segment or purpose only if unclear. For a named person,
     use `list_contacts` with its exact `instagram_username` filter.
  2. For a segment, paginate `list_contacts` using the returned cursor unchanged
     and a valid limit up to 50. There is no follower-range, tag or sort filter:
     apply the requested condition locally to returned records. "Above 10k"
     means `followers_count > 10000`; "at least 10k" means `>= 10000`.
  3. Treat `followers_count=null` as unknown, not zero. Include enrichment state
     and `last_enriched_at`; reading a record does not refresh Instagram data.
  4. Report the account, records examined, matches, unknown/stale data and whether
     a cursor remains. Claim complete coverage only after exhausting all pages.
     For a large scan, agree a practical batch budget and retain the remaining
     cursor; make partial coverage visible. Changing data is not a snapshot.
  5. Show username, count, data freshness, relevant tags and profile link. Explain
     audience fit only from available biography/context as an inference. Follower
     count is a reach signal, not proof of engagement, fit or purchase intent.
     Do not expose unrelated email or phone fields.
  6. Use `get_contact` only for selected people needing more detail. Timeline
     events are not guaranteed full conversation transcripts.

  ## Organize only when requested

  Use existing tag tools with real account-scoped IDs for authorized selections.
  A tag does not create a trigger or send campaign. `send_instagram_dm_url` opens
  Instagram; it is not an MCP send tool or proof of an open messaging window.
  Contact presence is not consent. Respect opt-out/blocked state and do not send
  messages just because analysis was requested.

  For a missing choice, use a native selector only if exposed and usable, following
  the pending-question lifecycle in topic `start`; otherwise ask concisely in chat.
  Do not invent followers-minimum trigger filters from this analysis capability.

  [Thresholds, coverage and result guidance](https://docs.levios.app/mcp/strategic-contacts).
  ```
</Accordion>

## Referencia y ejemplos

Puedes pedir: “Muéstrame contactos con más de 10.000 seguidores que puedan ser
socios relevantes.” El agente analiza personas ya registradas en la cuenta levios
seleccionada. No busca a todos los usuarios de Instagram ni exporta la lista
completa de seguidores de la cuenta.

## Define la selección

Elige cuenta, umbral y motivo de la búsqueda. El número de seguidores puede
ayudar a priorizar alcance, pero no demuestra interacción, afinidad de audiencia
ni intención de compra. Usa la biografía y el contexto de interacción disponibles
para explicar por qué alguien podría encajar e identifica ese juicio como inferencia.

`list_contacts` requiere `contacts:read_pii`. Admite un filtro exacto por
`instagram_username`. No acepta un mínimo de seguidores, un filtro de etiquetas
ni ordenación. El agente recorre las páginas y filtra los registros devueltos.

## Trata los umbrales y la información ausente

Para “más de 10 mil”, usa `followers_count > 10000`. Para “al menos 10 mil”, usa
`followers_count >= 10000`. Un valor `null` es desconocido, no cero.

Comprueba `enrichment_status` y `last_enriched_at`. Separa datos desactualizados,
fallidos, pendientes y ausentes de las cifras utilizables. Consultar un contacto
no fuerza una actualización del perfil; las cifras guardadas no son mediciones
en tiempo real.

## Explica la cobertura

Pasa cada `next_cursor` recibido sin cambios al siguiente `cursor`. Una página
puede contener hasta 50 registros. No concluyas que no hay coincidencias tras
consultar solo la primera página.

Para una lista grande, acuerda un lote manejable y conserva el cursor restante.
Informa de registros examinados, coincidencias, cifras desconocidas, registros
desactualizados y si quedan páginas. Solo declara la búsqueda agotada cuando
termine el cursor. Incluso un recorrido completo de datos cambiantes no es una
instantánea congelada.

Un resultado útil dice: “Examiné 200 contactos; 12 tienen una cifra registrada
superior a 10.000, 30 tienen una cifra desconocida y quedan páginas.” Estos
números son ilustrativos, no datos de una cuenta.

## Revisa y organiza los resultados

Muestra nombre de usuario, cifra registrada, actualización, contexto relevante
y `instagram_profile_url`. No incluyas correo o teléfono ajenos al análisis.
Usa `get_contact` para candidatos seleccionados que requieran etiquetas,
atributos o actividad. La cronología no garantiza una transcripción completa.

Si pides organizar la lista, el agente puede usar `list_contact_tags`,
`create_contact_tag` y `attach_contact_tag` con `contacts:write`. Una etiqueta
organiza el contacto; no inicia una campaña.

`send_instagram_dm_url` abre Instagram. No es una herramienta de envío del MCP
ni prueba de que la ventana de mensajes esté abierta. Una solicitud de análisis
no indica al agente que contacte a nadie. Respeta `opt_out` y `blocked` al
recomendar contactos comerciales.

Cuando esté disponible, el tema `contacts` de `get_automation_guide` ofrece estos
pasos al agente. Consulta [Límites de Instagram](/es/mcp/instagram-limits) para
conocer las restricciones de envío.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.