Куки Netscape в JSON: как конвертировать и импортировать куки X

У вас есть файл cookies.txt, а расширение или программа для автоматизации принимает только массив куки в формате JSON. Конвертировать куки Netscape в JSON несложно, если понимать, что означает каждая колонка файла, а с конвертером, который прямо показывает нечитаемые строки, это занимает несколько секунд.

В этом руководстве разберём формат файла куки Netscape, покажем, как выглядит JSON, и пройдём по шагам бесплатный инструмент для конвертации. Затем импортируем результат в редактор куки и проверим, что сессия X действительно работает. Вы также узнаете о нескольких ошибках вставки, из-за которых случается большинство сбоев, и о том, что делать, если инструмент просит Base64 вместо JSON.

Куки Netscape в JSON: семь колонок через табуляцию

Файл куки Netscape — это обычный текст, где на каждой строке одна кука. В строке семь полей, разделённых одним символом табуляции, и порядок полей всегда одинаков. Такой формат записывают curl, wget и большинство расширений браузера для экспорта куки.

• Домен: где действует кука, например .x.com. Точка в начале означает, что поддомены тоже включены.
• Флаг поддоменов: TRUE или FALSE — могут ли поддомены тоже получать куки.
• Путь: обычно просто косая черта, то есть весь сайт.
• Secure: TRUE, если кука отправляется только по HTTPS.
• Срок действия: метка времени Unix в секундах. Ноль означает сессионную куку, которая исчезает при закрытии браузера.
• Имя: название куки, например auth_token или ct0.
• Значение: сама кука, то есть секретная часть.

Часто встречаются два особых случая. Строки, которые начинаются с решётки, — это комментарии, и их игнорируют; единственное исключение — строка с префиксом #HttpOnly_. Это настоящая кука, домен идёт сразу после префикса, а сама она помечена как HTTP-only. Некоторые экспортёры оставляют последнее значение пустым, поэтому строка из шести полей возможна и тоже считается корректной.

Формат куки в JSON, который ждут расширения

Импорт куки в JSON — это обычно массив объектов: по одному объекту на куку, по ключу на каждое поле. Бесплатный конвертер на этом сайте выдаёт ключи domain, includeSubdomains, path, secure, expires, name, value и httpOnly. Он повторяет семь колонок и добавляет флаг для префикса HTTP-only.

Учтите, что расширения устроены по-разному. API расширений браузера часто называет поле срока действия expirationDate, а не expires, а некоторые добавляют ключи вроде hostOnly или sameSite. Прежде чем переносить большую партию, экспортируйте одну куку из расширения, в которое собираетесь импортировать, и сравните названия ключей с результатом конвертера. Если названия различаются, обычно хватает быстрой замены названия ключа.

Как конвертировать cookies.txt в JSON бесплатным инструментом

Быстрее всего это сделать в конвертере куки Netscape в JSON. Он работает прямо в браузере, поэтому вставленный текст не отправляется на сервер и не сохраняется там. Но относитесь к содержимому как к паролю: значения куки — это действующие данные сессии.

• Вставьте весь cookies.txt целиком, вместе со строками-комментариями. Предварительно ничего чистить не нужно.
• Посмотрите на три счётчика: корректные куки, строки с ошибками и пропущенные строки. Пропущенные строки — это комментарии и пустые строки, это нормально.
• Если появились строки с ошибками, откройте список нечитаемых строк. Для каждой указаны номер строки и причина.
• Когда число корректных куки совпадает с ожидаемым, скопируйте список JSON.

Если вы не уверены, какой файл вам выдали, сначала вставьте несколько строк в определитель формата. Файл выдачи со строками аккаунтов через двоеточие — это совсем не то же самое, что файл куки с табуляцией; как их различить, объясняет наша статья о том, как проверить структуру выданного файла перед использованием инструмента форматов.

Импорт JSON в редактор куки и проверка сессии

Получив JSON, импортируйте его в расширение-редактор куки в профиле браузера, который вы используете именно для этой задачи.

• Сначала откройте x.com в этом профиле, чтобы у расширения была страница и домен, к которым можно привязать куки.
• Откройте в расширении пункт импорта и вставьте массив JSON.
• Перезагрузите страницу и проверьте, что вместо экрана входа появилась ваша домашняя лента.

Для входа в X важнее всего auth_token, который несёт сессию, и ct0 — парный токен, который сайт использует в запросах. Убедитесь, что домен — .x.com (или более старый .twitter.com, если ваш экспорт использует его), путь — косая черта, а срок действия — дата в будущем. Просроченная метка времени — самая частая причина, почему в остальном идеальный импорт не срабатывает. Если хотите увидеть всю картину входа по токену, прочитайте как войти в Twitter с помощью auth token.

Частые ошибки конвертации: табуляции, строки #HttpOnly_ и комментарии

Большинство сбоев вызвано несколькими ошибками, и список ошибок конвертера указывает прямо на них.

• Табуляции превратились в пробелы: при копировании из окна чата, текстового редактора или некоторых веб-страниц табуляции могут заменяться пробелами. Тогда инструмент видит одно длинное поле вместо семи. Лучше копировать из исходного файла в простом текстовом редакторе.
• Неверное число полей: в каждой строке должно быть шесть или семь полей. Строка с лишними пробелами внутри значения или без одной колонки попадает в отчёт с номером строки.
• Пустой домен или имя: строку с пустым доменом или именем куки использовать нельзя, поэтому инструмент выводит её в список, а не гадает.
• Срок действия не числом: пятое поле должно состоять из цифр. Дата, записанная текстом, или лишний символ отклоняются.
• Путаница с комментариями: строки, начинающиеся с решётки, пропускаются, но строки #HttpOnly_ — настоящие куки. Если число меньше ожидаемого, проверьте, не удалил ли их предыдущий этап очистки.

Исправив источник, вставьте текст заново и сравните число корректных куки с ожидаемым количеством. Конвертер, сообщающий о каждой нечитаемой строке, лучше того, который молча их отбрасывает.

Конвертация в Base64, если инструмент этого требует

Некоторые панели и формы импорта просят массив куки в виде одной строки Base64, а не читаемого JSON. Вставьте JSON в инструмент JSON в Base64 и выберите компактный вывод в одну строку, если только место назначения не требует отступов. Чтобы проверить или отладить готовую строку Base64, обратное направление разобрано в статье о том, как декодировать данные куки из Base64 обратно в JSON.

Храните исходный cookies.txt как основной источник: версии JSON и Base64 из него всегда можно получить заново. Когда будете готовы добавить аккаунты в свой процесс, загляните в категорию старых аккаунтов, а затем подготовьте нужный вашему инструменту формат с помощью бесплатных инструментов выше.

Часто задаваемые вопросы

Чем формат куки Netscape отличается от JSON?

Файл Netscape — это обычный текст с семью колонками через табуляцию в каждой строке. JSON — это структурированный массив, где каждая кука является объектом с именованными ключами. В них одни и те же данные, поэтому конвертация меняет только вид, а не сами данные куки.

Почему вставленный cookies.txt показывает ноль куки?

Обычно при копировании табуляции заменились пробелами, и в каждой строке получилось неверное число полей. Скопируйте напрямую из исходного файла в простом текстовом редакторе и вставьте ещё раз. Файл, где только комментарии или пустые строки, тоже даёт ноль куки.

Строка с #HttpOnly_ в начале — это комментарий или настоящая кука?

Это настоящая кука. Префикс лишь помечает её как HTTP-only, а домен начинается сразу после него. Обычные строки, начинающиеся с решётки, — комментарии, их пропускают.

Какие поля куки важнее всего для входа в X?

Важнее всего имя и значение auth_token и ct0 вместе с правильным доменом вроде .x.com, путём в виде косой черты и ещё не прошедшим сроком действия. Когда это в порядке, остальные поля, например флаг поддоменов, редко создают проблемы.

Можно ли потом конвертировать JSON обратно в Netscape или Base64?

Base64 работает в обе стороны с инструментами JSON в Base64 и Base64 в JSON. Конвертера из JSON в Netscape на сайте нет, поэтому сохраните исходный cookies.txt на случай, если этот формат понадобится снова.