Cookies Netscape a JSON: cómo convertirlas e importar cookies de X

Tienes un archivo cookies.txt y la extensión o herramienta de automatización que quieres usar solo acepta un arreglo de cookies en JSON. Convertir cookies Netscape a JSON es un trabajo pequeño cuando sabes qué significa cada columna del archivo, y toma segundos si usas un conversor que te dice exactamente qué líneas no pudo leer.

Esta guía explica el formato del archivo de cookies Netscape, muestra cómo se ve el lado JSON, recorre la herramienta gratuita de conversión y después cubre cómo importar el resultado en un editor de cookies y comprobar que la sesión de X funciona de verdad. También conocerás los pocos errores de pegado que causan la mayoría de los fallos y qué hacer cuando una herramienta te pide Base64 en lugar de JSON.

Cookies Netscape a JSON: las siete columnas separadas por tabuladores

Un archivo de cookies Netscape es texto plano con una cookie por línea. Cada línea contiene siete campos separados por un único carácter de tabulación, siempre en el mismo orden. Curl, wget y la mayoría de las extensiones del navegador que exportan cookies escriben este formato.

• Dominio: dónde se aplica la cookie, por ejemplo .x.com. Un punto al inicio significa que incluye los subdominios.
• Indicador de subdominios: TRUE o FALSE, indica si los subdominios también pueden recibir la cookie.
• Ruta: normalmente solo una barra, es decir, todo el sitio.
• Secure: TRUE si la cookie solo se envía por HTTPS.
• Expiración: una marca de tiempo Unix en segundos. Un cero indica una cookie de sesión que termina al cerrar el navegador.
• Nombre: el nombre de la cookie, como auth_token o ct0.
• Valor: el valor de la cookie en sí, que es la parte secreta.

Aparecen a menudo dos casos especiales. Las líneas que empiezan con una almohadilla son comentarios y se ignoran, con una excepción: una línea que comienza con el prefijo #HttpOnly_ es una cookie real cuyo dominio va justo después del prefijo y que está marcada como HTTP-only. Algunos exportadores también dejan vacío el último valor, así que una fila de seis campos es posible y sigue siendo válida.

El formato de cookies JSON que esperan las extensiones

Las importaciones de cookies en JSON suelen ser un arreglo de objetos, un objeto por cookie, con una clave para cada campo. El conversor gratuito de este sitio genera las claves domain, includeSubdomains, path, secure, expires, name, value y httpOnly. Refleja las siete columnas, más un indicador para el prefijo HTTP-only.

Ten en cuenta que las extensiones no son del todo uniformes. Las API de extensiones de navegador suelen llamar al campo de expiración expirationDate en lugar de expires, y algunas añaden claves como hostOnly o sameSite. Antes de mover un lote grande, exporta una sola cookie desde la extensión en la que piensas importar y compara sus nombres de clave con la salida del conversor. Si los nombres difieren, normalmente basta con buscar y reemplazar el nombre de la clave.

Convertir cookies.txt a JSON con la herramienta gratuita

La vía más rápida es la herramienta de cookies Netscape a JSON. Funciona en tu navegador, así que el texto que pegas no se envía ni se guarda en el servidor. Aun así, trata el contenido como una contraseña, porque los valores de las cookies son credenciales de sesión activas.

• Pega todo el cookies.txt, incluidas las líneas de comentario. No necesitas limpiar nada antes.
• Lee los tres contadores: cookies válidas, líneas con error y líneas omitidas. Las líneas omitidas son comentarios y filas en blanco, lo cual es normal.
• Si aparecen líneas con error, abre la lista de líneas ilegibles. Cada entrada muestra el número de línea y el motivo.
• Copia la lista JSON cuando la cantidad de válidas coincida con lo que esperas.

Si no estás seguro de qué tipo de archivo te entregaron, pega primero unas líneas en el identificador de formato. Un archivo de entrega con líneas de cuenta separadas por dos puntos es muy distinto de un archivo de cookies separado por tabuladores, y nuestra guía sobre revisar la estructura de un archivo entregado antes de usar una herramienta de formato explica cómo distinguirlos.

Importar el JSON en un editor de cookies y verificar la sesión

Cuando tengas el JSON, impórtalo en una extensión editora de cookies dentro de un perfil de navegador que uses para este fin.

• Abre primero x.com en ese perfil, para que la extensión tenga una página y un dominio a los que asociar las cookies.
• Abre la opción de importar de la extensión y pega el arreglo JSON.
• Recarga la página y comprueba que aparezca tu línea de tiempo con la sesión iniciada en lugar de la pantalla de acceso.

Para un inicio de sesión en X, las cookies que más importan son auth_token, que lleva la sesión, y ct0, el token complementario que el sitio usa en las solicitudes. Verifica que su dominio sea .x.com (o el antiguo .twitter.com si tu exportación lo usa), que la ruta sea una barra y que la expiración sea una fecha futura. Una marca de tiempo vencida es el motivo más habitual de que una importación por lo demás perfecta falle. Si quieres ver el panorama completo del acceso con token, lee cómo iniciar sesión en Twitter con un auth token.

Errores comunes al convertir: tabuladores, líneas #HttpOnly_ y comentarios

La mayoría de los fallos vienen de unos pocos errores, y la lista de errores del conversor apunta directamente a ellos.

• Tabuladores convertidos en espacios: al copiar desde una ventana de chat, un procesador de texto o algunas páginas web, los tabuladores pueden sustituirse por espacios. La herramienta entonces ve un campo largo en lugar de siete. Copia en cambio desde el archivo original en un editor de texto plano.
• Cantidad de campos incorrecta: cada fila debe tener seis o siete campos. Una fila con espacios de más dentro del valor o con una columna faltante se informa con su número de línea.
• Dominio o nombre vacío: una fila con el dominio o el nombre de la cookie en blanco no sirve, así que la herramienta la lista en lugar de adivinar.
• Expiración que no es un número: el quinto campo debe ser solo dígitos. Una fecha escrita como texto o un carácter suelto se rechaza.
• Confusión con los comentarios: las líneas que empiezan con almohadilla se omiten, pero las líneas #HttpOnly_ son cookies reales. Si tu cantidad es menor de la esperada, comprueba que no se hayan borrado en un paso de limpieza anterior.

Después de corregir el origen, pega de nuevo y compara la cantidad de válidas con el número de cookies que esperabas. Un conversor que informa de cada línea ilegible es mejor que uno que las descarta en silencio.

Seguir convirtiendo a Base64 cuando una herramienta lo pide

Algunos paneles y formularios de importación piden el arreglo de cookies como una sola cadena Base64 en lugar de JSON legible. Pega el JSON en la herramienta de JSON a Base64 y elige la salida compacta en una sola línea, a menos que el destino pida sangría. Para inspeccionar o depurar una cadena Base64 existente, la dirección contraria se explica en decodificar datos de cookies en Base64 de vuelta a JSON.

Conserva tu cookies.txt original como fuente de verdad, porque las versiones en JSON y Base64 siempre se pueden regenerar a partir de él. Cuando estés listo para añadir cuentas a tu flujo de trabajo, explora la categoría de cuentas antiguas y usa después las herramientas gratuitas de arriba para preparar el formato que necesite tu herramienta.

Preguntas frecuentes

¿Cuál es la diferencia entre el formato de cookies Netscape y el JSON?

Un archivo Netscape es texto plano con siete columnas separadas por tabuladores en cada línea. JSON es un arreglo estructurado en el que cada cookie es un objeto con claves con nombre. Contienen la misma información, así que convertir de uno a otro cambia la presentación, no los datos de la cookie.

¿Por qué mi cookies.txt pegado muestra cero cookies?

Normalmente los tabuladores se sustituyeron por espacios al copiar, y por eso cada línea tiene un número de campos incorrecto. Copia directamente desde el archivo original en un editor de texto plano y pega otra vez. Un archivo que solo contiene comentarios o líneas en blanco también produce cero cookies.

¿Una línea que empieza con #HttpOnly_ es un comentario o una cookie real?

Es una cookie real. El prefijo solo la marca como HTTP-only, y el dominio empieza justo después. Las líneas normales que empiezan con una almohadilla son comentarios y se omiten.

¿Qué campos de cookie importan más para un inicio de sesión en X?

El nombre y el valor de auth_token y ct0 son los que más importan, junto con un dominio correcto como .x.com, una ruta con una barra y una fecha de expiración que no haya pasado. Campos como el indicador de subdominios rara vez dan problemas cuando lo anterior está bien.

¿Puedo convertir el JSON de vuelta a Netscape o a Base64 más tarde?

Base64 funciona en ambos sentidos con las herramientas JSON a Base64 y Base64 a JSON. El sitio no ofrece un conversor de JSON a Netscape, así que conserva tu cookies.txt original por si necesitas ese formato otra vez.