🕷️ The BEST Web Scraping framework that handles everything from a single request to a full-scale crawl! Don't be shy, join here: https://discord.gg/EMgGbDceNQ and follow here for daily tips and tricks: https://x.com/Scrapling_dev
Python aiai-scrapingautomationcrawlercrawlingcrawling-pythondatadata-extractionmcpmcp-serverplaywrightpythonscrapingselectorsstealthweb-scraperweb-scrapingweb-scraping-pythonwebscrapingxpath
{% set translations = {
"<p>This class is returned by all engines as a way to unify the response type between different libraries.</p>": "<p>Все движки возвращают этот класс, чтобы использовать единый тип ответа для разных библиотек.</p>",
"<p>HTTP status code.</p>": "<p>Код состояния HTTP.</p>",
"<p>HTTP status message.</p>": "<p>Сообщение состояния HTTP.</p>",
"<p>Response cookies.</p>": "<p>Cookies ответа.</p>",
"<p>Response headers.</p>": "<p>Заголовки ответа.</p>",
"<p>Request headers sent with the request.</p>": "<p>Заголовки, отправленные с запросом.</p>",
"<p>List of redirect responses, if any.</p>": "<p>Список ответов перенаправления, если они были.</p>",
"<p>Metadata dictionary (e.g., proxy used).</p>": "<p>Словарь метаданных, например использованный прокси.</p>",
"<p>Associated spider Request object (set by crawler, in the spiders framework).</p>": "<p>Связанный объект Request паука. Задаётся краулером в системе пауков.</p>",
"<p>The main class that works as a wrapper for the HTML input data. Using this class, you can search for elements\nwith expressions in CSS, XPath, or with simply text. Check the docs for more info.</p>": "<p>Основной класс для работы с входными HTML-данными. Позволяет искать элементы с помощью CSS, XPath или обычного текста. Подробнее в документации.</p>",
"<p>Here we try to extend module <code>lxml.html.HtmlElement</code> while maintaining a simpler interface, We are not\ninheriting from the <code>lxml.html.HtmlElement</code> because it's not pickleable, which makes a lot of reference jobs\nnot possible. You can test it here and see code explodes with <code>AssertionError: invalid Element proxy at...</code>.\nIt's an old issue with lxml, see <code>this entry <https://bugs.launchpad.net/lxml/+bug/736708></code></p>": "<p>Класс расширяет возможности <code>lxml.html.HtmlElement</code>, сохраняя простой интерфейс. Он не наследует <code>lxml.html.HtmlElement</code>, поскольку тот нельзя сохранить через pickle, что мешает многим операциям со ссылками. При попытке возникает ошибка <code>AssertionError: invalid Element proxy at...</code>. Это давняя проблема lxml, см. <code>this entry <https://bugs.launchpad.net/lxml/+bug/736708></code>.</p>",
"<p>HTML content as either string or bytes.</p>": "<p>Содержимое HTML в виде строки или байтов.</p>",
"<p>It allows storing a URL with the HTML data for retrieving later.</p>": "<p>Позволяет сохранить URL вместе с HTML-данными для последующего получения.</p>",
"<p>The encoding type that will be used in HTML parsing, default is <code>UTF-8</code></p>": "<p>Кодировка для разбора HTML. По умолчанию <code>UTF-8</code>.</p>",
"<p>Enabled by default, should always be enabled when parsing large HTML documents. This controls\nthe libxml2 feature that forbids parsing certain large documents to protect from possible memory exhaustion.</p>": "<p>Включено по умолчанию. При разборе больших HTML-документов всегда оставляйте включённым. Управляет функцией libxml2, которая запрещает разбор некоторых больших документов для защиты от нехватки памяти.</p>",
"<p>Used internally to pass etree objects instead of text/body arguments, it takes the highest priority.\nDon't use it unless you know what you are doing!</p>": "<p>Внутренний аргумент для передачи объектов etree вместо текста или тела. Имеет наивысший приоритет. Используйте его только если понимаете, как он работает.</p>",
"<p>While parsing the HTML body, drop comments or not. Disabled by default for obvious reasons</p>": "<p>Нужно ли сохранять комментарии при разборе HTML. По умолчанию выключено.</p>",
"<p>Globally turn off the adaptive feature in all functions, this argument takes higher\npriority over all adaptive related arguments/functions in the class.</p>": "<p>Глобально отключает адаптивные функции во всех методах. Имеет приоритет над всеми связанными с ними аргументами и методами класса.</p>",
"<p>The storage class to be passed for adaptive functionalities, see <code>Docs</code> for more info.</p>": "<p>Класс хранилища для адаптивных функций. Подробнее в <code>Docs</code>.</p>",
"<p>A dictionary of <code>argument->value</code> pairs to be passed for the storage class.\nIf empty, default values will be used.</p>": "<p>Словарь пар <code>argument->value</code> для класса хранилища. Если пуст, используются значения по умолчанию.</p>",
"<p>Return the raw body of the current <code>Selector</code> without any processing. Useful for binary and non-HTML requests.</p>": "<p>Возвращает исходное тело текущего <code>Selector</code> без обработки. Полезно для двоичных данных и запросов не к HTML.</p>",
"<p>Return the raw body of the response as bytes.</p>": "<p>Возвращает исходное тело ответа в виде байтов.</p>",
"<p>Generate a CSS selector for the current element</p>": "<p>Создаёт CSS-селектор для текущего элемента.</p>",
"<p>A string of the generated selector.</p>": "<p>Строка с созданным селектором.</p>",
"<p>Generate a complete CSS selector for the current element</p>": "<p>Создаёт полный CSS-селектор для текущего элемента.</p>",
"<p>Generate an XPath selector for the current element</p>": "<p>Создаёт XPath-селектор для текущего элемента.</p>",
"<p>Generate a complete XPath selector for the current element</p>": "<p>Создаёт полный XPath-селектор для текущего элемента.</p>",
"<p>Get the tag name of the element</p>": "<p>Получает имя тега элемента.</p>",
"<p>Get text content of the element</p>": "<p>Получает текстовое содержимое элемента.</p>",
"<p>Get attributes of the element</p>": "<p>Получает атрибуты элемента.</p>",
"<p>Return the inner HTML code of the element</p>": "<p>Возвращает внутренний HTML-код элемента.</p>",
"<p>Return the direct parent of the element or <code>None</code> otherwise</p>": "<p>Возвращает непосредственный родительский элемент или <code>None</code>, если его нет.</p>",
"<p>Return all elements under the current element in the DOM tree</p>": "<p>Возвращает все элементы под текущим элементом в дереве DOM.</p>",
"<p>Return the children elements of the current element or empty list otherwise</p>": "<p>Возвращает дочерние элементы текущего элемента или пустой список, если их нет.</p>",
"<p>Return other children of the current element's parent or empty list otherwise</p>": "<p>Возвращает другие дочерние элементы того же родителя или пустой список, если их нет.</p>",
"<p>Returns a list of type <code>Selectors</code> that contains the path leading to the current element from the root.</p>": "<p>Возвращает список типа <code>Selectors</code> с путём от корня к текущему элементу.</p>",
"<p>Returns the next element of the current element in the children of the parent or <code>None</code> otherwise.</p>": "<p>Возвращает следующий элемент среди дочерних элементов того же родителя или <code>None</code>, если его нет.</p>",
"<p>Returns the previous element of the current element in the children of the parent or <code>None</code> otherwise.</p>": "<p>Возвращает предыдущий элемент среди дочерних элементов того же родителя или <code>None</code>, если его нет.</p>",
"<p>Convert the response content to clean Markdown.</p>": "<p>Преобразует содержимое ответа в очищенный Markdown.</p>",
"<p>Scripts, styles, and hidden/prompt-injection content are always removed before conversion, which is\nthe same cleaning the MCP server does. Requires the \"markdownify\" package (<code>pip install \"scrapling[rag]\"</code>).</p>": "<p>Перед преобразованием всегда удаляет скрипты, стили, скрытое содержимое и содержимое с внедрёнными инструкциями для ИИ. Используется та же очистка, что и на MCP-сервере. Требуется пакет markdownify (<code>pip install \"scrapling[rag]\"</code>).</p>",
"<p>CSS selector to convert only the matching elements. All matches are concatenated.</p>": "<p>CSS-селектор для преобразования только подходящих элементов. Все совпадения объединяются.</p>",
"<p>Convert only the content inside the <code><body></code> tag.</p>": "<p>Преобразует только содержимое внутри тега <code><body></code>.</p>",
"<p>Create a Request to follow a URL.</p>": "<p>Создаёт Request для перехода по URL.</p>",
"<p>This is a helper method for spiders to easily follow links found in pages.</p>": "<p>Вспомогательный метод, с которым паукам проще переходить по найденным на странице ссылкам.</p>",
"<p><strong>IMPORTANT</strong>: The below arguments if left empty, the corresponding value from the previous request will be used. The only exception is <code>dont_filter</code>.</p>": "<p><strong>Важно</strong>: если следующие аргументы не заданы, используются соответствующие значения предыдущего запроса. Единственное исключение: <code>dont_filter</code>.</p>",
"<p>The session kwargs of the previous request are inherited as well, except <code>method</code>, <code>params</code>, <code>data</code>, <code>json</code>, <code>files</code>, and <code>multipart</code>, so a followed link is a plain GET unless you pass them again.</p>": "<p>Аргументы сессии предыдущего запроса тоже наследуются, кроме <code>method</code>, <code>params</code>, <code>data</code>, <code>json</code>, <code>files</code> и <code>multipart</code>. Поэтому переход по ссылке отправляет обычный GET, если не передать эти аргументы снова.</p>",
"<p>The URL to follow (can be relative, will be joined with current URL)</p>": "<p>URL для перехода. Может быть относительным: в этом случае он объединяется с текущим URL.</p>",
"<p>The session id to use</p>": "<p>ID используемой сессии.</p>",
"<p>Spider callback method to use</p>": "<p>Метод-обработчик паука.</p>",
"<p>The priority number to use, the higher the number, the higher priority to be processed first.</p>": "<p>Числовой приоритет. Чем выше значение, тем раньше обрабатывается запрос.</p>",
"<p>If this request has been done before, disable the filter to allow it again.</p>": "<p>Отключает фильтр, чтобы разрешить запрос, который уже выполнялся.</p>",
"<p>Additional meta data to included in the request</p>": "<p>Дополнительные метаданные запроса.</p>",
"<p>Enabled by default, set the current response url as referer for the new request url.</p>": "<p>Включено по умолчанию. Указывает URL текущего ответа в заголовке Referer нового запроса.</p>",
"<p>Additional Request arguments</p>": "<p>Дополнительные аргументы Request.</p>",
"<p>Request object ready to be yielded</p>": "<p>Объект Request, готовый к выдаче через yield.</p>",
"<p>Get all child strings of this element, concatenated using the given separator.</p>": "<p>Получает все дочерние строки элемента, объединённые заданным разделителем.</p>",
"<p>Strings will be concatenated using this separator.</p>": "<p>Разделитель для объединения строк.</p>",
"<p>If True, strings will be stripped before being concatenated.</p>": "<p>При True удаляет пробельные символы по краям строк перед объединением.</p>",
"<p>A tuple of all tag names you want to ignore</p>": "<p>Кортеж имён всех тегов, которые нужно игнорировать.</p>",
"<p>If enabled, elements with text-content that is empty or only whitespaces will be ignored</p>": "<p>Если включено, игнорирует элементы с пустым текстом или текстом только из пробельных символов.</p>",
"<p>A TextHandler</p>": "<p>Объект TextHandler.</p>",
"<p>Join this Selector's url with a relative url to form an absolute full URL.</p>": "<p>Объединяет URL этого Selector с относительным URL, чтобы получить полный абсолютный URL.</p>",
"<p>Return a prettified version of the element's inner html-code</p>": "<p>Возвращает внутренний HTML-код элемента в читаемом формате.</p>",
"<p>Check if the element has a specific class</p>": "<p>Проверяет, есть ли у элемента указанный класс.</p>",
"<p>The class name to check for</p>": "<p>Имя класса для проверки.</p>",
"<p>True if element has class with that name otherwise False</p>": "<p>True, если у элемента есть класс с таким именем, иначе False.</p>",
"<p>Return a generator that loops over all ancestors of the element, starting with the element's parent.</p>": "<p>Возвращает генератор, который перебирает всех предков элемента, начиная с родителя.</p>",
"<p>Loop over all ancestors of the element till one match the passed function</p>": "<p>Перебирает предков элемента, пока один из них не подойдёт под условие переданной функции.</p>",
"<p>A function that takes each ancestor as an argument and returns True/False</p>": "<p>Функция, которая получает каждого предка как аргумент и возвращает True/False.</p>",
"<p>The first ancestor that match the function or <code>None</code> otherwise.</p>": "<p>Первый предок, подходящий под условие функции, или <code>None</code>, если его нет.</p>",
"<p>Serialize this element to a string.\nFor text nodes, returns the text value. For HTML elements, returns the outer HTML.</p>": "<p>Преобразует элемент в строку. Для текстовых узлов возвращает текстовое значение, для HTML-элементов возвращает внешний HTML.</p>",
"<p>Return a single-element list containing this element's serialized string.</p>": "<p>Возвращает список из одной строки с сериализованным элементом.</p>",
"<p>This function will search again for the element in the page tree, used automatically on page structure change</p>": "<p>Повторно ищет элемент в дереве страницы. Используется автоматически при изменении структуры страницы.</p>",
"<p>The element we want to relocate in the tree</p>": "<p>Элемент, который нужно снова найти в дереве.</p>",
"<p>The minimum percentage to accept and not going lower than that. Be aware that the percentage\ncalculation depends solely on the page structure, so don't play with this number unless you must know\nwhat you are doing!</p>": "<p>Минимальный допустимый процент совпадения. Расчёт зависит только от структуры страницы. Меняйте значение, только если понимаете его влияние.</p>",
"<p>If True, the return result will be converted to <code>Selectors</code> object</p>": "<p>При True преобразует результат в объект <code>Selectors</code>.</p>",
"<p>List of pure HTML elements that got the highest matching score or 'Selectors' object</p>": "<p>Список исходных HTML-элементов с наибольшим совпадением или объект 'Selectors'.</p>",
"<p>Search the current tree with CSS3 selectors</p>": "<p>Ищет в текущем дереве с помощью CSS3-селекторов.</p>",
"<p><strong>Important:\nIt's recommended to use the identifier argument if you plan to use a different selector later\nand want to relocate the same element(s)</strong></p>": "<p><strong>Важно: рекомендуется задать аргумент identifier, если позже вы собираетесь использовать другой селектор для поиска тех же элементов.</strong></p>",
"<p>The CSS3 selector to be used.</p>": "<p>CSS3-селектор для поиска.</p>",
"<p>Enabled will make the function try to relocate the element if it was 'saved' before</p>": "<p>Если включено, пытается снова найти элемент, который был сохранён ранее.</p>",
"<p>A string that will be used to save/retrieve element's data in adaptive,\notherwise the selector will be used.</p>": "<p>Строка для сохранения и получения данных элемента в адаптивном режиме. Если не задана, используется селектор.</p>",
"<p>Automatically save new elements for <code>adaptive</code> later</p>": "<p>Автоматически сохраняет новые элементы для дальнейшего использования с <code>adaptive</code>.</p>",
"<p>The minimum percentage to accept while <code>adaptive</code> is working and not going lower than that.\nBe aware that the percentage calculation depends solely on the page structure, so don't play with this\nnumber unless you must know what you are doing!</p>": "<p>Минимальный допустимый процент совпадения при работе <code>adaptive</code>. Расчёт зависит только от структуры страницы. Меняйте значение, только если понимаете его влияние.</p>",
"<p><code>Selectors</code> class.</p>": "<p>Класс <code>Selectors</code>.</p>",
"<p>Search the current tree with XPath selectors</p>": "<p>Ищет в текущем дереве с помощью XPath-селекторов.</p>",
"<p>Note: <strong>Additional keyword arguments will be passed as XPath variables in the XPath expression!</strong></p>": "<p>Примечание: <strong>дополнительные именованные аргументы передаются как переменные в XPath-выражение.</strong></p>",
"<p>The XPath selector to be used.</p>": "<p>XPath-селектор для поиска.</p>",
"<p>Find elements by filters of your creations for ease.</p>": "<p>Ищет элементы с помощью ваших фильтров.</p>",
"<p>Tag name(s), iterable of tag names, regex patterns, function, or a dictionary of elements' attributes. Leave empty for selecting all.</p>": "<p>Имена тегов, перебираемый объект с именами тегов, регулярные выражения, функция или словарь атрибутов элементов. Пустое значение выбирает все элементы.</p>",
"<p>The attributes you want to filter elements based on it.</p>": "<p>Атрибуты для фильтрации элементов.</p>",
"<p>The <code>Selectors</code> object of the elements or empty list</p>": "<p>Объект <code>Selectors</code> с элементами или пустой список.</p>",
"<p>Find elements by filters of your creations for ease, then return the first result. Otherwise return <code>None</code>.</p>": "<p>Ищет элементы с помощью ваших фильтров и возвращает первый результат. Если совпадений нет, возвращает <code>None</code>.</p>",
"<p>The <code>Selector</code> object of the element or <code>None</code> if the result didn't match</p>": "<p>Объект <code>Selector</code> с элементом или <code>None</code>, если совпадений нет.</p>",
"<p>Saves the element's unique properties to the storage for retrieval and relocation later</p>": "<p>Сохраняет уникальные свойства элемента в хранилище, чтобы позже получить их и найти элемент снова.</p>",
"<p>The element itself that we want to save to storage, it can be a <code>Selector</code> or pure <code>HtmlElement</code></p>": "<p>Элемент для сохранения. Может быть объектом <code>Selector</code> или исходным <code>HtmlElement</code>.</p>",
"<p>This is the identifier that will be used to retrieve the element later from the storage. See\nthe docs for more info.</p>": "<p>Идентификатор для последующего получения элемента из хранилища. Подробнее в документации.</p>",
"<p>Using the identifier, we search the storage and return the unique properties of the element</p>": "<p>Ищет в хранилище по идентификатору и возвращает уникальные свойства элемента.</p>",
"<p>This is the identifier that will be used to retrieve the element from the storage. See\nthe docs for more info.</p>": "<p>Идентификатор для получения элемента из хранилища. Подробнее в документации.</p>",
"<p>A dictionary of the unique properties</p>": "<p>Словарь уникальных свойств.</p>",
"<p>Return JSON response if the response is jsonable otherwise throws error</p>": "<p>Возвращает ответ в формате JSON, если его можно разобрать как JSON, иначе вызывает ошибку.</p>",
"<p>Apply the given regex to the current text and return a list of strings with the matches.</p>": "<p>Применяет регулярное выражение к текущему тексту и возвращает список строк с совпадениями.</p>",
"<p>Can be either a compiled regular expression or a string.</p>": "<p>Скомпилированное регулярное выражение или строка.</p>",
"<p>If enabled character entity references are replaced by their corresponding character</p>": "<p>Если включено, заменяет HTML-сущности соответствующими символами.</p>",
"<p>if enabled, this will ignore all whitespaces and consecutive spaces while matching</p>": "<p>Если включено, игнорирует пробельные символы и последовательности пробелов при сопоставлении.</p>",
"<p>if disabled, the function will set the regex to ignore the letters case while compiling it</p>": "<p>Если выключено, компилирует регулярное выражение без учёта регистра.</p>",
"<p>Apply the given regex to text and return the first match if found, otherwise return the default value.</p>": "<p>Применяет регулярное выражение к тексту и возвращает первое совпадение. Если совпадений нет, возвращает значение по умолчанию.</p>",
"<p>The default value to be returned if there is no match</p>": "<p>Значение по умолчанию, которое возвращается при отсутствии совпадений.</p>",
"<p>\n <span class=\"doc-param-default\">\n <b>DEFAULT:</b>\n <code>None</code>\n </span>\n </p>": "<p>\n <span class=\"doc-param-default\">\n <b>ПО УМОЛЧАНИЮ:</b>\n <code>None</code>\n </span>\n </p>",
"<p>if enabled character entity references are replaced by their corresponding character</p>": "<p>Если включено, заменяет HTML-сущности соответствующими символами.</p>",
"<p>Find elements that are in the same tree depth in the page with the same tag name and same parent tag etc...\nthen return the ones that match the current element attributes with a percentage higher than the input threshold.</p>": "<p>Ищет элементы на той же глубине дерева с тем же именем тега, тегом родителя и другими признаками. Возвращает те, у которых процент совпадения атрибутов с текущим элементом выше заданного порога.</p>",
"<p>This function is inspired by AutoScraper and made for cases where you, for example, found a product div inside\na products-list container and want to find other products using that element as a starting point EXCEPT\nthis function works in any case without depending on the element type.</p>": "<p>Функция создана по образцу AutoScraper. Например, если вы нашли div товара внутри списка товаров, его можно взять за основу для поиска остальных товаров. При этом функция не зависит от типа элемента и подходит для других задач.</p>",
"<p>The percentage to use while comparing element attributes.\nNote: Elements found before attributes matching/comparison will be sharing the same depth, same tag name,\nsame parent tag name, and same grand parent tag name. So they are 99% likely to be correct unless you are\nextremely unlucky, then attributes matching comes into play, so don't play with this number unless\nyou are getting the results you don't want.\nAlso, if the current element doesn't have attributes and the similar element as well, then it's a 100% match.</p>": "<p>Процент для сравнения атрибутов элементов. До сравнения уже выбраны элементы с одинаковой глубиной, именем тега, тегом родителя и тегом родителя этого родителя. Поэтому с вероятностью 99% это нужные элементы, за исключением крайне неудачных случаев. Затем сравниваются атрибуты. Меняйте число, только если получаете нежелательные результаты. Если у текущего и похожего элемента нет атрибутов, совпадение считается полным, то есть 100%.</p>",
"<p>Attribute names passed will be ignored while matching the attributes in the last step.\nThe default value is to ignore <code>href</code> and <code>src</code> as URLs can change a lot between elements, so it's unreliable</p>": "<p>Имена атрибутов, которые нужно игнорировать на последнем шаге сравнения. По умолчанию игнорируются <code>href</code> и <code>src</code>: URL сильно различаются между элементами и ненадёжны для сравнения.</p>",
"<p>If True, element text content will be taken into calculation while matching.\nNot recommended to use in normal cases, but it depends.</p>": "<p>При True текстовое содержимое элемента тоже учитывается при сопоставлении. Обычно это не рекомендуется, но зависит от задачи.</p>",
"<p>A <code>Selectors</code> container of <code>Selector</code> objects or empty list</p>": "<p>Контейнер <code>Selectors</code> с объектами <code>Selector</code> или пустой список.</p>",
"<p>Find elements that its text content fully/partially matches input.</p>": "<p>Ищет элементы, текст которых полностью или частично совпадает с заданным.</p>",
"<p>Text query to match</p>": "<p>Текст для поиска совпадений.</p>",
"<p>Returns the first element that matches conditions, enabled by default</p>": "<p>Возвращает первый элемент, который подходит под условия. Включено по умолчанию.</p>",
"<p>If enabled, the function returns elements that contain the input text</p>": "<p>Если включено, возвращает элементы, содержащие заданный текст.</p>",
"<p>if enabled, the letters case will be taken into consideration</p>": "<p>Если включено, учитывается регистр букв.</p>",
"<p>Find elements that its text content matches the input regex pattern.</p>": "<p>Находит элементы, текст которых соответствует заданному регулярному выражению.</p>",
"<p>Regex query/pattern to match</p>": "<p>Регулярное выражение для поиска совпадений.</p>",
"<p>Return the first element that matches conditions; enabled by default.</p>": "<p>Возвращает первый элемент, который удовлетворяет условиям. По умолчанию включено.</p>",
"<p>If enabled, the letters case will be taken into consideration in the regex.</p>": "<p>Если включено, регулярное выражение учитывает регистр букв.</p>",
"<p>If enabled, this will ignore all whitespaces and consecutive spaces while matching.</p>": "<p>Если включено, при поиске совпадений игнорируются пробельные символы и последовательности пробелов.</p>",
"<p>A basic <code>Fetcher</code> class type that can only do basic GET, POST, PUT, and DELETE HTTP requests based on <code>curl_cffi</code>.</p>": "<p>Базовый класс <code>Fetcher</code> для простых HTTP-запросов GET, POST, PUT и DELETE на основе <code>curl_cffi</code>.</p>",
"<p>Set multiple arguments for the parser at once globally</p>": "<p>Задаёт несколько общих настроек парсера сразу.</p>",
"<p>The keywords can be any arguments of the following: huge_tree, keep_comments, adaptive, storage, storage_args, adaptive_domain</p>": "<p>Доступны следующие именованные аргументы: huge_tree, keep_comments, adaptive, storage, storage_args, adaptive_domain.</p>",
"<p>\n <span class=\"doc-param-default\">\n <b>DEFAULT:</b>\n <code>{}</code>\n </span>\n </p>": "<p>\n <span class=\"doc-param-default\">\n <b>ПО УМОЛЧАНИЮ:</b>\n <code>{}</code>\n </span>\n </p>",
"<p>A <code>Fetcher</code> class type which is a completely stealthy built on top of Chromium.</p>": "<p>Класс <code>Fetcher</code> на основе Chromium с полным набором функций скрытной работы.</p>",
"<p>It works as real browsers passing almost all online tests/protections with many customization options.</p>": "<p>Работает как настоящий браузер, проходит почти все онлайн-тесты и системы защиты и предоставляет много настроек.</p>",
"<p>Opens up a browser and do your request based on your chosen options below.</p>": "<p>Открывает браузер и выполняет запрос с выбранными ниже настройками.</p>",
"<p>Target url.</p>": "<p>URL назначения.</p>",
"<p>Run the browser in headless/hidden (default), or headful/visible mode.</p>": "<p>Запускает браузер без видимого окна (по умолчанию) или с видимым окном.</p>",
"<p>Drop requests for unnecessary resources for a speed boost.\nRequests dropped are of type <code>font</code>, <code>image</code>, <code>media</code>, <code>beacon</code>, <code>object</code>, <code>imageset</code>, <code>texttrack</code>, <code>websocket</code>, <code>csp_report</code>, and <code>stylesheet</code>.</p>": "<p>Пропускает запросы ненужных ресурсов для ускорения работы. Пропускаются типы <code>font</code>, <code>image</code>, <code>media</code>, <code>beacon</code>, <code>object</code>, <code>imageset</code>, <code>texttrack</code>, <code>websocket</code>, <code>csp_report</code> и <code>stylesheet</code>.</p>",
"<p>A set of domain names to block requests to. Subdomains are also matched (e.g., <code>\"example.com\"</code> blocks <code>\"sub.example.com\"</code> too).</p>": "<p>Множество доменов, запросы к которым нужно блокировать. Поддомены тоже учитываются: <code>\"example.com\"</code> блокирует и <code>\"sub.example.com\"</code>.</p>",
"<p>Block requests to ~3,500 known ad/tracking domains. Can be combined with <code>blocked_domains</code>.</p>": "<p>Блокирует запросы примерно к 3 500 известным рекламным и отслеживающим доменам. Можно использовать вместе с <code>blocked_domains</code>.</p>",
"<p>Route DNS queries through Cloudflare's DNS-over-HTTPS to prevent DNS leaks when using proxies.</p>": "<p>Направляет DNS-запросы через Cloudflare DNS-over-HTTPS, чтобы избежать утечек DNS при использовании прокси.</p>",
"<p>Pass a useragent string to be used. Otherwise the fetcher will generate a real Useragent of the same browser and use it.</p>": "<p>Строка User-Agent. Если не указана, Fetcher создаёт и использует User-Agent настоящего браузера того же вида.</p>",
"<p>Set cookies for the next request.</p>": "<p>Задаёт cookie для следующего запроса.</p>",
"<p>Wait for the page until there are no network connections for at least 500 ms.</p>": "<p>Ждёт, пока на странице не будет сетевых соединений хотя бы 500 мс.</p>",
"<p>The timeout in milliseconds that is used in all operations and waits through the page. The default is 30,000</p>": "<p>Тайм-аут в миллисекундах для всех операций и ожиданий на странице. По умолчанию 30 000.</p>",
"<p>The time (milliseconds) the fetcher will wait after everything finishes before closing the page and returning the <code>Response</code> object.</p>": "<p>Время в миллисекундах, которое Fetcher ждёт после всех операций, прежде чем закрыть страницу и вернуть объект <code>Response</code>.</p>",
"<p>Added for automation. A function that takes the <code>page</code> object, runs after navigation, and does the automation you need.</p>": "<p>Функция автоматизации. Принимает объект <code>page</code> и выполняет нужные действия после перехода на страницу.</p>",
"<p>A function that takes the <code>page</code> object, runs before navigation. Use it to register event listeners or routes that must be set up before the page loads.</p>": "<p>Функция, которая принимает <code>page</code> и выполняется до перехода на страницу. Используйте её для регистрации обработчиков событий или маршрутов до загрузки страницы.</p>",
"<p>Wait for a specific CSS selector to be in a specific state.</p>": "<p>Ждёт, пока элемент по CSS-селектору достигнет указанного состояния.</p>",
"<p>An absolute path to a JavaScript file to be executed on page creation for all pages in this session.</p>": "<p>Абсолютный путь к JavaScript-файлу, который запускается при создании каждой страницы в этой сессии.</p>",
"<p>Specify user locale, for example, <code>en-GB</code>, <code>de-DE</code>, etc. Locale will affect navigator.language value, Accept-Language request header value as well as number and date formatting\nrules. Defaults to the system default locale.</p>": "<p>Локаль, например <code>en-GB</code> или <code>de-DE</code>. Влияет на navigator.language, заголовок запроса Accept-Language, а также формат чисел и дат. По умолчанию используется системная локаль.</p>",
"<p>Changes the timezone of the browser. Defaults to the system timezone.</p>": "<p>Меняет часовой пояс браузера. По умолчанию используется системный часовой пояс.</p>",
"<p>The state to wait for the selector given with <code>wait_selector</code>. The default state is <code>attached</code>.</p>": "<p>Состояние, которого нужно дождаться для селектора из <code>wait_selector</code>. По умолчанию <code>attached</code>.</p>",
"<p>Solves all types of the Cloudflare's Turnstile/Interstitial challenges before returning the response to you.</p>": "<p>Проходит все виды проверок Cloudflare Turnstile/Interstitial перед возвратом ответа.</p>",
"<p>If you have a Chrome browser installed on your device, enable this, and the Fetcher will launch an instance of your browser and use it.</p>": "<p>Если на устройстве установлен Chrome, включите эту настройку, и Fetcher запустит ваш браузер.</p>",
"<p>Add random noise to canvas operations to prevent fingerprinting.</p>": "<p>Добавляет случайный шум к операциям Canvas, чтобы помешать получению отпечатка.</p>",
"<p>Forces WebRTC to respect proxy settings to prevent local IP address leak.</p>": "<p>Заставляет WebRTC учитывать настройки прокси, чтобы избежать утечки локального IP-адреса.</p>",
"<p>Enabled by default. Disabling it disables WebGL and WebGL 2.0 support entirely. Disabling WebGL is not recommended as many WAFs now check if WebGL is enabled.</p>": "<p>По умолчанию включено. Отключение полностью убирает поддержку WebGL и WebGL 2.0. Отключать не рекомендуется, так как многие WAF проверяют наличие WebGL.</p>",
"<p>Enabled by default, wait for all JavaScript on page(s) to fully load and execute.</p>": "<p>По умолчанию включено. Ждёт полной загрузки и выполнения JavaScript на страницах.</p>",
"<p>Include open Shadow DOM content in the response HTML. Defaults to False.</p>": "<p>Включает содержимое открытых Shadow DOM в HTML ответа. По умолчанию False.</p>",
"<p>Instead of launching a new browser instance, connect to this CDP URL to control real browsers through CDP.</p>": "<p>Подключается к браузеру по этому CDP URL вместо запуска нового экземпляра.</p>",
"<p>Enabled by default, Scrapling will set a Google referer header.</p>": "<p>По умолчанию включено. Scrapling указывает Google в заголовке Referer.</p>",
"<p>A dictionary of extra headers to add to the request. <em>The referer set by <code>google_search</code> takes priority over the referer set here if used together.</em></p>": "<p>Словарь дополнительных заголовков запроса. <em>При совместном использовании Referer от <code>google_search</code> имеет приоритет над Referer из этого словаря.</em></p>",
"<p>The proxy to be used with requests, it can be a string or a dictionary with the keys 'server', 'username', and 'password' only.</p>": "<p>Прокси для запросов. Строка или словарь только с ключами 'server', 'username' и 'password'.</p>",
"<p>Path to a User Data Directory, which stores browser session data like cookies and local storage. The default is to create a temporary directory.</p>": "<p>Путь к каталогу пользовательских данных браузера, например cookie и local storage. По умолчанию создаётся временный каталог.</p>",
"<p>A list of additional browser flags to pass to the browser on launch.</p>": "<p>Список дополнительных флагов, передаваемых браузеру при запуске.</p>",
"<p>The arguments that will be passed in the end while creating the final Selector's class.</p>": "<p>Аргументы, передаваемые при создании итогового объекта Selector.</p>",
"<p>Additional arguments to be passed to Playwright's context as additional settings, and it takes higher priority than Scrapling's settings.</p>": "<p>Дополнительные настройки контекста Playwright. Имеют приоритет над настройками Scrapling.</p>",
"<p>A <code>Response</code> object.</p>": "<p>Объект <code>Response</code>.</p>",
"<p>A factory context manager that provides configured Fetcher sessions.</p>": "<p>Контекстный менеджер, который создаёт сессии Fetcher с заданными настройками.</p>",
"<p>When this manager is used in a 'with' or 'async with' block,\nit yields a new session configured with the manager's defaults.\nA single instance of this manager should ideally be used for one active\nsession at a time (or sequentially). Re-entering a context with the\nsame manager instance while a session is already active is disallowed.</p>": "<p>При использовании в блоке 'with' или 'async with' этот менеджер создаёт новую сессию со своими настройками по умолчанию. Один экземпляр менеджера лучше использовать для одной активной сессии за раз или для нескольких сессий по очереди. Повторно входить в контекст того же менеджера, пока сессия активна, нельзя.</p>",
"<p>Browser version to impersonate. Can be a single browser string or a list of browser strings for random selection. (Default: latest available Chrome version)</p>": "<p>Версия браузера для имитации. Можно передать одну строку с браузером или список строк для случайного выбора. По умолчанию используется последняя доступная версия Chrome.</p>",
"<p>Whether to use HTTP3. Defaults to False. It might be problematic if used it with <code>impersonate</code>.</p>": "<p>Использовать ли HTTP3. По умолчанию False. При совместном использовании с <code>impersonate</code> возможны проблемы.</p>",
"<p>If enabled (default), it creates and adds real browser headers. It also sets a Google referer header.</p>": "<p>При включении (по умолчанию) создаёт и добавляет заголовки настоящего браузера, а также указывает Google в заголовке Referer.</p>",
"<p>Dict of proxies to use. Format: {\"http\": proxy_url, \"https\": proxy_url}.</p>": "<p>Словарь прокси в формате {\"http\": proxy_url, \"https\": proxy_url}.</p>",
"<p>Proxy URL to use. Format: \"http://username:password@localhost:8030\".\nCannot be used together with the <code>proxies</code> parameter.</p>": "<p>URL прокси в формате \"http://username:password@localhost:8030\". Нельзя использовать вместе с аргументом <code>proxies</code>.</p>",
"<p>HTTP basic auth for proxy, tuple of (username, password).</p>": "<p>HTTP Basic-аутентификация для прокси, кортеж (username, password).</p>",
"<p>Number of seconds to wait before timing out.</p>": "<p>Время ожидания до тайм-аута в секундах.</p>",
"<p>Headers to include in the session with every request.</p>": "<p>Заголовки, включаемые в каждый запрос сессии.</p>",
"<p>Number of retry attempts. Defaults to 3.</p>": "<p>Число повторных попыток. По умолчанию 3.</p>",
"<p>Number of seconds to wait between retry attempts. Defaults to 1 second.</p>": "<p>Пауза между повторными попытками в секундах. По умолчанию 1 секунда.</p>",
"<p>Whether to follow redirects. Defaults to \"safe\", which follows redirects but rejects those targeting internal/private IPs (SSRF protection). Pass True to follow all redirects without restriction.</p>": "<p>Следовать ли перенаправлениям. По умолчанию \"safe\": перенаправления разрешены, но переходы на внутренние и частные IP-адреса отклоняются для защиты от SSRF. Передайте True, чтобы разрешить все перенаправления без ограничений.</p>",
"<p>Maximum number of redirects. Default 30, use -1 for unlimited.</p>": "<p>Максимальное число перенаправлений. По умолчанию 30. Значение -1 убирает ограничение.</p>",
"<p>Whether to verify HTTPS certificates. Defaults to True.</p>": "<p>Проверять ли сертификаты HTTPS. По умолчанию True.</p>",
"<p>Tuple of (cert, key) filenames for the client certificate.</p>": "<p>Кортеж имён файлов (cert, key) для клиентского сертификата.</p>",
"<p>Arguments passed when creating the final Selector class.</p>": "<p>Аргументы, передаваемые при создании итогового объекта Selector.</p>",
"<p>A ProxyRotator instance for automatic proxy rotation.</p>": "<p>Экземпляр ProxyRotator для автоматической смены прокси.</p>",
"<p>Creates and returns a new synchronous Fetcher Session</p>": "<p>Создаёт и возвращает новую синхронную сессию Fetcher.</p>",
"<p>Creates and returns a new asynchronous Session.</p>": "<p>Создаёт и возвращает новую асинхронную сессию.</p>",
"<p>A Stealthy Browser session manager with page pooling.</p>": "<p>Менеджер сессий скрытного браузера с пулом вкладок.</p>",
"<p>A Browser session manager with page pooling, it's using a persistent browser Context by default with a temporary user profile directory.</p>": "<p>Менеджер сессий браузера с пулом вкладок. По умолчанию использует постоянный контекст браузера с временным каталогом профиля пользователя.</p>",
"<p>Save completed browser requests and responses. Failed or unfinished requests are omitted. Defaults to False.</p>": "<p>Сохраняет завершённые запросы и ответы браузера. Неудачные и незавершённые запросы пропускаются. По умолчанию False.</p>",
"<p>Maximum retained requests per session. Defaults to 1000; older entries are removed.</p>": "<p>Максимальное число сохранённых запросов в сессии. По умолчанию 1 000. Старые записи удаляются.</p>",
"<p>Save cookies, local storage and IndexedDB to a Playwright-compatible JSON file.</p>": "<p>Сохраняет cookie, local storage и IndexedDB в JSON-файл, совместимый с Playwright.</p>",
"<p>Requires a started session without proxy rotation. Does not save sessionStorage.</p>": "<p>Нужна запущенная сессия без смены прокси. sessionStorage не сохраняется.</p>",
"<p>Replace cookies, local storage and IndexedDB from a Playwright-compatible JSON file.</p>": "<p>Заменяет cookie, local storage и IndexedDB данными из JSON-файла, совместимого с Playwright.</p>",
"<p>Requires a started session without proxy rotation. Fetch or reload pages to use the restored login.</p>": "<p>Нужна запущенная сессия без смены прокси. Чтобы использовать восстановленный вход, получите или перезагрузите страницы.</p>",
"<p>Close every open tab in the session's pool. The next request opens a fresh tab.</p>": "<p>Закрывает все открытые вкладки в пуле сессии. Следующий запрос откроет новую вкладку.</p>",
"<p>Close all resources</p>": "<p>Закрывает все ресурсы.</p>",
"<p>Get statistics about the current page pool</p>": "<p>Возвращает статистику текущего пула вкладок.</p>",
"<p>Create a browser for this instance and context.</p>": "<p>Создаёт браузер для этого экземпляра и контекста.</p>",
"<p>Opens up the browser and do your request based on your chosen options.</p>": "<p>Открывает браузер и выполняет запрос с выбранными настройками.</p>",
"<p>The Target url.</p>": "<p>URL назначения.</p>",
"<p>Static proxy to override rotator and session proxy. A new browser context will be created and used with it.</p>": "<p>Фиксированный прокси, который переопределяет механизм смены и прокси сессии. Для него создаётся отдельный контекст браузера.</p>",
"<p>An async Stealthy Browser session manager with page pooling.</p>": "<p>Менеджер асинхронных сессий скрытного браузера с пулом вкладок.</p>",
"<p>A thread-safe proxy rotator with pluggable rotation strategies.</p>": "<p>Потокобезопасный механизм смены прокси с возможностью задать свой способ выбора.</p>",
"<p>Supports:\n- Cyclic rotation (default)\n- Custom rotation strategies via callable\n- Both string URLs and Playwright-style dict proxies</p>": "<p>Поддерживает:\n- Циклическую смену прокси (по умолчанию)\n- Свои способы выбора через вызываемый объект\n- Прокси в виде URL-строк и словарей в формате Playwright</p>",
"<p>Initialize the proxy rotator.</p>": "<p>Инициализирует механизм смены прокси.</p>",
"<p>List of proxy URLs or Playwright-style proxy dicts.\n- String format: \"http://proxy1:8080\" or \"http://user:pass@proxy:8080\"\n- Dict format: {\"server\": \"http://proxy:8080\", \"username\": \"user\", \"password\": \"pass\"}</p>": "<p>Список URL прокси или словарей в формате Playwright.\n- Формат строки: \"http://proxy1:8080\" или \"http://user:pass@proxy:8080\"\n- Формат словаря: {\"server\": \"http://proxy:8080\", \"username\": \"user\", \"password\": \"pass\"}</p>",
"<p>Rotation strategy function. Takes (proxies, current_index) and returns (proxy, next_index). Defaults to cyclic_rotation.</p>": "<p>Функция выбора прокси. Принимает (proxies, current_index) и возвращает (proxy, next_index). По умолчанию cyclic_rotation.</p>",
"<p>Get a copy of all configured proxies.</p>": "<p>Возвращает копию всех настроенных прокси.</p>",
"<p>Get the next proxy according to the rotation strategy.</p>": "<p>Возвращает следующий прокси согласно выбранному способу смены.</p>",
"<p>Return the total number of configured proxies.</p>": "<p>Возвращает общее число настроенных прокси.</p>",
"<p>Extends standard Python string by adding more functionality</p>": "<p>Расширяет стандартную строку Python дополнительными возможностями.</p>",
"<p>Return a sorted version of the string</p>": "<p>Возвращает строку с отсортированными символами.</p>",
"<p>Return a new version of the string after removing all white spaces and consecutive spaces</p>": "<p>Возвращает новую строку без пробельных символов и последовательностей пробелов.</p>",
"<p>Return JSON response if the response is jsonable otherwise throw error</p>": "<p>Преобразует ответ в JSON и возвращает результат. Если преобразование невозможно, вызывает ошибку.</p>",
"<p>If enabled, this will ignore all whitespaces and consecutive spaces while matching</p>": "<p>Если включено, при поиске совпадений игнорируются пробельные символы и последовательности пробелов.</p>",
"<p>If disabled, function will set the regex to ignore the letters-case while compiling it</p>": "<p>Если выключено, регулярное выражение компилируется без учёта регистра букв.</p>",
"<p>Used to quickly check if this regex matches or not without any operations on the results</p>": "<p>Быстро проверяет, есть ли совпадение с регулярным выражением, без обработки результатов.</p>",
"<p>The :class:<code>TextHandlers</code> class is a subclass of the builtin <code>List</code> class, which provides a few additional methods.</p>": "<p>Класс :class:<code>TextHandlers</code> наследует встроенный <code>List</code> и добавляет несколько методов.</p>",
"<p>Call the <code>.re()</code> method for each element in this list and return\ntheir results flattened as TextHandlers.</p>": "<p>Вызывает <code>.re()</code> для каждого элемента списка, объединяет результаты в один список и возвращает его как TextHandlers.</p>",
"<p>if disabled, the function will set the regex to ignore the letters-case while compiling it</p>": "<p>Если выключено, регулярное выражение компилируется без учёта регистра букв.</p>",
"<p>Call the <code>.re_first()</code> method for each element in this list and return\nthe first result or the default value otherwise.</p>": "<p>Вызывает <code>.re_first()</code> для каждого элемента списка и возвращает первый результат либо значение по умолчанию.</p>",
"<p>Returns the first item of the current list</p>": "<p>Возвращает первый элемент текущего списка.</p>",
"<p>the default value to return if the current list is empty</p>": "<p>Значение, которое возвращается, если текущий список пуст.</p>",
"<p>A read-only mapping to use instead of the standard dictionary for the speed boost, but at the same time I use it to add more functionalities.\nIf the standard dictionary is needed, convert this class to a dictionary with the <code>dict</code> function</p>": "<p>Отображение только для чтения, которое заменяет обычный словарь для ускорения работы и добавляет новые возможности. Если нужен стандартный словарь, преобразуйте объект функцией <code>dict</code>.</p>",
"<p>Convert current attributes to JSON bytes if the attributes are JSON serializable otherwise throws error</p>": "<p>Преобразует текущие атрибуты в байты JSON. Если атрибуты нельзя преобразовать, вызывает ошибку.</p>",
"<p>Acts like the standard dictionary <code>.get()</code> method</p>": "<p>Работает как метод <code>.get()</code> стандартного словаря.</p>",
"<p>Search current attributes by values and return a dictionary of each matching item</p>": "<p>Ищет среди значений текущих атрибутов и возвращает словарь для каждого совпадения.</p>",
"<p>The keyword to search for in the attribute values</p>": "<p>Ключевое слово для поиска в значениях атрибутов.</p>",
"<p>If True, the function will search if keyword in each value instead of perfect match</p>": "<p>При True проверяет, содержится ли ключевое слово в каждом значении, вместо точного совпадения.</p>",
"<p>Request's response information structure.</p>": "<p>Структура со сведениями об ответе на запрос.</p>",
"<p><code>browser_network_requests</code> returns <code>NetworkRequestsModel</code> with <code>requests</code>, <code>next_cursor</code>, <code>has_more</code>, and <code>dropped_count</code>. Each <code>NetworkRequestInfo</code> contains <code>id</code>, <code>url</code>, <code>method</code>, <code>resource_type</code>, and <code>status</code>. Pass <code>next_cursor</code> as <code>after_id</code> to continue; <code>has_more</code> indicates more current matches.</p>": "<p><code>browser_network_requests</code> возвращает <code>NetworkRequestsModel</code> с полями <code>requests</code>, <code>next_cursor</code>, <code>has_more</code> и <code>dropped_count</code>. Каждый <code>NetworkRequestInfo</code> содержит <code>id</code>, <code>url</code>, <code>method</code>, <code>resource_type</code> и <code>status</code>. Чтобы получить продолжение, передайте <code>next_cursor</code> как <code>after_id</code>. Поле <code>has_more</code> показывает, есть ли ещё совпадения в текущей истории.</p>",
"<p><code>browser_network_request</code> returns <code>NetworkRequestModel</code> with <code>request_id</code>, <code>part</code>, <code>data</code>, and <code>note</code>. Summaries and headers are objects; the full saved body text is returned as a string, including JSON response text. <code>note</code> explains missing body data or partial headers.</p>": "<p><code>browser_network_request</code> возвращает <code>NetworkRequestModel</code> с полями <code>request_id</code>, <code>part</code>, <code>data</code> и <code>note</code>. Сводки и заголовки возвращаются как объекты. Полный сохранённый текст тела возвращается строкой, даже для JSON-ответов. Поле <code>note</code> объясняет отсутствие тела или неполные заголовки.</p>",
"<p>Summary of a recorded browser request.</p>": "<p>Сводка записанного запроса браузера.</p>",
"<p>Recorded request summaries and pagination details.</p>": "<p>Сводки записанных запросов и сведения о постраничной выдаче.</p>",
"<p>One complete saved request part, with an optional note.</p>": "<p>Одна полная сохранённая часть запроса с необязательным примечанием.</p>",
"<p>Model classes for session management:</p>": "<p>Классы моделей для управления сессиями:</p>",
"<p>Information about an open browser session.</p>": "<p>Сведения об открытой сессии браузера.</p>",
"<p>Response returned when a new session is created.</p>": "<p>Ответ при создании новой сессии.</p>",
"<p>Response returned when a session is closed.</p>": "<p>Ответ при закрытии сессии.</p>",
"<p>The main MCP server class that provides all web scraping tools:</p>": "<p>Основной класс MCP-сервера, который предоставляет все инструменты сбора данных с сайтов:</p>",
"<p><strong><code>browser_fetch_once</code></strong>: Fetch one URL through a stealthy browser with JavaScript rendering and Cloudflare handling, then close the browser. Use a persistent session for later actions or network history.</p>": "<p><strong><code>browser_fetch_once</code></strong>: загружает один URL через скрытный браузер с выполнением JavaScript и обработкой проверок Cloudflare, затем закрывает браузер. Для последующих действий или сетевой истории используйте постоянную сессию.</p>",
"<p><strong><code>browser_extract</code></strong>: Read the current page or one element as an AI snapshot, HTML, Markdown, or text without reloading it. Keep results from forms and page actions. Snapshots include element roles, names, references, positions, and sizes; regex search returns matching lines with nearby context and parent nodes.</p>": "<p><strong><code>browser_extract</code></strong>: читает текущую страницу или один элемент как снимок для ИИ, HTML, Markdown или текст без перезагрузки. Сохраняет результаты заполнения форм и действий на странице. Снимки содержат роли, имена, ссылки, координаты и размеры элементов. Поиск по регулярному выражению возвращает совпавшие строки с соседним контекстом и родительскими узлами.</p>",
"<p><strong><code>browser_actions</code></strong>: Chain mouse moves, hovers, clicks, scrolling, field filling, keyboard shortcuts, dialog replies, and waits in one call. Accept or dismiss alerts and confirmations, or enter text in prompts. Fill a search box, submit it, wait for results, and open a result without a separate call for each step.</p>": "<p><strong><code>browser_actions</code></strong>: объединяет в одном вызове перемещение мыши, наведение, клики, прокрутку, заполнение полей, сочетания клавиш, ответы на диалоги и ожидания. Можно принять или отклонить уведомления и подтверждения, а также ввести текст в диалог запроса. Заполните строку поиска, отправьте запрос, дождитесь результатов и откройте один из них без отдельного вызова для каждого шага.</p>",
"<p>Moves and clicks target selectors, snapshot references, or coordinates; element targets wait and scroll into view. Supports movement in multiple steps, left, right, and middle clicks, double-clicks, and scrolling nested panels.</p>": "<p>Перемещения и клики используют селекторы, ссылки из снимка или координаты. При выборе элемента инструмент ждёт его и прокручивает в видимую область. Поддерживаются перемещение в несколько шагов, клики левой, правой и средней кнопкой, двойные клики и прокрутка вложенных панелей.</p>",
"<p>Target fields anywhere on the page through selectors or snapshot references. Fill text, check or uncheck boxes, select radio buttons, and choose one or more native dropdown options by label. Replace or clear text, or type at the current caret. Keyboard shortcuts use the current focus. Slow mode adds random pauses between typed characters and all actions.</p>": "<p>Выбирайте поля в любой части страницы с помощью селекторов или ссылок из снимка. Можно заполнять текст, устанавливать и снимать флажки, выбирать радиокнопки и один или несколько вариантов обычного выпадающего списка по подписи. Текст можно заменить, очистить или дописать в позиции курсора. Сочетания клавиш работают с текущим фокусом. Медленный режим добавляет случайные паузы между вводимыми символами и всеми действиями.</p>",
"<p>Wait for content or loading overlays through selectors or snapshot references, wait for page load events or settled network activity, or add a fixed pause before continuing.</p>": "<p>Ожидает нужного состояния содержимого или индикаторов загрузки по селекторам или ссылкам из снимка, событий загрузки страницы, завершения сетевой активности или заданной паузы перед продолжением.</p>",
"<p><strong><code>browser_evaluate</code></strong>: Run JavaScript on the current page to extract custom data, calculate results, read application state, or update page content. Supports asynchronous scripts and returns their results as JSON.</p>": "<p><strong><code>browser_evaluate</code></strong>: выполняет JavaScript на текущей странице для извлечения данных по своим правилам, вычислений, чтения состояния приложения или изменения содержимого страницы. Поддерживает асинхронные скрипты и возвращает их результаты в JSON.</p>",
"<p>Create a Scrapling MCP server.</p>": "<p>Создаёт MCP-сервер Scrapling.</p>",
"<p>Optional global Chromium-compatible browser executable path for browser tools.\nIf omitted, the SCRAPLING_EXECUTABLE_PATH environment variable is used when set.</p>": "<p>Необязательный путь к исполняемому файлу Chromium-совместимого браузера для всех браузерных инструментов. Если не задан, используется переменная окружения SCRAPLING_EXECUTABLE_PATH, если она установлена.</p>",
"<p>Optional shared token that clients must send as <code>Authorization: Bearer <token></code>.\nIf omitted, the SCRAPLING_MCP_AUTH_TOKEN environment variable is used when set. It only applies\nto the streamable-http transport.</p>": "<p>Необязательный общий токен, который клиенты должны отправлять через <code>Authorization: Bearer <token></code>. Если не задан, используется переменная окружения SCRAPLING_MCP_AUTH_TOKEN, если она установлена. Применяется только к транспорту streamable-http.</p>",
"<p>Open a reusable stealthy browser session. Pass per-request options to <code>browser_fetch</code>.</p>": "<p>Открывает сессию скрытного браузера для повторного использования. Параметры отдельных запросов передавайте в <code>browser_fetch</code>.</p>",
"<p>Save browser cookies, local storage and IndexedDB as Playwright-compatible JSON. Excludes sessionStorage.</p>": "<p>Сохраняет Cookie браузера, local storage и IndexedDB в JSON, совместимый с Playwright. Не включает sessionStorage.</p>",
"<p>Replace browser cookies, local storage and IndexedDB from a Playwright-compatible JSON file.</p>": "<p>Заменяет Cookie браузера, local storage и IndexedDB данными из JSON-файла, совместимого с Playwright.</p>",
"<p>Leaves sessionStorage and open tabs unchanged. Fetch or reload pages to use the restored login.</p>": "<p>Не меняет sessionStorage и открытые вкладки. Загрузите или обновите страницы, чтобы использовать восстановленный вход.</p>",
"<p>Open a reusable HTTP session for <code>session_make_request</code>, keeping cookies, connections, and request settings.</p>": "<p>Открывает HTTP-сессию для повторных вызовов <code>session_make_request</code>, сохраняя Cookie, соединения и настройки запросов.</p>",
"<p>Close a session and free its resources.</p>": "<p>Закрывает сессию и освобождает её ресурсы.</p>",
"<p>List registered sessions, their status, and effective settings.</p>": "<p>Показывает зарегистрированные сессии, их состояние и действующие настройки.</p>",
"<p>List completed requests across page changes, with IDs and pagination. Recording starts when the browser session opens.</p>": "<p>Показывает завершённые запросы, сохранённые при переходах между страницами, с ID и постраничным выводом. Запись начинается при открытии сессии браузера.</p>",
"<p>Read a complete saved request part without resending it, with structured data and availability notes.</p>": "<p>Полностью читает выбранную часть сохранённого запроса без повторной отправки, возвращая структурированные данные и сведения об их доступности.</p>",
"<p>Read the current page or one element as snapshot, HTML, Markdown, or text without navigating.\nReturn plain text; snapshot search keeps refs, ancestor paths and three lines of nearby context.</p>": "<p>Читает текущую страницу или один элемент как снимок, HTML, Markdown или текст без перехода на другую страницу. Возвращает обычный текст. Поиск по снимку сохраняет ссылки, пути предков и три строки соседнего контекста.</p>",
"<p>Run mouse, field, key, dialog, and wait actions in order; return plain text without a snapshot.\nStop on the first error, identifying its action; partial effects remain. No retries.\nElement mouse targets auto-wait and scroll into view; coordinates and wheel do not wait for navigation or scrolling.\nCancelled/timed-out clicks attempt button release. Load waits observe the current document, not future navigation.</p>": "<p>По порядку выполняет действия мышью, с полями, клавишами, диалогами и ожиданиями. Возвращает обычный текст без снимка. Останавливается при первой ошибке и указывает действие, которое её вызвало. Уже выполненные действия сохраняют результат. Повторных попыток нет. Для действий мышью над элементами автоматически ждёт их появления и прокручивает в видимую область. Действия по координатам и колёсиком не ждут перехода или прокрутки. При отмене клика или тайм-ауте пытается отпустить кнопку. Ожидание загрузки относится к текущему документу, а не к будущему переходу.</p>",
"<p>Run JavaScript on the current page, await promises, and return JSON text without a snapshot.\nReturn JSON-compatible values; null/undefined become null. Script effects are not undone on failure.\nCancellation stops waiting, but may not stop the script.</p>": "<p>Выполняет JavaScript на текущей странице, ждёт завершения Promise и возвращает текст JSON без снимка. Скрипт должен вернуть значение, совместимое с JSON; null/undefined становятся null. При ошибке изменения скрипта не отменяются. Отмена прекращает ожидание, но может не остановить скрипт.</p>",
"<p>Capture the current page or one element without navigating; return the image and current URL.\nElement capture waits and scrolls into view. Use browser_actions for other waits before capture.</p>": "<p>Снимает текущую страницу или один элемент без перехода, возвращает изображение и текущий URL. При съёмке элемента ждёт его и прокручивает в видимую область. Для других ожиданий перед снимком используйте browser_actions.</p>",
"<p>Make an HTTP request without JavaScript. Suitable for low-to-mid protection.</p>": "<p>Выполняет HTTP-запрос без JavaScript. Подходит для сайтов с низким или средним уровнем защиты.</p>",
"<p>Fetch a page with a stealth browser and JavaScript rendering.</p>": "<p>Загружает страницу через скрытный браузер с выполнением JavaScript.</p>",
"<p>Fetch a URL in an open stealthy browser session. Options apply only to this request.</p>": "<p>Загружает URL в открытой сессии скрытного браузера. Параметры применяются только к этому запросу.</p>",
"<p>Make an HTTP request using the session's cookies, connections, impersonation, and proxy. Options apply to this request.</p>": "<p>Выполняет HTTP-запрос с Cookie, соединениями, настройками имитации браузера и прокси сессии. Параметры применяются к этому запросу.</p>",
"<p>Serve the MCP server.</p>": "<p>Запускает MCP-сервер.</p>",
"<p>Serve over the streamable-http transport instead of stdio.</p>": "<p>Использует транспорт streamable-http вместо stdio.</p>",
"<p>The host to bind to when <code>http</code> is enabled.</p>": "<p>Адрес для привязки при включённом <code>http</code>.</p>",
"<p>The port to bind to when <code>http</code> is enabled.</p>": "<p>Порт для привязки при включённом <code>http</code>.</p>",
"<p>Host names to accept, which turns on DNS-rebinding protection.</p>": "<p>Разрешённые имена хостов. Их указание включает защиту от DNS rebinding.</p>",
"<p>Start the streamable-http transport without a token. The transport\nrequires authentication by default, so this is the explicit opt-out.</p>": "<p>Запускает streamable-http без токена. По умолчанию этот транспорт требует аутентификации, поэтому параметр явно отключает её.</p>",
"<p>The <code>Selectors</code> class is a subclass of the builtin <code>List</code> class, which provides a few additional methods.</p>": "<p>Класс <code>Selectors</code> наследует встроенный класс <code>List</code> и добавляет несколько методов.</p>",
"<p>Returns the first Selector item of the current list or <code>None</code> if the list is empty</p>": "<p>Возвращает первый элемент Selector текущего списка или <code>None</code>, если список пуст.</p>",
"<p>Returns the last Selector item of the current list or <code>None</code> if the list is empty</p>": "<p>Возвращает последний элемент Selector текущего списка или <code>None</code>, если список пуст.</p>",
"<p>Returns the length of the current list</p>": "<p>Возвращает длину текущего списка.</p>",
"<p>Call the <code>.xpath()</code> method for each element in this list and return\ntheir results as another <code>Selectors</code> class.</p>": "<p>Вызывает метод <code>.xpath()</code> для каждого элемента списка и возвращает результаты в другом объекте <code>Selectors</code>.</p>",
"<p>A string that will be used to retrieve element's data in adaptive,\notherwise the selector will be used.</p>": "<p>Строка для получения данных элемента в адаптивном режиме. Если не задана, используется селектор.</p>",
"<p>Call the <code>.css()</code> method for each element in this list and return\ntheir results flattened as another <code>Selectors</code> class.</p>": "<p>Вызывает метод <code>.css()</code> для каждого элемента списка и объединяет результаты в один объект <code>Selectors</code>.</p>",
"<p>Call the <code>.re()</code> method for each element in this list and return\ntheir results flattened as List of TextHandler.</p>": "<p>Вызывает метод <code>.re()</code> для каждого элемента списка и объединяет результаты в List из объектов TextHandler.</p>",
"<p>if disabled, function will set the regex to ignore the letters case while compiling it</p>": "<p>Если отключено, функция при компиляции регулярного выражения включает поиск без учёта регистра букв.</p>",
"<p>Loop over all current elements and return the first element that matches the passed function</p>": "<p>Перебирает текущие элементы и возвращает первый, который соответствует условию переданной функции.</p>",
"<p>A function that takes each element as an argument and returns True/False</p>": "<p>Функция, которая принимает каждый элемент как аргумент и возвращает True/False.</p>",
"<p>The first element that match the function or <code>None</code> otherwise.</p>": "<p>Первый элемент, соответствующий условию функции, или <code>None</code>, если такого нет.</p>",
"<p>Filter current elements based on the passed function</p>": "<p>Фильтрует текущие элементы с помощью переданной функции.</p>",
"<p>The new <code>Selectors</code> object or empty list otherwise.</p>": "<p>Новый объект <code>Selectors</code> или пустой список, если совпадений нет.</p>",
"<p>Returns the serialized string of the first element, or <code>default</code> if empty.</p>": "<p>Возвращает сериализованную строку первого элемента или <code>default</code>, если список пуст.</p>",
"<p>Serialize all elements and return as a TextHandlers list.</p>": "<p>Сериализует все элементы и возвращает их в списке TextHandlers.</p>",
"<p>An abstract base class for creating web spiders.</p>": "<p>Абстрактный базовый класс для создания веб-краулеров Spider.</p>",
"<p>Check the documentation website for more information.</p>": "<p>Подробнее см. на сайте документации.</p>",
"<p>Initialize the spider.</p>": "<p>Инициализирует Spider.</p>",
"<p>Directory for checkpoint files. If provided, enables pause/resume.</p>": "<p>Каталог файлов контрольных точек. Если задан, доступны пауза и возобновление.</p>",
"<p>Seconds between periodic checkpoint saves (default 5 minutes).</p>": "<p>Интервал сохранения контрольных точек в секундах. По умолчанию 5 минут.</p>",
"<p>Access current crawl stats (works during streaming).</p>": "<p>Доступ к текущей статистике обхода, в том числе при потоковой выдаче.</p>",
"<p>Generate initial requests to start the crawl.</p>": "<p>Создаёт начальные запросы для запуска обхода.</p>",
"<p>By default, this generates Request objects for each URL in <code>start_urls</code>\nusing the session manager's default session and <code>parse()</code> as callback.</p>": "<p>По умолчанию создаёт объекты Request для каждого URL из <code>start_urls</code>, используя стандартную сессию менеджера и <code>parse()</code> в качестве обработчика.</p>",
"<p>Override this method for more control over initial requests\n(e.g., to add custom headers, use different callbacks, etc.)</p>": "<p>Переопределите этот метод, чтобы настроить начальные запросы: добавить свои заголовки, использовать другие обработчики и так далее.</p>",
"<p>Default callback for processing responses</p>": "<p>Обработчик ответов по умолчанию.</p>",
"<p>Called before crawling starts. Override for setup logic.</p>": "<p>Вызывается перед началом обхода. Переопределите для подготовки к работе.</p>",
"<p>It's enabled if the spider is resuming from a checkpoint, left for the user to use.</p>": "<p>Включено, если Spider продолжает работу с контрольной точки. Можно использовать в своём коде.</p>",
"<p>Called after crawling finishes. Override for cleanup logic.</p>": "<p>Вызывается после завершения обхода. Переопределите для освобождения ресурсов.</p>",
"<p>Handle request errors for all spider requests.</p>": "<p>Обрабатывает ошибки всех запросов Spider.</p>",
"<p>Override for custom error handling.</p>": "<p>Переопределите, чтобы задать свою обработку ошибок.</p>",
"<p>A hook to be overridden by users to do some processing on scraped items, return <code>None</code> to drop the item silently.</p>": "<p>Хук для обработки собранных записей. Его можно переопределить. Возврат <code>None</code> удаляет запись без сообщения.</p>",
"<p>Check if the response is blocked. Users should override this for custom detection logic.</p>": "<p>Проверяет, заблокирован ли ответ. Переопределите для своей проверки.</p>",
"<p>Users should override this to prepare the blocked request before retrying, if needed.</p>": "<p>При необходимости переопределите этот метод, чтобы подготовить заблокированный запрос перед повторной попыткой.</p>",
"<p>String representation of the spider.</p>": "<p>Строковое представление Spider.</p>",
"<p>Configure sessions for this spider.</p>": "<p>Настраивает сессии этого Spider.</p>",
"<p>Override this method to add custom sessions.\nThe default implementation creates a FetcherSession session.</p>": "<p>Переопределите метод, чтобы добавить свои сессии. По умолчанию создаётся сессия FetcherSession.</p>",
"<p>The first session added becomes the default for <code>start_requests()</code> unless specified otherwise.</p>": "<p>Первая добавленная сессия становится стандартной для <code>start_requests()</code>, если не указано иное.</p>",
"<p>SessionManager to configure</p>": "<p>Менеджер SessionManager, который нужно настроить.</p>",
"<p>Request graceful shutdown of the crawling process.</p>": "<p>Запрашивает завершение обхода с ожиданием активных задач.</p>",
"<p>Run the spider and return results.</p>": "<p>Запускает Spider и возвращает результаты.</p>",
"<p>This is the main entry point for running a spider.\nHandles async execution internally via anyio.</p>": "<p>Основная точка входа для запуска Spider. Асинхронное выполнение внутри управляется через anyio.</p>",
"<p>Pressing Ctrl+C will initiate graceful shutdown (waits for active tasks to complete).\nPressing Ctrl+C a second time will force immediate stop.</p>": "<p>Нажатие Ctrl+C запускает завершение с ожиданием активных задач. Второе нажатие Ctrl+C немедленно останавливает работу.</p>",
"<p>If crawldir is set, a checkpoint will also be saved on graceful shutdown,\nallowing you to resume the crawl later by running the spider again.</p>": "<p>Если задан crawldir, при завершении с ожиданием активных задач также сохраняется контрольная точка. Повторный запуск Spider позволит продолжить обход позже.</p>",
"<p>Whether to use the faster uvloop/winloop event loop implementation, if available.</p>": "<p>Использовать ли более быструю реализацию цикла событий uvloop/winloop, если она доступна.</p>",
"<p>Asyncio backend options to be used with <code>anyio.run</code></p>": "<p>Параметры бэкенда Asyncio для <code>anyio.run</code>.</p>",
"<p>Stream items as they're scraped. Ideal for long-running spiders or building applications on top of the spiders.</p>": "<p>Выдаёт записи потоком по мере сбора. Подходит для долгих обходов или приложений, построенных на Spider.</p>",
"<p>Must be called from an async context. Yields items one by one as they are scraped.\nAccess <code>spider.stats</code> during iteration for real-time statistics.</p>": "<p>Нужно вызывать из асинхронного контекста. Выдаёт записи по одной по мере сбора. Во время перебора текущая статистика доступна через <code>spider.stats</code>.</p>",
"<p>Note: SIGINT handling for pause/resume is not available in stream mode.</p>": "<p>Примечание: в потоковом режиме обработка SIGINT для паузы и возобновления недоступна.</p>",
"<p>Create a copy of this request.</p>": "<p>Создаёт копию этого запроса.</p>",
"<p>Generate a unique fingerprint for deduplication.</p>": "<p>Создаёт уникальный отпечаток для удаления дубликатов.</p>",
"<p>Caches the result in self._fp after first computation.</p>": "<p>После первого вычисления кеширует результат в self._fp.</p>",
"<p>Compare requests by priority</p>": "<p>Сравнивает запросы по приоритету.</p>",
"<p>Requests are equal if they have the same fingerprint.</p>": "<p>Запросы равны, если у них одинаковый отпечаток.</p>",
"<p>Prepare state for pickling - store callback as name string for pickle compatibility.</p>": "<p>Готовит состояние для pickle: сохраняет имя обработчика строкой для совместимости с pickle.</p>",
"<p>Restore state from pickle - callback restored later via _restore_callback().</p>": "<p>Восстанавливает состояние из pickle. Обработчик будет восстановлен позже через _restore_callback().</p>",
"<p>Complete result from a spider run.</p>": "<p>Полный результат одного запуска Spider.</p>",
"<p>True if the crawl completed normally (not paused).</p>": "<p>True, если обход завершился нормально, без паузы.</p>",
"<p>Statistics for a crawl run.</p>": "<p>Статистика одного обхода.</p>",
"<p>A list of scraped items with export capabilities.</p>": "<p>Список собранных записей с возможностью экспорта.</p>",
"<p>Export items to a JSON file.</p>": "<p>Экспортирует записи в JSON-файл.</p>",
"<p>Path to the output file</p>": "<p>Путь к выходному файлу.</p>",
"<p>Pretty-print with 2-space indentation (slightly slower)</p>": "<p>Форматирует вывод с отступом в 2 пробела. Немного медленнее.</p>",
"<p>Export items as JSON Lines (one JSON object per line).</p>": "<p>Экспортирует записи в JSON Lines, по одному JSON-объекту на строку.</p>",
"<p>Export items to a CSV file.</p>": "<p>Экспортирует записи в CSV-файл.</p>",
"<p>Items that don't share the same keys are still written, with the missing cells left empty, and any value\nthat isn't a scalar (a nested dictionary or a list) is written as JSON.</p>": "<p>Записи с разными наборами ключей тоже сохраняются. Пропущенные ячейки остаются пустыми, а нескалярные значения, то есть вложенные словари или списки, записываются как JSON.</p>",
"<p>The columns to write, defaulting to every key found in the items, in the order they appeared</p>": "<p>Столбцы для записи. По умолчанию используются все ключи, найденные в записях, в порядке первого появления.</p>",
"<p>The character separating the columns</p>": "<p>Символ-разделитель столбцов.</p>",
"<p>Export items to an XML file.</p>": "<p>Экспортирует записи в XML-файл.</p>",
"<p>Each item becomes an element whose children are named after the item's keys. Keys that aren't valid XML\nnames are rewritten and keep the original in a <code>name</code> attribute, and any value that isn't a scalar\n(a nested dictionary or a list) is written as JSON.</p>": "<p>Каждая запись становится элементом, дочерние элементы которого называются по ключам записи. Ключи, недопустимые как имена XML, изменяются, а исходное имя сохраняется в атрибуте <code>name</code>. Нескалярные значения, то есть вложенные словари или списки, записываются как JSON.</p>",
"<p>The name of the element wrapping all the items</p>": "<p>Имя элемента, который содержит все записи.</p>",
"<p>The name of the element wrapping every item</p>": "<p>Имя элемента, который содержит одну запись.</p>",
"<p>Pretty-print the file instead of writing it on a single line</p>": "<p>Форматирует файл для удобного чтения вместо записи всего содержимого в одну строку.</p>",
"<p>Manages pre-configured session instances.</p>": "<p>Управляет заранее настроенными экземплярами сессий.</p>",
"<p>Register a session instance.</p>": "<p>Регистрирует экземпляр сессии.</p>",
"<p>Name to reference this session in requests</p>": "<p>Имя для обращения к этой сессии в запросах.</p>",
"<p>Your pre-configured session instance</p>": "<p>Заранее настроенный экземпляр сессии.</p>",
"<p>If True, this becomes the default session</p>": "<p>При True эта сессия становится сессией по умолчанию.</p>",
"<p>If True, the session will be started only when a request uses its ID.</p>": "<p>При True сессия запускается только тогда, когда запрос использует её ID.</p>",
"<p>Removes a session.</p>": "<p>Удаляет сессию.</p>",
"<p>ID of session to remove</p>": "<p>ID сессии для удаления.</p>",
"<p>Remove and returns a session.</p>": "<p>Удаляет и возвращает сессию.</p>",
"<p>Start all sessions that aren't already alive.</p>": "<p>Запускает все сессии, которые ещё не работают.</p>",
"<p>Close all registered sessions.</p>": "<p>Закрывает все зарегистрированные сессии.</p>",
"<p>Check if a session ID is registered.</p>": "<p>Проверяет, зарегистрирован ли ID сессии.</p>",
"<p>Number of registered sessions.</p>": "<p>Число зарегистрированных сессий.</p>"
} %}
{% macro translate(value) %}
{% set result = namespace(html=value | replace("Bases:", "Базовые классы:")) %}
{% for source, target in translations.items() %}
{% set result.html = result.html | replace(source, target | safe) %}
{% endfor %}
{{ result.html | safe }}
{% endmacro %}