Buscar mensajes

max messages search busca solo en el archivo local compartido, sin conectarse ni marcar mensajes como leídos.

Empieza con una palabra que recuerdes del mensaje:

max messages search "factura"

Busca mensajes ya guardados en tu ordenador. Si falta el periodo que necesitas, descarga primero el historial de ese chat siguiendo la guía del archivo. Por defecto coincide con palabras exactas: Lucene es un lenguaje para añadir frases, filtros y condiciones. Para erratas y coincidencias aproximadas, elige --language legacy. Los ejemplos siguientes añaden filtros; los campos y regex solo hacen falta para consultas más complejas.

Inicio rápidoCopy Anchor Link

max messages search 'invoice AND (kind:group OR kind:private)' --json
max messages search 'from:"Alice Synthetic" date:[2026-01-01 TO 2026-02-01}' --timezone Europe/Madrid --json
max messages search 'preset:secret kind:saved' --json
max messages search 'text:/pass(port)?/' --json
max messages search 'chat:"Работа" AND body:/.*invoice.*/' --json
max messages search 'has:file' --json

Sustituye los nombres de ejemplo por los tuyos. Las palabras y frases coinciden de forma estricta, sin correcciones automáticas ni búsqueda de fragmentos. alpha OR beta gamma significa (alpha OR beta) AND gamma; alpha OR beta AND gamma, alpha OR (beta AND gamma). Usa paréntesis para dejarlo claro.

Campos y operadoresCopy Anchor Link

Admite text/body/from/chat/date/kind/has/topic/in/preset, grupos lógicos y de valores de campo, rangos inclusivos y exclusivos, comodines limitados y regex Lucene. topic exige un único chat. kind:bot selecciona al interlocutor; in:bots, cuentas Bot API. filename/mime/size/tag aún no están disponibles; fuzzy/proximity/boost/intervals también dan error. Los campos desconocidos no se interpretan como texto.

Fechas y regexCopy Anchor Link

--timezone define la zona horaria IANA; una fecha sin hora representa un día de calendario. Un límite superior inclusivo incluye todo el día; uno exclusivo lo excluye. Por cambios de horario, un día puede no durar 24 horas. Escribe las horas exactas entre comillas, con segundos y desplazamiento UTC.

La regex de text coincide con una palabra normalizada completa; la de body, con todo el texto original, distinguiendo mayúsculas. Para buscar un fragmento en body, usa .*. Se admite un subconjunto de regex Lucene, sin lookaround/backreferences/flags de JS. Superar los límites de filas, bytes, estados del autómata, trabajo o tiempo devuelve un error explícito: reduce el alcance.

Archivo y respuesta para programasCopy Anchor Link

Una respuesta vacía no demuestra que el mensaje no exista en el mensajero. JSON informa de la versión de consulta, completitud, cobertura de cuentas y chats y estado del índice, incluso sin coincidencias. lastSyncedAt es actualmente null; la lista de chats del perfil no se considera completa. JSONL solo incluye items; usa --json para conocer la cobertura.

Si el índice de palabras no está listo, ejecuta max store migrate; completa el historial con max store fetch. Los predicados preparados encuentran candidatos, sin confirmar que las credenciales sean válidas.

Migrar desde legacyCopy Anchor Link

max messages search 'from:alice after:7d invoice -draft' --language legacy --json
max messages search --regex 'invoice\s+\d+' --json

Legacy conserva los filtros anteriores y las correcciones. --regex es un modo JS iu independiente sobre el texto completo, con worker aislado y límites; se rechaza --regex --language lucene. El contrato de una consulta guardada contiene language/version; la vista previa de migración no garantiza los mismos resultados que la búsqueda con correcciones.

Referencia completaCopy Anchor Link

La referencia del lenguaje incluye tablas de campos y operadores, Unicode y escape de caracteres, predicados preparados, límites, errores y diez recetas verificables. La especificación técnica describe la gramática fijada, AST/schema, ejemplos de referencia y compilador. El archivo explica las descargas y la completitud; los comandos enumeran los parámetros actuales.

Buscar mediante MCPCopy Anchor Link

max_messages_search usa el mismo lenguaje y servicio que messages search. La consulta incluye text o ast versionado; language elige lucene o legacy, y timezone define la zona horaria de calendario. chat admite ID o nombre de la copia local; source, newest, context y limit eligen cobertura y presentación.

La respuesta conserva query, coverage, completeness, wordsReady y corrections junto a la página habitual items/page/limit/hasMore, incluso sin coincidencias. Los metadatos describen el archivo local, no la completitud del chat remoto. El nombre y los permisos de la herramienta se conservan.