☰

Telegram Scraper (Команды меню v2.3.3 - Человекоподобные значения по умолчанию)

Собирает сообщения из Telegram, отправляет в n8n. GUI, автозапуск, случайные каналы, более человекоподобные тайминги по умолчанию.

Автор
Igor Lebedev
Установок в день
0
Всего установок
1
Оценки
0 0 0
Версия
2.3.3
Создано
03.06.2025
Обновлено
05.06.2025
Размер
54,0 КБ
Лицензия
MIT
Работает на

# telegram-web-scraper
UserScript для сбора сообщений канала Telegram и отправки в n8n или другую систему
# Telegram Web Scraper UserScript

UserScript для сбора сообщений из указанных каналов Telegram (при просмотре в web.telegram.org) и отправки их в настроенный веб-хук n8n.

## Функции

* Собирает сообщения из текущего активного канала или предопределенного списка каналов.
* Графический пользовательский интерфейс (GUI) для легкой настройки параметров, работающий на базе GM_config.
* Фильтрует сообщения по максимальному возрасту, чтобы избежать обработки очень старых данных.
* Автоматически переходит между каналами в режиме многоканального сбора.
* Включает случайные задержки для лучшей имитации шаблонов просмотра человеком.
* Управление с помощью команд меню Tampermonkey/Violentmonkey.
* Двуязычные комментарии (английский/русский) в коде скрипта.

## Установка

1. **Установите UserScript Manager**:
* [Tampermonkey](https://www.tampermonkey.net/) (рекомендуется для Chrome, Edge, Safari, Opera, Firefox)
* [Violentmonkey](https://violentmonkey.github.io/) (рекомендуется для Firefox, Chrome, Edge, Opera)
* Или любой другой UserScript Manager, поддерживающий директивы `@require` и `@grant`.

2. **Установите скрипт**:
* **Нажмите здесь, чтобы установить**: [https://github.com/LebedevIV/telegram-web-scraper/raw/refs/heads/main/telegram-scraper.user.js](https://github.com/LebedevIV/telegram-web-scraper/raw/refs/heads/main/telegram-scraper.user.js)
* (Замените `ВАШ_НИКНЕЙМ_GITHUB` и `ИМЯ_ВАШЕГО_РЕПОЗИТОРИЯ` на ваше фактическое имя пользователя GitHub и имя репозитория. Также убедитесь, что `main` — это имя вашей ветки по умолчанию; для старых репозиториев это может быть `master`.)
* Или перейдите к файлу `telegram-scraper.user.js` в этом репозитории, нажмите кнопку «Raw», и ваш менеджер UserScript должен предложить вам установить его.

## Конфигурация

После установки откройте Telegram Web (например, web.telegram.org/k/). Настройки скрипта можно открыть с помощью значка менеджера UserScript в браузере:

* Щелкните значок Tampermonkey/Violentmonkey.
* Найдите "Telegram Scraper (Menu Commands vX.X.X)" в списке активных скриптов.
* Выберите "Настройки скрипта... / Настройки скрипта..." в его выпадающем меню.

Ключевые настройки включают:
* **URL-адрес веб-перехватчика N8N**: URL-адрес вашего веб-перехватчика n8n, который будет получать собранные данные.
* **Максимальный возраст сообщения (часов)**: Сообщения старше этого будут игнорироваться.
* Различные параметры времени и попыток для сбора и навигации.

Значения по умолчанию и требования к перезагрузке указаны рядом с каждым параметром в графическом интерфейсе.

## Использование

Скрипт добавляет команды в меню вашего менеджера UserScript для вкладки Telegram Web:

* **Scrape Current Channel / Собрать с текущего канала**: начинает сбор сообщений с канала, открытого в данный момент в Telegram Web.
* **Scrape All Listed Channels / Собрать со всех каналов**: выполняет итерации по списку `TARGET_CHANNELS_DATA`, определенному в скрипте, собирая каждый из них.
* **Stop All Scraping / Остановить всё**: немедленно останавливает все активные процессы сбора.
* **Настройки скрипта... / Script Settings...**: открывает графический интерфейс конфигурации.

Ход сбора и журналы выводятся в консоль разработчика браузера (F12).

## Зависимости

* **GM_config.js**: эта библиотека загружается через директиву `@require` из `openuserjs.org` для предоставления графического интерфейса настроек.
* **n8n Webhook**: Вам нужен активный экземпляр n8n с рабочим процессом webhook, готовый получать данные JSON через запросы POST.

## Устранение неполадок

* **Скрипт не запущен**: Убедитесь, что Tampermonkey/Violentmonkey включены, а скрипт активен для `web.telegram.org`. Проверьте консоль браузера на наличие ошибок.
* **Настройки GUI не отображаются**: Проверьте консоль на наличие ошибок, связанных с `GM_config.js`. URL-адрес `@require` может быть временно недоступен, или может возникнуть конфликт.
* **Данные не достигают n8n**:
* Проверьте, что "N8N Webhook URL" в настройках скрипта указан правильно и доступен из вашего браузера.
* Проверьте рабочий процесс n8n на наличие ошибок и убедитесь, что он активен.
* Найдите ошибки `GM_xmlhttpRequest` в консоли браузера.

## Лицензия

Этот проект лицензирован по [Лицензии MIT](LICENSE).

长期地址
遇到问题？请前往 GitHub 提 Issues。