Conversor de Arquivo VCF (vCard) para JSON
Guia
Conversor de Arquivo VCF (vCard) para JSON
Transforme qualquer exportação de livro de contatos em formato .vcf em um array JSON limpo e estruturado de contatos. O conversor analisa arquivos vCard 3.0 (RFC 2426) e vCard 4.0 (RFC 6350) inteiramente no seu navegador, trata a quebra de linhas exigida pelo RFC, arquivos com múltiplos contatos, valores estruturados de Nome e Endereço, parâmetros multi-TYPE, e até entradas base64 codificadas PHOTO e LOGO. Use-o para migrar contatos para um CRM, alimentar um sistema de automação ou simplesmente ler o conteúdo real de um arquivo de contatos.
Como usar
- Cole o conteúdo do seu arquivo .vcf no campo de origem ou carregue o arquivo usando o seletor de arquivos.
- Escolha suas opções de saída – JSON formatado, array plano versus objeto embutido, divisão estruturada de Nome e Endereço, análise de datas ISO para BDAY/REV/ANNIVERSARY, agrupamento de EMAIL e TEL por tipo e se incluir dados base64 de PHOTO/LOGO.
- A área de saída JSON atualiza automaticamente enquanto você digita ou alterna opções.
- Clique em Copiar para colocar o JSON na área de transferência ou Baixar para salvá-lo como
contacts.json.
Características
- Suporte a vCard 3.0 e 4.0 – Aceita tanto a sintaxe moderna (TYPE=) quanto a sintaxe antiga (;HOME;VOICE) dos parâmetros do vCard 2.1.
- Quebra de linha conforme o RFC 6350 – Reconstrói corretamente linhas longas que foram divididas com CRLF seguido de um caractere de espaço ou tabulação antes da análise.
- Divisão estruturada de Nome – O campo N é dividido em campos de família, nome dado, adicional, prefixo e sufixo, com listas separadas por vírgulas preservadas como arrays.
- Divisão estruturada de Endereço – O campo ADR é dividido em poBox, endereço estendido, rua, localidade, região, código postal e país.
- Arquivos com múltiplos contatos – Um único arquivo .vcf contendo muitos blocos BEGIN:VCARD produz um objeto JSON por contato.
- Suporte a PHOTO / LOGO / KEY em base64 – Os dados base64 inline são reconstruídos como uma URI data quando a opção “Incluir dados base64 de PHOTO/LOGO” está ativada, ou resumidos com o contador de bytes quando não está ativada.
- Ordem PREF – Entradas multivárias de EMAIL, TEL, ADR e URL são ordenadas pelo parâmetro PREF para que a entrada preferida apareça primeiro.
- Agrupamento por tipo – Agrupa opcionalmente EMAIL, TEL, ADR e URL em buckets por tipo (trabalho, residência, celular, etc.) para acesso direto em estilo de dicionário.
- Análise de datas ISO 8601 – Os valores BDAY, ANNIVERSARY e REV são normalizados em strings ISO 8601.
- Parser de parâmetros com suporte a DQUOTE – As vírgulas e ponto-e-vírgula dentro de valores de parâmetros entre aspas são preservadas literalmente.
- 100% do lado do cliente – O arquivo .vcf nunca sai do seu navegador. Sem upload, sem processamento em servidor, sem preocupações de privacidade.
- Saída bruta opcional – Inclui o valor original da propriedade ao lado do valor analisado para fins de depuração ou rotação de dados.
Perguntas frequentes
-
O que é a quebra de linha em vCard?
O RFC 6350 permite que linhas longas de propriedades sejam divididas em múltiplas linhas físicas ao inserir CRLF seguido por um único caractere de espaço ou tabulação. Durante a análise, a quebra de linha e o espaço inicial são removidos para reconstruir a linha lógica original. É por isso que a análise simples linha por linha de arquivos vCard muitas vezes produz valores quebrados para notas longas ou fotos base64 codificadas.
-
Como vCard 3.0 e 4.0 diferem para valores de parâmetros?
O vCard 3.0 (RFC 2426) e a especificação antiga 2.1 frequentemente usam múltiplos parâmetros TYPE ou sintaxe sem tipo como TEL;HOME;VOICE:.... O vCard 4.0 (RFC 6350) prefere um único parâmetro TYPE com uma lista de valores separados por vírgulas e usa valores URI (tel:, mailto:, data:) em vez de codificação inline. Um parser robusto deve aceitar ambas as formas e normalizá-las.
-
O que é um valor estruturado em vCard?
Propriedades como N (Nome) e ADR (Endereço) carregam múltiplos subcampos unidos por ponto-e-vírgula. O N tem cinco componentes – família, nome dado, adicional, prefixo e sufixo – e o ADR tem sete – caixa postal, endereço estendido, rua, localidade, região, código postal e país. Cada componente pode ser uma lista separada por vírgulas. A divisão deve respeitar a sequência de escape de barra invertida para que vírgulas escapadas em um valor não sejam tratadas como separadores.
-
Por que a propriedade PHOTO carrega dados base64?
O vCard 3.0 codifica dados binários como fotos, logotipos e chaves por base64 e indica a codificação via parâmetro ENCODING=B. O vCard 4.0 usa URIs data com um prefixo de tipo de mídia. Ambas as formas podem gerar linhas muito longas, o que é a principal razão pela qual o RFC 6350 exige a quebra de linha para transporte.
Instale nossas extensões
Adicione ferramentas de IO ao seu navegador favorito para acesso instantâneo e pesquisa mais rápida
恵 O placar chegou!
Placar é uma forma divertida de acompanhar seus jogos, todos os dados são armazenados em seu navegador. Mais recursos serão lançados em breve!
Ferramentas essenciais
Ver tudo Novas chegadas
Ver tudoAtualizar: Nosso ferramenta mais recente foi adicionado em 11 de junho de 2026
