MensajeríaMAX

Lenguaje de consulta de búsqueda de MAX

Todos los campos, operadores, presets y límites de la búsqueda de mensajes de MAX, con reglas de fechas, expresiones regulares y la respuesta JSON para scripts y agentes.

Esta referencia explica la sintaxis de búsqueda. Podrás combinar palabras, personas, chats, fechas y archivos, comprobar consultas e interpretar resultados.

Si trabaja con max a través de un agente de IA, no necesita aprender este idioma: diga con palabras comunes lo que está buscando y el agente creará la solicitud. Esta página es para quienes escriben la búsqueda ellos mismos y para quienes necesitan todos los filtros: operadores exactos, todos los campos, ajustes preestablecidos, reglas de fecha y límites.

Esta es una ayuda para las consultas max personal search messages, max personal search all, max personal stats messages show, búsquedas guardadas y --filter búsqueda por tema. Ejemplos para todos los días: en búsqueda de mensajes.

Términos de esta página:

  • Consulta: texto de búsqueda, como счёт from:me date:7d.
  • Campo: nombre con dos puntos que filtra una propiedad: from: (remitente), date: (fecha). Las palabras sin campo buscan en el texto del mensaje.
  • Operador: palabra o signo que combina condiciones: AND, OR, NOT.
  • Formas de palabra: distintas terminaciones, como «casa» y «casas».

Idioma: un perfil estricto de la sintaxis de Apache Lucene: palabras, frases, Y/O/NO, grupos, campos, rangos, patrones limitados y expresiones regulares. "Estricto" significa que cualquier cosa que no sea compatible es un error, no una parte que se omite silenciosamente. La ayuda completa contiene tablas generadas de campos, operadores, ajustes preestablecidos y límites y ejemplos verificables; La especificación técnica describe la gramática y el compilador.

max no busca en el correo: para eso está memo search mail.

Qué puede hacer el idioma

NecesitoEscribir
mensajes con todas estas palabras, en cualquier formaсчёт оплачен
estas palabras seguidas, en este orden"счёт оплачен"
una palabra u otra, sin tercera(кафе OR библиотека) NOT шумно
solo esta forma de la palabraexact:квартира o --exact para todas las palabras sin campo
palabras que empiezan con algoквартир*
remitente, chat, tipo de chatfrom:me, chat:"Книжный клуб", kind:private
períododate:7d, date:[2026-01-01 TO 2026-02-01}
archivos por nombre o tamañofilename:*.pdf, size>10MB
texto similar a una contraseña, tarjeta o teléfonopreset:secret, preset:card
tus propias etiquetastag:work
muestratext:/pass(port)?/

Las palabras y frases sin campo buscan distintas formas de palabra. --exact selecciona formas exactas para las palabras sin campo; text: explícito sigue buscando formas. Las coincidencias dependen del idioma configurado en el archivo (formas de palabra).

Operadores

OperadorEjemploSignificado
palabrasсчёт оплаченlas dos palabras
frase"счёт оплачен"las palabras en este orden
AND, &&alpha AND betalas dos
OR, ||alpha OR betacualquiera de las dos
NOT, !, -alpha NOT betala primera sin la segunda
++alpha OR betaalpha obligatoria, beta opcional
grupo(alpha OR beta) gammalos paréntesis fijan el orden
grupo de campofrom:(alice OR bob)el campo se aplica a cada valor
intervalodate:[2026-01-01 TO 2026-02-01}[ ] incluyen, { } excluyen, * abierto
comparaciónsize>10MB, date>=7d, date:>=7dun intervalo abierto; la forma con dos puntos significa lo mismo
comodínквартир*, т?кст* cualquier número de caracteres, ? uno
expresión regulartext:/pass(port)?/una expresión regular de Lucene con límites

alpha OR beta gamma significa (alpha OR beta) AND gamma; alpha OR beta AND gamma - alpha OR (beta AND gamma). Utilice paréntesis para mayor claridad. and, or, not en minúsculas: palabras comunes. La consulta desde un NOT no encuentra nada: agregue una condición positiva, por ejemplo kind:group NOT preset:secret. La búsqueda difusa ~, la proximidad de palabras, los pesos y los intervalos dan un error en lugar de omitirse. Los errores tipográficos no se pueden corregir: para captar diferentes finales, escriba un patrón como квартир*.

Campos

CampoEncuentraEjemplo
textpalabras del mensaje (campo predeterminado)text:счёт
exactForma exacta de una palabra o fraseexact:квартира, exact:"счёт оплачен"
bodytodo el texto original, distinguiendo mayúsculasbody:/.*счёт.*/
fromremitente por nombre, @username o id; me eres túfrom:"Алиса Тестова"
chatchat por título, @username o idchat:"Книжный клуб"
datecuándo se enviódate:today, date:7d, date:[2026-01-01 TO 2026-02-01}
kindtipo de chat: private, group, channel, saved, bot, service, unknownkind:private
hasattachment, link, file, photo, image, video, audio, voice, sticker, contact, location, pollhas:file
topicun hilo de conversación; requiere un chatchat:"Книжный клуб" AND topic:42
inqué cuentas: proveedor o botsin:bots
presettexto parecido a un secreto o contactopreset:secret
contenttexto guardado del adjuntocontent:договор
filenamenombre completo del archivo adjuntofilename:*.pdf
mimetipo del adjunto; MAX no lo indicamime:image
sizetamaño en bytes o KB/MB/GB de 1024size>10MB
tagtu etiqueta local en el mensaje, su chat o su remitentetag:work
phoneteléfono encontrado en el texto, como sea que esté escritophone:"+34 600 000 000"
emaildirección de correo encontrada en el textoemail:"ana@example.com"
urlenlace encontrado en el texto, sin parámetros de seguimientourl:"https://example.com/a"
domainsitio de un enlace o de una dirección encontrados en el textodomain:example.com
mentionspersona, organización o documento a los que está vinculada la mención encontradamentions:"person:12"

Los nombres de campo distinguen mayúsculas. Un campo, valor o combinación desconocidos son un error, nunca una respuesta vacía ni texto normal. Un nombre que el archivo local no conoce no se busca en MAX.

kind:bot selecciona un chat con un bot; in:bots selecciona los archivos de max sales bot. topic: requiere exactamente un chat en chat:: los números de tema se repiten entre chats. filename, mime y size coinciden con un mensaje si coincide al menos uno de sus archivos. MAX no indica los tipos de archivo, así que mime: no encuentra nada aquí: busca por extensión.

Menciones

max encuentra en los mensajes guardados teléfonos, direcciones de correo, enlaces, documentos y nombres de personas. Estos campos buscan los mensajes que los contienen. Los hallazgos en sí los muestra 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"'

Pon entre comillas el valor con + o @: ambos signos son operadores. Un teléfono se encuentra como sea que esté escrito: +34 600 000 000 y 600000000 son el mismo teléfono, y un número sin + se lee según los países del ajuste phone_countries. domain: considera docs.example.com como el sitio example.com. En mentions: se escribe una referencia a una persona, organización o documento; el campo encuentra los mensajes cuyas menciones vinculaste a ella con max mentions confirm.

max personal mentions list --new muestra lo pendiente desde el último --new, y max personal mentions domains, los sitios a los que llevan los enlaces, los más frecuentes primero. confirm y reject con --all-in-chat resuelven un nombre en todo el chat a la vez.

Filtros preparados

Preset busca texto según su tipo. Con él podrás encontrar una contraseña, código o número de tarjeta que alguien envió.

FiltroUn candidato es
passworduna etiqueta de contraseña seguida de un valor
codeuna etiqueta de código de verificación y de 4 a 8 cifras
api-keyuna etiqueta de clave de API y un valor
secretuna etiqueta de contraseña, secreto, token o clave de API y un valor
cardde 13 a 19 cifras, con espacios o guiones opcionales
bankun valor con forma de IBAN
passportun valor de pasaporte con etiqueta o la forma rusa de 4+6 cifras
phoneun teléfono internacional con prefijo +
emailuna forma de dirección de correo electrónico
telegram-linkun enlace t.me o telegram.me
urlun enlace HTTP(S)
contactun contacto adjunto, o un correo electrónico o un teléfono
locationuna ubicación adjunta o un enlace geo:

Un filtro preparado señala un candidato por su forma. No verifica una contraseña, una tarjeta ni un documento, y puede coincidir con algo inofensivo. No borres ni reenvíes mensajes de forma automática solo por su resultado.

Fechas

--timezone acepta una zona IANA como Europe/Madrid; sin ella se usa la zona del comando, que se devuelve en la respuesta. Una fecha sin hora es un día natural completo. Un límite superior inclusivo incluye todo ese día; uno exclusivo lo excluye; un día con cambio de hora puede durar 23 o 25 horas.

date:today y date:yesterday son días naturales. date:7d significa desde hace 7 días hasta ahora (también 30m, 2h); date>=7d y date:[30d TO 7d} funcionan en comparaciones e intervalos, contados desde el momento en que se ejecuta la consulta. Una hora exacta va entre comillas, con segundos y desplazamiento horario: date>="2026-01-01T10:00:00+02:00".

Palabras, comodines y expresiones regulares

Antes de indexarlo y buscarlo, el texto se convierte a minúsculas y pierde los acentos; ё pasa a е, y й a и. Por eso coinciden algunas palabras distintas: мой también encuentra «мои». Las expresiones regulares y los comodines de text: se normalizan igual.

text:/счёт/ coincide con la palabra completa «счёт», pero no con «счётом». body:/счёт/ coincide solo con un mensaje cuyo texto completo es «счёт», distinguiendo mayúsculas; para encontrarla en cualquier posición, usa body:/.*счёт.*/, y para el comienzo de una frase, body:/.*[Сс]чёт.*/. Es la sintaxis de expresiones regulares de Lucene, sin lookaround, referencias inversas, anclas ni indicadores de JavaScript.

En un archivo grande, un prefijo corto como к* puede abarcar más de 10 000 palabras y se rechaza; alárgalo. Las consultas largas, el anidamiento profundo, los patrones grandes y los recorridos lentos se rechazan con query_limit, no se recortan: limita el chat, las fechas o el patrón.

La respuesta

--json devuelve { items, page, next, missing, meta }, aunque no haya coincidencias. --jsonl emite solo los mensajes, uno por línea.

  • missing: lo que la búsqueda no vio y por qué: una entrada coverage si parte de los chats no se descargó o está atrasada, text mientras se construye el índice de palabras, pictures si el modelo de imágenes no está descargado.
  • next: los comandos que lo corrigen (messages.sync, store.migrate, models.download-image) y page.next, la página siguiente con la misma consulta.
  • meta.accounts: en qué cuentas se buscó.
  • page.has_more se refiere a la página, no a si MAX tiene más.
  • page.total es cuántos mensajes coinciden en total: { "value": 144, "relation": "eq" }. eq es un número exacto, gte significa «como mínimo»: el conteo se detiene en 10 000. En la terminal se ve lo mismo como showing 1–20 of 144.

Un error incluye la posición del problema en la consulta y una pista.

A través de MCP

Mediante MCP, max_read (command: "search messages") acepta la consulta como texto en query; timezone elige la zona del calendario. chat: se escribe en la propia consulta; source, newest, context y limit corresponden a las opciones del comando. saved ejecuta una búsqueda guardada. thread, thread_hops, thread_messages, thread_bytes, thread_within y sync_first corresponden a --thread… y --sync-first; sync_first requiere messages.sync-first: allow. Devuelve el mismo objeto que --json. max_read (command: "stats messages show") cuenta las mismas consultas. record: false evita registrar la llamada en el historial.

Más