Cookies Netscape para JSON: como converter e importar cookies do X

Você tem um arquivo cookies.txt, mas a extensão ou a ferramenta de automação que quer usar só aceita uma lista de cookies em JSON. Converter cookies Netscape para JSON é um trabalho pequeno quando você sabe o que cada coluna do arquivo significa, e leva segundos se usar um conversor que mostra exatamente quais linhas não conseguiu ler.

Este guia explica o formato do arquivo de cookies Netscape, mostra como fica o lado JSON, percorre a ferramenta gratuita de conversão e depois ensina a importar o resultado em um editor de cookies e a conferir se a sessão do X realmente funciona. Você também vai conhecer os poucos erros de colagem que causam a maioria das falhas e o que fazer quando uma ferramenta pede Base64 em vez de JSON.

Cookies Netscape para JSON: as sete colunas separadas por tabulação

Um arquivo de cookies Netscape é texto simples com um cookie por linha. Cada linha tem sete campos separados por um único caractere de tabulação, sempre na mesma ordem. Curl, wget e a maioria das extensões de navegador que exportam cookies gravam esse formato.

• Domínio: onde o cookie vale, por exemplo .x.com. Um ponto no início significa que os subdomínios estão incluídos.
• Indicador de subdomínios: TRUE ou FALSE, informando se os subdomínios também podem receber o cookie.
• Caminho: geralmente só uma barra, ou seja, o site inteiro.
• Secure: TRUE se o cookie só é enviado por HTTPS.
• Expiração: um carimbo de data e hora Unix em segundos. Zero significa um cookie de sessão, que termina quando o navegador é fechado.
• Nome: o nome do cookie, como auth_token ou ct0.
• Valor: o valor do cookie em si, que é a parte secreta.

Dois casos especiais aparecem com frequência. Linhas que começam com o sinal de hash são comentários e são ignoradas, com uma exceção: uma linha que começa com o prefixo #HttpOnly_ é um cookie de verdade, cujo domínio vem logo depois do prefixo e que está marcado como HTTP-only. Alguns exportadores também deixam o último valor vazio, então uma linha com seis campos é possível e continua válida.

O formato de cookies JSON que as extensões esperam

As importações de cookies em JSON normalmente são uma lista de objetos, um objeto por cookie, com uma chave para cada campo. O conversor gratuito deste site gera as chaves domain, includeSubdomains, path, secure, expires, name, value e httpOnly. Ele espelha as sete colunas, mais um indicador para o prefixo HTTP-only.

Lembre-se de que as extensões não são totalmente uniformes. As APIs de extensões de navegador costumam chamar o campo de expiração de expirationDate em vez de expires, e algumas adicionam chaves como hostOnly ou sameSite. Antes de mover um lote grande, exporte um único cookie da extensão em que pretende importar e compare os nomes das chaves com a saída do conversor. Se os nomes forem diferentes, um simples localizar e substituir no nome da chave geralmente resolve.

Converta cookies.txt para JSON com a ferramenta gratuita

O caminho mais rápido é a ferramenta de cookies Netscape para JSON. Ela roda no seu navegador, então o texto que você cola não é enviado nem guardado no servidor. Mesmo assim, trate o conteúdo como uma senha, porque os valores dos cookies são credenciais de sessão ativas.

• Cole o cookies.txt inteiro, incluindo as linhas de comentário. Você não precisa limpar nada antes.
• Leia os três contadores: cookies válidos, linhas com erro e linhas ignoradas. As linhas ignoradas são comentários e linhas em branco, o que é normal.
• Se aparecerem linhas com erro, abra a lista de linhas ilegíveis. Cada item mostra o número da linha e o motivo.
• Copie a lista JSON quando a quantidade de válidos bater com o que você espera.

Se você não tem certeza do tipo de arquivo que recebeu, cole algumas linhas primeiro no identificador de formato. Um arquivo de entrega com linhas de conta separadas por dois-pontos é diferente de um arquivo de cookies separado por tabulação, e nosso guia sobre verificar a estrutura de um arquivo entregue antes de usar uma ferramenta de formato explica como distingui-los.

Importe o JSON em um editor de cookies e verifique a sessão

Com o JSON em mãos, importe-o em uma extensão editora de cookies, em um perfil de navegador que você use para essa finalidade.

• Abra o x.com nesse perfil primeiro, para que a extensão tenha uma página e um domínio aos quais associar os cookies.
• Abra a opção de importar da extensão e cole a lista JSON.
• Recarregue a página e veja se aparece a sua linha do tempo logada em vez da tela de login.

Para um login no X, os cookies que mais importam são o auth_token, que carrega a sessão, e o ct0, o token complementar que o site usa nas requisições. Confira se o domínio é .x.com (ou o antigo .twitter.com, se a sua exportação o usar), se o caminho é uma barra e se a expiração é uma data no futuro. Um carimbo de data vencido é o motivo mais comum de uma importação perfeita falhar. Se quiser ver o quadro completo do login por token, leia como entrar no Twitter com um auth token.

Erros comuns de conversão: tabulações, linhas #HttpOnly_ e comentários

A maioria das falhas vem de poucos erros, e a lista de erros do conversor aponta direto para eles.

• Tabulações viraram espaços: ao copiar de uma janela de chat, de um editor de texto formatado ou de algumas páginas da web, as tabulações podem ser trocadas por espaços. A ferramenta então vê um campo longo em vez de sete. Copie do arquivo original em um editor de texto simples.
• Quantidade de campos errada: toda linha precisa ter seis ou sete campos. Uma linha com espaços extras dentro do valor ou com uma coluna faltando é informada com o número da linha.
• Domínio ou nome vazio: uma linha com domínio ou nome do cookie em branco não serve, então a ferramenta a lista em vez de adivinhar.
• Expiração que não é número: o quinto campo precisa ser composto de dígitos. Uma data escrita como texto ou um caractere solto é rejeitado.
• Confusão com comentários: linhas que começam com hash são ignoradas, mas as linhas #HttpOnly_ são cookies de verdade. Se a sua contagem for menor que a esperada, confira se elas não foram apagadas em uma etapa anterior de limpeza.

Depois de corrigir a origem, cole de novo e compare a quantidade de válidos com o número de cookies que você esperava. Um conversor que informa cada linha ilegível é melhor do que um que as descarta em silêncio.

Converter para Base64 quando uma ferramenta pedir

Alguns painéis e formulários de importação querem a lista de cookies como uma única string Base64, e não como JSON legível. Cole o JSON na ferramenta de JSON para Base64 e escolha a saída compacta em uma linha, a menos que o destino peça indentação. Para inspecionar ou depurar uma string Base64 existente, o caminho inverso está explicado em decodificar dados de cookies em Base64 de volta para JSON.

Guarde o cookies.txt original como fonte de verdade, porque as versões em JSON e Base64 podem sempre ser geradas de novo a partir dele. Quando estiver pronto para adicionar contas ao seu fluxo de trabalho, veja a categoria de contas antigas e depois use as ferramentas gratuitas acima para preparar o formato que a sua ferramenta precisa.

Perguntas frequentes

Qual é a diferença entre o formato de cookies Netscape e o JSON?

Um arquivo Netscape é texto simples com sete colunas separadas por tabulação em cada linha. JSON é uma lista estruturada em que cada cookie é um objeto com chaves nomeadas. Os dois carregam a mesma informação, então converter de um para o outro muda o layout, não os dados do cookie.

Por que o cookies.txt que colei mostra zero cookies?

Em geral as tabulações foram trocadas por espaços durante a cópia, e por isso toda linha tem o número de campos errado. Copie direto do arquivo original em um editor de texto simples e cole de novo. Um arquivo que contém só comentários ou linhas em branco também resulta em zero cookies.

Uma linha que começa com #HttpOnly_ é comentário ou cookie de verdade?

É um cookie de verdade. O prefixo apenas o marca como HTTP-only, e o domínio começa logo depois. As linhas comuns que começam com hash são comentários e são ignoradas.

Quais campos do cookie mais importam para um login no X?

O nome e o valor de auth_token e ct0 são os mais importantes, junto com um domínio correto como .x.com, um caminho com uma barra e uma data de expiração que ainda não passou. Campos como o indicador de subdomínios raramente causam problema quando esses estão certos.

Posso converter o JSON de volta para Netscape ou Base64 depois?

O Base64 funciona nos dois sentidos com as ferramentas JSON para Base64 e Base64 para JSON. O site não oferece um conversor de JSON para Netscape, então guarde o cookies.txt original caso precise desse formato de novo.