tgs search calendar#
Получение результатов поиска сообщений, сгруппированных по дате, для одного или нескольких чатов и типа фильтра.
Использование#
tgs search calendar [flags]Команда не принимает позиционных аргументов.
Флаги#
| Флаг | Сокр. | Тип | По умолчанию | Описание |
|---|---|---|---|---|
--chat | -c | string | Чат для запроса (username, телефон или ID). Обязателен, если не задан --folder. | |
--folder | string | "" | Запросить все чаты в этой папке (id или имя); вывод включает массивы по каждому чату и агрегированные итоги | |
--filter | string | Фильтр по типу сообщения (см. допустимые значения). Обязательный. | ||
--max-wait | int | 60 | Максимум секунд ожидания при FLOOD_WAIT | |
--no-cache | bool | false | Отключить кеш разрешения пиров | |
--profile | -p | string | Имя профиля аккаунта |
Порядок определения профиля, если --profile не указан: переменная TGS_PROFILE -> файл .tgs.yaml -> "default".
Примеры#
Календарь фотографий в канале:
tgs search calendar -c @travel_photos --filter photoКалендарь документов в группе:
tgs search calendar -c @dev_team --filter documentКалендарь фотографий по всем чатам в папке:
tgs search calendar --folder Work --filter photoВывод#
Возвращает JSON с массивом записей по датам и общим количеством total.
JSON (по умолчанию, один чат):
{
"periods": [
{"date": "2026-05-12", "count": 2, "min_msg_id": 510, "max_msg_id": 511},
{"date": "2026-05-10", "count": 1, "min_msg_id": 508, "max_msg_id": 508},
{"date": "2025-12-23", "count": 1, "min_msg_id": 466, "max_msg_id": 466}
],
"total": 98
}JSON (с --folder, несколько чатов):
При использовании --folder вывод содержит массивы по каждому чату и агрегированные итоги:
{
"chats": [
{
"chat": {"id": -1001006503122, "type": "channel", "title": "Dev News"},
"periods": [
{"date": "2026-05-12", "count": 1, "min_msg_id": 510, "max_msg_id": 510}
],
"total": 1
},
{
"chat": {"id": -1001009876543, "type": "supergroup", "title": "Team"},
"periods": [
{"date": "2026-05-12", "count": 1, "min_msg_id": 200, "max_msg_id": 200},
{"date": "2026-05-10", "count": 1, "min_msg_id": 198, "max_msg_id": 198}
],
"total": 2
}
],
"totals": [
{"date": "2026-05-12", "count": 2},
{"date": "2026-05-10", "count": 1}
],
"total": 3
}Текст (--output text):
2026-05-12 2
2026-05-10 1
2025-12-23 1
total: 98Каждая запись охватывает сообщения за указанную дату (UTC). min_msg_id и max_msg_id позволяют достать конкретные сообщения через tgs search messages --cursor или любой сторонний инструмент, принимающий диапазон ID.