> ## 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. # Encontre contatos estratégicos > Encontre contatos existentes por seguidores e contexto, deixando claros os dados ausentes e a cobertura parcial. ## Use esta skill de agente Copie as instruções abaixo para um arquivo `SKILL.md` dentro de uma pasta chamada `levios-strategic-contacts` e adicione pelo mecanismo de skills suportado pelo seu cliente. Se ele não carregar arquivos de skill, forneça esse conteúdo ao agente como instruções da tarefa. Isso não instala nada nem habilita ferramentas por conta própria. A skill usa inglês para manter uma única versão das instruções e orienta o agente a responder no seu idioma. ```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). ``` ## Referência e exemplos Você pode pedir: “Mostre contatos com mais de 10.000 seguidores que possam ser parceiros relevantes.” O agente analisa pessoas já registradas na conta levios selecionada. Não é uma busca por todos os usuários do Instagram nem uma exportação de toda a lista de seguidores da conta. ## Defina a seleção Escolha conta, limite de seguidores e motivo da busca. A contagem pode ajudar a priorizar alcance, mas não comprova engajamento, afinidade de público nem intenção de compra. Use biografia e contexto de interação disponíveis para explicar por que alguém pode ser relevante e identifique isso como inferência. `list_contacts` exige `contacts:read_pii`. Há filtro exato por `instagram_username`. Não há parâmetro de mínimo de seguidores, filtro de tag nem ordenação. O agente percorre as páginas e filtra os registros retornados. ## Trate os limites e as informações ausentes Para “acima de 10 mil”, use `followers_count > 10000`. Para “pelo menos 10 mil”, use `followers_count >= 10000`. Um valor `null` é desconhecido, não zero. Confira `enrichment_status` e `last_enriched_at`. Separe dados desatualizados, com falha, pendentes e ausentes das contagens utilizáveis. Consultar um contato não força uma atualização do perfil, e contagens armazenadas não são medições ao vivo. ## Deixe a cobertura explícita Passe cada `next_cursor` retornado, sem alterações, para o próximo `cursor`. Uma página pode conter até 50 registros. Não conclua que não há resultados olhando apenas a primeira página. Para uma lista grande, combine um lote viável e guarde o cursor restante. Informe registros examinados, resultados, contagens desconhecidas, registros desatualizados e se há mais páginas. Só declare a busca esgotada quando o cursor terminar. Mesmo uma busca completa em dados variáveis não é um retrato congelado. Um resultado útil diz: “Examinei 200 contatos; 12 têm contagem registrada acima de 10.000, 30 têm contagem desconhecida e ainda há páginas.” Esses números são ilustrativos, não dados de uma conta. ## Revise e organize os resultados Mostre nome de usuário, contagem registrada, atualização, contexto relevante e `instagram_profile_url`. Não inclua email ou telefone sem relação com a análise. Use `get_contact` para candidatos selecionados que precisem de tags, atributos ou atividade. A linha do tempo não garante uma transcrição completa da conversa. Se você pedir para organizar a lista, o agente pode usar `list_contact_tags`, `create_contact_tag` e `attach_contact_tag` com `contacts:write`. Uma tag organiza o contato; não inicia uma campanha. `send_instagram_dm_url` abre o Instagram. Não é uma ferramenta de envio pelo MCP nem evidência de janela de mensagens aberta. Um pedido de análise não instrui o agente a contatar ninguém. Respeite `opt_out` e `blocked` ao sugerir abordagens. Quando disponível, o tópico `contacts` de `get_automation_guide` fornece essas etapas ao agente. Veja [Limites do Instagram](/pt-BR/mcp/instagram-limits) para entender os limites de envio. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.