МессенджерыMAX

Язык поисковых запросов MAX

Все поля, операторы, пресеты и ограничения поиска сообщений MAX: правила дат, регулярные выражения и JSON-ответ для скриптов и агентов.

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

Если вы работаете с max через ИИ-агента, учить этот язык не нужно: скажите обычными словами, что ищете, и запрос составит агент. Эта страница — для тех, кто набирает поиск сам, и для тех, кому нужен каждый фильтр: точные операторы, все поля, preset, правила дат и пределы.

Это справка по запросам max personal search messages, max personal search all, max personal stats messages show, сохранённых поисков и --filter поиска по темам. Примеры на каждый день — в поиске сообщений.

Термины этой страницы:

  • Запрос — текст, который вы ищете, например счёт from:me date:7d.
  • Поле — имя с двоеточием, которое относит часть запроса к одному свойству сообщения: from: (отправитель) или date: (когда отправлено). Слова без поля ищутся в тексте сообщения.
  • Оператор — слово или знак, который соединяет условия: AND, OR, NOT.
  • Формы слова — одно слово с разными окончаниями: «квартира» и «квартиру».

Язык — строгий профиль синтаксиса Apache Lucene: слова, фразы, AND/OR/NOT, группы, поля, диапазоны, ограниченные шаблоны и регулярные выражения. «Строгий» значит, что всё неподдерживаемое — ошибка, а не молча пропущенная часть. Полная справка содержит генерируемые таблицы полей, операторов, preset и пределов и проверяемые примеры; техническая спецификация описывает грамматику и компилятор.

Почту max не ищет: это memo search mail.

Что умеет язык

НужноПишите
сообщения со всеми этими словами, в любой формесчёт оплачен
эти слова подряд, в этом порядке"счёт оплачен"
одно слово или другое, без третьего(кафе OR библиотека) NOT шумно
только эта форма словаexact:квартира, или --exact для всех слов без поля
слова, которые начинаются на что-токвартир*
отправитель, чат, вид чатаfrom:me, chat:"Книжный клуб", kind:private
периодdate:7d, date:[2026-01-01 TO 2026-02-01}
файлы по имени или размеруfilename:*.pdf, size>10MB
текст, похожий на пароль, карту или телефонpreset:secret, preset:card
ваши собственные меткиtag:work
шаблонtext:/pass(port)?/

Слова и фразы без поля ищут формы слов. --exact выбирает точные формы для слов без поля; явное text: продолжает искать формы. Какие формы совпадают, решают настройки языка архива (формы слов).

Операторы

ОператорПримерЗначение
словасчёт оплаченоба слова
фраза"счёт оплачен"слова в этом порядке
AND, &&alpha AND betaоба
OR, ||alpha OR betaлюбое
NOT, !, -alpha NOT betaпервое без второго
++alpha OR betaalpha обязательно, beta — нет
группа(alpha OR beta) gammaскобки задают порядок
группа поляfrom:(alice OR bob)поле относится к каждому значению
диапазонdate:[2026-01-01 TO 2026-02-01}[ ] включают, { } исключают, * — без границы
сравнениеsize>10MB, date>=7d, date:>=7dоткрытый диапазон; запись с двоеточием — то же самое
шаблонквартир*, т?кст* — любые символы, ? — один
regextext:/pass(port)?/ограниченное регулярное выражение Lucene

alpha OR beta gamma означает (alpha OR beta) AND gamma; alpha OR beta AND gamma — alpha OR (beta AND gamma). Для ясности ставьте скобки. and, or, not строчными — обычные слова. Запрос из одного NOT ничего не находит: добавьте положительное условие, например kind:group NOT preset:secret. Нечёткий поиск ~, близость слов, веса и интервалы дают ошибку, а не пропускаются. Опечатки не исправляются: чтобы поймать разные окончания, пишите шаблон вроде квартир*.

Поля

ПолеЧто находитПример
textслова сообщения (поле по умолчанию)text:счёт
exactточная форма слова или фразыexact:квартира, exact:"счёт оплачен"
bodyвесь исходный текст, с учётом регистраbody:/.*счёт.*/
fromотправителя: по имени, @username или id; me — выfrom:"Алиса Тестова"
chatчат: по названию, @username или idchat:"Книжный клуб"
dateкогда отправленоdate:today, date:7d, date:[2026-01-01 TO 2026-02-01}
kindвид чата: private, group, channel, saved, bot, service, unknownkind:private
hasattachment, link, file, photo, image, video, audio, voice, sticker, contact, location, pollhas:file
topicодну ветку обсуждения; нужен один чатchat:"Книжный клуб" AND topic:42
inкакие аккаунты: провайдер или botsin:bots
presetтекст, похожий на секрет или контактpreset:secret
contentсохранённый текст вложенияcontent:договор
filenameимя вложенного файла целикомfilename:*.pdf
mimeтип вложенного файла; MAX его не сообщаетmime:image
sizeразмер вложенного файла: байты или KB/MB/GB по 1024size>10MB
tagваша локальная метка на сообщении, его чате или отправителеtag:work
phoneтелефон, найденный в тексте, как бы он ни был записанphone:"+34 600 000 000"
emailадрес почты, найденный в текстеemail:"ana@example.com"
urlссылка, найденная в тексте, без параметров слеженияurl:"https://example.com/a"
domainсайт ссылки или адреса, найденных в текстеdomain:example.com
mentionsчеловек, организация или документ, к которому привязано найденное упоминаниеmentions:"person:12"

Имена полей различают регистр. Неизвестное поле, значение или сочетание — ошибка, а не пустой ответ и не обычный текст. Имя, которого нет в архиве, у MAX не спрашивается.

kind:bot выбирает чат с ботом, in:bots — архивы ботов max sales bot. topic: требует ровно одного чата в chat:: номера веток повторяются в разных чатах. filename, mime и size подходят сообщению, если подходит хотя бы один его файл. MAX не сообщает тип файла, поэтому mime: здесь ничего не находит — ищите по расширению.

Упоминания

max находит в сохранённых сообщениях телефоны, адреса почты, ссылки, документы и имена людей. Эти поля находят сообщения, в которых они есть. Сами находки показывает max personal mentions list.

max personal search messages 'phone:"+34 600 000 000"'
max personal search messages 'email:"ana@example.com" OR domain:example.com'
max personal search messages 'mentions:"person:12"'

Значение с + или @ берите в кавычки: оба знака — операторы. Телефон находится, как бы он ни был записан: +34 600 000 000 и 600000000 — один телефон, а номер без + читается по странам из настройки phone_countries. domain: считает docs.example.com сайтом example.com. В mentions: пишут ссылку на человека, организацию или документ; поле находит сообщения, чьи упоминания вы привязали к нему через max mentions confirm.

max personal mentions list --new показывает нерешённое с прошлого --new, max personal mentions domains — сайты, на которые ведут ссылки, самые частые сверху. confirm и reject с --all-in-chat решают имя сразу во всём чате.

Preset

Preset находит текст по его виду. С ним можно найти пароль, код или номер карты, который кто-то прислал.

PresetКандидат — это
passwordподпись пароля и значение после неё
codeподпись кода подтверждения и 4–8 цифр
api-keyподпись ключа API и значение
secretподпись пароля, секрета, токена или ключа API и значение
card13–19 цифр, можно с пробелами или дефисами
bankзначение вида IBAN
passportподписанный номер паспорта или российский вид 4+6 цифр
phoneмеждународный телефон с плюсом
emailадрес электронной почты
telegram-linkссылка t.me или telegram.me
urlссылка HTTP(S)
contactвложение-контакт, email или телефон
locationвложение-место или ссылка geo:

Preset сообщает кандидата по виду. Он не проверяет пароль, карту или документ и может совпасть с безобидным текстом. Не удаляйте и не пересылайте сообщения автоматически по его ответу.

Даты

--timezone принимает пояс IANA, например Europe/Madrid; без него берётся пояс компьютера, и ответ его называет. Дата без времени — весь календарный день. Включающая верхняя граница включает день целиком, исключающая — исключает; день перехода на летнее время длится 23 или 25 часов.

date:today и date:yesterday — календарные дни. date:7d — от 7 дней назад до сейчас (также 30m, 2h); date>=7d и date:[30d TO 7d} работают в сравнении и диапазоне, отсчёт — от момента запроса. Точное время пишите в кавычках, с секундами и смещением: date>="2026-01-01T10:00:00+02:00".

Слова, шаблоны и регулярные выражения

Перед индексом и поиском текст приводится к нижнему регистру и теряет ударения; ё становится е, й — и. Поэтому некоторые разные слова совпадают: мой находит и «мои». Regex и шаблоны по text: приводятся так же.

text:/счёт/ совпадает с целым словом «счёт», но не со «счётом». body:/счёт/ совпадает только с сообщением, весь текст которого — «счёт», с учётом регистра; чтобы найти где угодно, пишите body:/.*счёт.*/, а для начала предложения — body:/.*[Сс]чёт.*/. Это синтаксис регулярных выражений Lucene, без lookaround, обратных ссылок, якорей и флагов JavaScript.

На большом архиве короткий шаблон вроде к* раскрывается больше чем в 10 000 слов и отвергается — удлините его. Длинные запросы, глубокая вложенность, большие шаблоны и медленный перебор отвергаются ошибкой query_limit, а не обрезаются: сузьте чат, даты или шаблон.

Ответ

--json возвращает { items, page, next, missing, meta }, даже без совпадений. --jsonl выдаёт только сообщения, построчно.

  • missing — чего поиск не видел и почему: запись coverage, если часть чатов не скачана или отстала, text, пока индекс слов достраивается, pictures, если модель картинок не скачана.
  • next — команды, которые это исправят (messages.sync, store.migrate, models.download-image), и page.next — следующая страница с тем же запросом.
  • meta.accounts — какие аккаунты просмотрены.
  • page.has_more говорит о странице, а не о том, есть ли в MAX ещё.
  • page.total — сколько всего сообщений подходит: { "value": 144, "relation": "eq" }. eq — точное число, gte — не меньше: счёт останавливается на 10 000. В терминале то же видно как showing 1–20 of 144.

Ошибка указывает место в запросе и подсказку.

Через MCP

Когда агент ищет через MCP-сервер max, max_read (command: "search messages") принимает запрос текстом в query, а timezone — календарный пояс. chat: пишется в самом запросе; source, newest, context и limit работают как опции команды; saved запускает сохранённый поиск. thread, thread_hops, thread_messages, thread_bytes, thread_within и sync_first соответствуют опциям --thread… и --sync-first; sync_first доступен только при messages.sync-first: allow. Ответ — тот же объект, что --json. max_read (command: "stats messages show") считает по тем же запросам. record: false не записывает вызов в историю запросов.

Дальше