Torrents Search Bot: Руководство пользователя / User guide

Это подробное руководство по использованию Telegram-бота, с помощью которого вы можете искать magnet-ссылки и торрент-файлы.

• Команда (command): слово, начинающееся со слэша (/), для взаимодействия с Telegram-ботом. Команды пишут первым словом в сообщении.
  Примеры команд: /help, /start. Полный список команд в боте.

Содержание

1. Начало: поиск
2. Если не нашлось
3. Сортировка результатов
4. Фильтры по размеру
   1. Свободный выбор фильтра
   2. Преднастроенные фильтры
5. Фильтры по трекерам
   1. Ключевые слова
   2. Пресеты трекеров
6. Настройки просмотра
   1. Количество результатов
   2. Краткий формат
   3. Формат карточки раздачи
   4. Направление просмотра
   5. Просмотр настроек
7. Поиск по категориям
8. Поиск по infohash
9. Топы раздач
10. Дополнительно
    1. Фильтры по времени
    2. Peer's online status
    3. Статистика бота
    4. Комментарии
    5. Личные закладки
    6. Поиск на сайте
    7. Повторные запросы
    8. Оценки и реакции
    9. Отслеживание (tracking) раздачи
    10. Подписка на новые результаты поиска
11. Уведомления и подписки
12. Local tracker
13. Feedback
14. Разблокировка

1. Как искать

Предположим, вы хотите найти книгу. Тогда вы можете написать боту обычное сообщение с поисковым запросом (например эксмо книги). В ответ бот вам пришлёт сообщение с результатами поиска:

Результаты поиска в виде: имя трекера, название раздачи, категория, размер, дата последнего обновления, сидов, и подсвеченная команда для получения сообщения с magnet-ссылкой для скачивания (скачать). Так как размер сообщения Telegram ограничен, да и результатов поиска может быть очень много, за один раз выдаётся ограниченное количество раздач (по-умолчанию 10, но можно настроить это от 1 до 15). В нашем примере нашлось тоже много раздач, и переход к следующим раздачам внизу сообщения по команде с префиксом /s_:

Если на неё нажать, попадём дальше:

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

Вернёмся и попробуем открыть вторую ссылку:

Это сообщение назвается карточкой раздачи, потому что на ней представлена как сама magnet-ссылка в нескольких формах и дополнительная информация о раздаче и ссылки.

Далее непосредственно magnet-ссылки: как текст, копирующийся при нажатии (клике), так и ссылка для открытия в вашем Bittorrent-клиенте.

к содержанию ➔

2. Если не получилось найти

Бывает такое, что найти раздачи не получается:

В этом случае бот предложит вам подсказки:

• Сокращение: если какие-нибудь слова из вашего запроса есть в индексе. Команда с префиксом /qhs_ быстро отправит боту сокращённый запрос.
• Исправление опечаток: если есть подозрение, что в запросе присутствуют опечатки.
• Похожие запросы: из истории запросов. Если в ней есть похожие запросы с найденными раздачами, будет предложено поискать по ним.

к содержанию ➔

3. Сортировка результатов

По-умолчанию результаты поиска отсортированы по убыванию популярности. Вы можете изменить это, открыв настройки бота /settings:

• /sort_by_downloads: по убыванию загрузок с трекера.
• /sort_by_seeders: по убыванию количества сидов.
• /sort_by_size: по убыванию размера раздачи.
• /sort_by_size_asc: по возрастанию размера.
• /sort_by_date: по убыванию дате создания/обновления
• /sort_by_lex: по алфавиту (в лексикографическом порядке)

Так вы задаёте сортировку для последующих поисков в боте:

к содержанию ➔

4*. Фильтры результатов поиска

4.1 Свободный выбор фильтра

Информация раздела устарела и была удалена.

к содержанию ➔

4.2 Преднастроенные фильтры

Информация раздела устарела и была удалена.

к содержанию ➔

5. Фильтры по трекерам

5.1 Ключевые слова в запросе

По умолчанию поиск производится сразу по всем доступным трекерам. Для того, чтобы ограничить поиск желательными/нежелательными трекерами, в поисковый запрос можно добавлять специальные ключевые слова.

В боте: /trackers:

Как это использовать?

Пример 1: если вам нужен поиск только по rutracker.org и rutor.info, вы добавляете в запрос соответствующие этим трекерам ключевые слова (rutracker и rutor соответственно, из таблицы):

В заголовке ответа появится уточнение, что результаты взяты только из соответствующих трекеров.

Пример 2: если вам нужно исключить из поиска rutracker.org и rutor.info, вы добавляете в запрос соответствующие этим трекерам ключевые слова со знаком минус (-rutracker и -rutor):

В таком случае вы увидите в заголовке перечень оставшихся для поиска трекеров.

к содержанию ➔

5.2 Пресеты трекеров

Для того, чтобы каждый раз в запросе не указывать дополнительные ключевые слова, можно настроить список трекеров, по которым будет производиться поиск. Для этого с помощью команды /trackers_preset удалите или добавьте ненужные/нужные вам трекеры:

Удалить все трекеры не получится — ведь тогда поиск не имеет смысла. В случае, если вы удалите все трекеры, произойдёт сброс к дефолтному поведению: все трекеры снова станут доступны для поиска.

Текущий статус трекера (вкл ✅/выкл ❌) можно увидеть тут же. Для сброса настроек трекеров (к настройкам по-умолчанию) используйте /trackers_reset.

Вы можете посмотреть ваш список трекеров в более компактном виде с помощью /my_trackers:

к содержанию ➔

6. Настройки просмотра

Все нижепечисленные настройки находятся в /settings. C помощью них вы можете регулировать вид поисковой выдачи и карточки раздачи.

6.1 Количество результатов поиска

C помощью команды /rows можно сказать боту, сколько раздач отображать в результатах поиска за один раз (без необходимости перехода сглубь). Для этого напишите боту сообщение вида /rows N, где N от 1 до 15 включительно (по-умолчанию 10). Например, чтобы показывать по 2 результата, напишите /rows 2:

к содержанию ➔

6.2 Краткий формат результатов поиска

Воспользовавшись /less, вы установите краткий вариант:

Сравните:

/more: установить расширенный режим отображения результатов (по-умолчанию).

к содержанию ➔

6.3 Формат карточки раздачи

Сообщение с magnet-ссылкой имеет несколько возможных форматов (/settings):

• /magnet_view_only — magnet как текст
• /magnet_view_click — кликабельная magnet
• /magnet_view_short — сокращённый (по-умолчанию)
• /magnet_view_wide — расширенный

По-умолчанию применяется сокращенный вариант. Ниже показаны различия между всем этими вариантами отображения. При выборе какого-либо из них для всех последующих страниц будет применяться выбранный режим отображения (т.е. достаточно один раз установить нужную вам опцию).

6.3.1 /magnet_view_only: только magnet-ссылка

Попробуем выбрать эту опцию и открыть какую-нибудь раздачу из результатов поиска:

6.3.2 /magnet_view_click: кликабельная magnet-ссылка

К тексту ссылки также добавлено перенаправление по клику в ваш Bittorrent-клиент:

6.3.3 /magnet_view_short: сокращенный

Это вариант по-умолчанию:

6.3.4 /magnet_view_wide: расширенный

к содержанию ➔

6.4 Направление просмотра

При просмотре с мобильных устройств часто вы получаете результаты поиска длинным сообщением, и чтобы увидеть верхние позиции, нужно проматывать наверх. Данные настройки могут установить вам обратный порядок строк в поисковой выдаче, чтобы при получении сообщения у вас перед глазами сразу были варианты первых позиций, и промотка наверх позволяла бы спускаться глубь по результатам.

Для этого используйте команду /dir_i:

Прямой порядок строк можно с помощью /dir_r:

По-умолчанию используется прямой порядок.

к содержанию ➔

6.5 Просмотр действующих настроек

Для просмотра своих настроек используйте команду /my_settings:

к содержанию ➔

7. Поиск по категориям

Информация этого раздела устарела и была удалена.

к содержанию ➔

8. Поиск по infohash

Если вы заранее знаете infohash (обратный поиск), используйте команду /h, указав после неё сам infohash:

к содержанию ➔

9. Топы раздач

(/top_list) за всё время, за последний месяц, неделю и день:

При переходе результаты выглядят также, как и для обычного поиска.

Примеры:

Топ раздач по рейтингу формируется на основе того, оценивалась ли раздача или нет. В расширенном и сокращенном вариантах у вас появляется ссылка «помогите нам совершенствовать поиск» /g_*, нажатия по ней приводят к увеличению рейтинга раздачи (для одного пользователя учитывается только одно нажатие для данной раздачи):

Топ запросов пользователей — это статистика по ключевым словам, которые писали для поиска раздач. В формировании статистики участвуют только запросы, которые были отправлены 3-мя и более пользователями:

к содержанию ➔

10. Дополнительные возможности

10.1 Фильтры по времени

Информация этого раздела устарела и была удалена.

к содержанию ➔

10.2 Online peer's status

Информация этого раздела устарела и была удалена. Теперь мы сразу показываем идентификатор доступности раздачи 🍀 если наш робот недавно успешно скачал её метаданные из торрент-сети.

к содержанию ➔

10.3 Статистика

Информация этого раздела устарела и была удалена.

к содержанию ➔

10.4 Комментарии к раздачам [УСТАРЕЛО!]

Информация этого раздела устарела и была удалена.

к содержанию ➔

10.5 Личные закладки

Для вашего удобства все команды, дающие доступ к каким-либо личным настройкам, параметрам и подобному, размещены на страничке /my:

/my_marks показывает ваши закладки (в виде обычной выдачи) в порядке добавления от последних к ранним:

В закладки раздача попадает, если вы отметили её как удачный результат поиска (в карточке команда /g_*).

к содержанию ➔

10.6 Поиск через WEB

Вы можете использовать открытый поисковый раздел нашего сайта без каких-либо ограничений и регистрации.

к содержанию ➔

10.7 Повторные запросы

Для некоторых случаев, чтобы было удобнее работать с поиском в боте, предусмотрена команда /last_query — повторить и модифицировать последний запрос поиска. Например, вы искали Inception, потом вспомнили, что нужно только с оригинальной дорожкой, и набираете: /last_query original:

В результате этот запрос будет уже Inception original. Другими словами, /last_query заменяется предыдущим запросом, к которому присоединяются остальные слова, если они есть.

Для /last_query есть короткий синоним (алиас): /lq.

к содержанию ➔

10.8 Оценка пользователем результатов поиска, реакции

В карточках раздачи вида *_wide и *_short есть возможность влиять на скрытый рейтинг раздач, а также на дальнейшие результаты поиска для всех пользователей. Это "like" 👍 / "dislike" 👎🏿:

При выборе Like 👍 раздаче увеличивается скрытый рейтинг, а также эту раздачу вы сможете найти далее у себя в закладках/my_marks.

При выборе Dislike 👎🏿 у раздачи скрытый рейтинг уменьшается, вплоть до вероятного исключения из всех результатов выдачи при достижении определенного порога. Если ранее эта же раздача вами была добавлена в закладки, она не удаляется из них.

Вы можете изменить своё мнение о раздаче, найдя ещё раз карточку этой же раздачи и переголосовав.

к содержанию ➔

10.9 Отслеживание (tracking) раздачи

В карточках раздачи вида *_wide и *_short есть возможность подписаться на дальнейшие изменения magnet-ссылки на данную раздачу:

"Подписаться на обновления раздачи" и ссылка с префиксом /us_ — это оно. При её нажатии вы получите в ответ сообщение об успешной подписке:

Как только в базах данных проекта обновится magnet-ссылка, связанная с данной раздачей, вы получите специальное сообщение:

Для управления всеми такими подписками используйте команду /my_tracking:

к содержанию ➔

10.10 Подписка на новые результаты поиска

Вы можете подписаться на новые раздачи в результатах поиска по произвольному запросу. Для этого просто отправьте боту сообщение с этим запросом, написав вначале команду /sub:

Управление подписками через команду /my_sub:

Когда при обновлении индекса будут найдены новые раздачи, которые подходят к вашему поисковому запросу, вы получите такое уведомление:

По ссылке из сообщения вида /upd_ можно посмотреть содержание обновления. Там будут перечислены раздачи по аналогии с обычной поисковой выдачей:

к содержанию ➔

11. Уведомления и подписки

Наша политика — открытый и свободный доступ к контенту и чистота внимания.

Мы не занимаемся массовыми рассылками, бот присылает вам сообщения только в ответ на ваши действия.

Информирование посредством рассылки происходит в исключительных случаях и охватывает узкий круг лиц.

к содержанию ➔

12. Local tracker

Информация этого раздела устарела и была удалена.

к содержанию ➔

13. Feedback / обратная связь

Все способы связи указаны здесь.

Вы можете написать сообщение напрямую разработчикам с помощью команды /f:

к содержанию ➔

14. Инструкция по разблокировке ботов

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

Иногда боты в Telegram становятся недоступны для обмена сообщениями, но есть способ заставить их снова работать. Для этого вам нужно

1. Создать приватную группу и добавить туда бота
2. Открыть доступ к истории сообщений
3. Добавить бота в администраторы группы

После этого у вас должно получиться такое состояние группы (красным отмечены критические настройки): В списке участников бот должен выглядеть так (звёздочка администратора + "имеет доступ к сообщениям"):