> For the complete documentation index, see [llms.txt](https://docs.luxgram.pro/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.luxgram.pro/parser.md).

# Парсер

Раздел «Парсер» нужен для поиска и сбора аудитории из Telegram. С его помощью можно либо собирать пользователей из уже известных чатов, каналов и комментариев, либо сначала находить подходящие сообщества по ключевым словам.

### Режимы работы

В модуле доступны три режима.

<figure><img src="/files/RrzHhjzRoEElkMkv8BqC" alt=""><figcaption></figcaption></figure>

| Режим                 | Как работает                                                                                    |
| --------------------- | ----------------------------------------------------------------------------------------------- |
| **Парсинг аудитории** | Собирает пользователей из указанных источников или из групп и каналов, где уже состоит аккаунт. |
| **Глобальный поиск**  | Ищет чаты и каналы в Telegram по ключевым словам и username.                                    |
| Общая база            | Общая база спарсеных каналов и чатов, которые может использовать пользователь.                  |

### Парсинг аудитории

Этот режим подходит, если вы уже знаете, откуда нужно собирать пользователей.

#### Источники для сбора

<figure><img src="/files/2kEhKIm2Hd3SYWOwAZc3" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="301.99993896484375">Настройка</th><th>Что делает</th></tr></thead><tbody><tr><td><strong>Целевые чаты / каналы</strong></td><td>Позволяет указать список ссылок на чаты, каналы или комментарии, откуда нужно собирать аудиторию.</td></tr><tr><td><strong>Использовать группы / каналы на аккаунте</strong></td><td>Вместо ручного списка ссылок сервис будет брать чаты и каналы, где уже находится выбранный аккаунт.</td></tr></tbody></table>

#### Фильтры

<figure><img src="/files/PhJXHShtwMDaDQDXV6xO" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="222.00006103515625">Настройка</th><th>Что делает</th></tr></thead><tbody><tr><td><strong>Был онлайн &#x3C; 24 часов</strong></td><td>Собирает только тех пользователей, которые недавно были активны.</td></tr><tr><td><strong>Только с фото профиля</strong></td><td>Собирает только пользователей с установленным фото.</td></tr><tr><td><strong>Только Premium</strong></td><td>Собирает только пользователей с Telegram Premium.</td></tr><tr><td><strong>Только с юзернеймом</strong></td><td>Собирает только пользователей, у которых есть @username.</td></tr></tbody></table>

#### Лимиты и задержки

<figure><img src="/files/jL6BU3D59DkGFFpXlg8f" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="238.800048828125">Настройка</th><th>Что делает</th></tr></thead><tbody><tr><td><strong>Глубина парсинга</strong></td><td>Определяет, сколько сообщений сервис просмотрит в одном чате или канале. Если указать 0, ограничение снимается.</td></tr><tr><td><strong>Лимит сбора на один чат</strong></td><td>Ограничивает максимальное количество пользователей с одного источника. Если указать 0, лимит отключается.</td></tr><tr><td><strong>Минимальная задержка</strong></td><td>Задаёт минимальную паузу между действиями сервиса.</td></tr><tr><td><strong>Максимальная задержка</strong></td><td>Задаёт максимальную паузу между действиями сервиса.</td></tr><tr><td><strong>Языковой фильтр</strong></td><td>Позволяет оставить всех пользователей, только с кириллицей или только с латиницей в имени и username.</td></tr><tr><td><strong>Стоп-слова</strong></td><td>Исключает пользователей по словам, которые вы укажете в фильтре.</td></tr></tbody></table>

### Глобальный поиск

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

#### Параметры глобального поиска

<figure><img src="/files/qnxrfSGjTszyJeZ5ENFH" alt=""><figcaption></figcaption></figure>

| Настройка                    | Что делает                                                                                                                                                                      |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Ключевое слово**           | Основное слово для поиска. Например, если добавить слово **Новости**, сервис начнёт искать группы и каналы по этому запросу.                                                    |
| **Вариации ключевого слова** | Позволяют расширить поиск. Например, если для слова **Новости** добавить вариант **Ростов**, сервис будет искать сочетания вроде **Новости Ростов**.                            |
| **Поиск по username**        | Ищет сообщества не только по названию, но и по username. Например, по слову news и варианту Moscow сервис сможет искать сочетания вроде newsMoscow, news\_Moscow, Moscow\_news. |

<figure><img src="/files/CxIvI3xzZ7s8uyCUcsmi" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/NRHXqZHoODHK2jafzv4e" alt=""><figcaption></figcaption></figure>

#### Фильтры

<figure><img src="/files/fVrZbbPc7Qr8ESruPqzE" alt=""><figcaption></figcaption></figure>

| Настройка                        | Что делает                                                          |
| -------------------------------- | ------------------------------------------------------------------- |
| **Только с возможностью писать** | Исключает чаты и каналы, где аккаунт не сможет отправить сообщение. |

#### Лимиты и задержки

<figure><img src="/files/9Vz2OfsBa7zDePa8r2yj" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="245.199951171875">Настройка</th><th>Что делает</th></tr></thead><tbody><tr><td><strong>Искать только</strong></td><td>Позволяет выбрать, где выполнять поиск: в чатах и каналах, только в каналах или только в чатах.</td></tr><tr><td><strong>Лимит чатов на одно слово</strong></td><td>Ограничивает максимальное количество найденных чатов и каналов для одного ключевого слова.</td></tr><tr><td><strong>Минимальная задержка</strong></td><td>Задаёт минимальную паузу между действиями модуля.</td></tr><tr><td><strong>Максимальная задержка</strong></td><td>Задаёт максимальную паузу между действиями модуля.</td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.luxgram.pro/parser.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.