# Busca con eficacia (/es/docs/search-efficiently)

Tienes mucho guardado, y un agente paga por cada resultado que lee. Esta página muestra cómo obtener los registros adecuados con el menor número de pasos: elegir el comando, acotar antes de buscar, paginar los resultados y recortar la salida. Después podrás convertir una pregunta vaga en una búsqueda precisa y comprobar qué cubrió. Supone que el historial que necesitas ya está descargado: [Buscar](/llms.mdx/docs/es/search/content.md#descarga-primero-el-historial-de-los-chats-pertinentes).

## Elige el comando [#elige-el-comando]

Pon delante de cada comando el nombre de la herramienta y el de tu perfil, como en `tg personal search messages`.

| Quieres | Ejecuta | Notas |
| --- | --- | --- |
| Palabras en tus mensajes de Telegram o MAX | `search messages` en `tg` o `max` | Lee el archivo local y, por defecto, también el servidor de la mensajería |
| Un teléfono, correo, enlace o nombre de persona escritos en mensajes | `search messages` con `phone:`, `email:`, `domain:` o `mentions:`, o `mentions list` | Se encuentra por reglas, como esté escrito |
| Todo sobre una persona, en todas las mensajerías | `contacts timeline` | Necesita las identidades unidas con `contacts link` |
| Una conversación, cuando recuerdas el tema y no las palabras | `search conversations` | Necesita `conversations build` y `conversations embed` una vez para el chat |
| Una imagen por lo que muestra | `search messages "dog on a beach"` | Solo en inglés, y el ajuste de imágenes debe estar activado: [Qué se indexa](/llms.mdx/docs/es/what-is-indexed/content.md#im%C3%A1genes) |
| Correo, notas, o no sabes dónde se escribió | `memo search all`, `memo search mail`, `memo search notes` | La respuesta lista las fuentes omitidas y el motivo |
| Mensajes de todas las mensajerías a la vez | `memo search messages` | Solo mensajes |
| Una decisión o una promesa | `memo facts list` | Cada hecho enlaza con su evidencia |
| Un documento de Drive, por palabras o por significado | `drive search` | `--exact` solo para palabras |
| Un archivo de Drive, por nombre, tipo, carpeta, persona o etiqueta | `drive catalog list` o `drive catalog search` | Solo metadatos, funciona sin conexión |

## Acota primero, busca después [#acota-primero-busca-después]

Una búsqueda que nombra un chat, un remitente y un periodo lee menos registros y devuelve menos sobrantes. Añade filtros en este orden: chat, remitente, fecha, tipo, adjunto y, al final, las palabras.

| Filtro | Encuentra | Ejemplo |
| --- | --- | --- |
| `chat:` | Un chat, por nombre o id | `chat:"Book club"` |
| `from:` | Un remitente | `from:"Kai Sample"` |
| `date:` | Un periodo, o todo desde un día | `date:[2026-01-01 TO 2026-02-01}`, `date>=2026-10-01` |
| `kind:` | Chats privados, grupos, canales, bots | `kind:group` |
| `has:` | Mensajes con archivo, foto, nota de voz, enlace o texto | `has:file` |
| `filename:` | Un archivo por su nombre | `filename:*.pdf` |
| `mime:` | Un archivo por su tipo (solo Telegram) | `mime:"application/pdf"` |
| `size:` | Archivos por tamaño | `size>10MB` |
| `content:` | Palabras dentro de un archivo | `content:invoice` |
| `transcript:` | Palabras dichas en una nota de voz | `transcript:invoice` |
| `tag:` | Tus propias etiquetas | `tag:work` |
| `phone:`, `email:`, `url:`, `domain:`, `mentions:` | Un valor encontrado en el texto | `phone:"+1 555 010 0100"`, `mentions:"person:7"` |

Los nombres de campo distinguen mayúsculas y un campo desconocido da error, no una respuesta vacía. La lista completa de campos está en el lenguaje de consulta de [Telegram](/llms.mdx/docs/es/tg/query-language/content.md) y de [MAX](/llms.mdx/docs/es/max/query-language/content.md). La última fila está en las últimas versiones de `tg` y `max`.

```sh
tg personal search messages 'chat:"Book club" from:"Kai Sample" date>=2026-10-01 delivery' --limit 10
```

Cuando también se consulta el servidor de la mensajería, solo le llegan las palabras, un chat, un remitente y las fechas. `has:`, `tag:`, las negaciones y los comodines se aplican en local. Detalles: [Cómo funciona la búsqueda](/llms.mdx/docs/es/search-architecture/content.md#b%C3%BAsqueda-en-el-servidor-junto-al-archivo).

## Los operadores [#los-operadores]

| Escribe | Significado |
| --- | --- |
| `invoice paid` | Ambas palabras, en cualquier orden (AND por defecto) |
| `alpha OR beta` | Cualquiera de las palabras |
| `alpha NOT beta`, `alpha -beta` | La primera palabra sin la segunda |
| `+alpha` | La palabra debe estar |
| `(alpha OR beta) gamma` | Un grupo |
| `from:(alice OR bob)` | Un campo con varios valores |
| `date:[2026-01-01 TO 2026-02-01}` | Un rango: `[ ]` incluye el extremo, `{ }` lo excluye |
| `invo*` | Cualquier terminación |
| `text:/pass(port)?/` | Una expresión regular, comparada con palabras completas |

Tres reglas evitan la mayoría de las sorpresas:

* Una consulta que es solo una negación no selecciona nada. Acompáñala de una condición positiva: `has:photo NOT has:text`.
* Un `AND` explícito une más fuerte que `OR`. `alpha OR beta gamma` significa `(alpha OR beta) AND gamma`.
* `and`, `or` y `not` en minúsculas son palabras normales. Las erratas como `invoice~1` y los refuerzos como `invoice^2` dan error.

## Palabras, formas y significado [#palabras-formas-y-significado]

Una palabra normal encuentra sus otras formas: «invoice» encuentra «invoices». Para la forma exacta, usa `exact:invoice`. Para erratas, usa `--language legacy`. Las palabras de archivos y transcripciones solo coinciden en su forma exacta.

Usa `search conversations` cuando recuerdas de qué trataba una conversación y no con qué palabras. Pregunta con tus propias palabras, en cualquier idioma que lea el modelo. Siempre devuelve las conversaciones más cercanas, aunque ninguna responda, así que abre los mensajes antes de fiarte de una. Para un nombre, número o id exactos, usa una búsqueda por campos. Más: [Búsqueda por tema](/llms.mdx/docs/es/tg/topic-search/content.md).

## Pagina los resultados [#pagina-los-resultados]

La respuesta indica si hay más resultados (`has_more`). Eso describe la página, no si la mensajería guarda más. Repite el mismo comando con los mismos filtros y pide la página siguiente. Qué opción lo hace depende del comando:

| Comando | Página siguiente |
| --- | --- |
| `search messages` en `tg` y `max` | `--page <n>`, contando desde 1 |
| `contacts timeline` | `--cursor <cursor>`, con el cursor de `page.next` de la respuesta |
| `mentions list`, `drive catalog list`, `drive catalog search` | `--page <n>` |
| `memo search notes`, `drive search` | `--offset <n>` |
| `memo search all`, `memo search mail`, `memo search messages` | Solo `--limit`, hasta 100: acota la consulta |

## Mantén la salida corta [#mantén-la-salida-corta]

* `--limit <n>` limita los resultados.
* `--brief` muestra cada mensaje encontrado como referencia, hora, remitente y extracto. Revisa con él y luego abre un resultado.
* `--json=ref` conserva solo los campos que nombras. `--jsonl` imprime un resultado por línea. `--full` devuelve los textos completos.
* `--max-output-bytes` limita por defecto la salida automática a 4 MiB. Un resultado que supera el límite falla de forma visible en lugar de recortarse.
* `--context <n>` añade `n` mensajes vecinos a cada lado de un resultado. Vale 0 cuando la salida no es un terminal.

## Lee la evidencia y luego amplía [#lee-la-evidencia-y-luego-amplía]

Abre un resultado con sus vecinos, o sigue su cadena de respuestas:

```sh
tg personal messages context "msg:telegram/1/77/42" --before-n 3 --after-n 3
tg personal messages context "msg:telegram/1/77/42" --thread
```

Si una respuesta parece escasa, lee su entrada `missing`. Indica qué no se buscó y el paso que lo arregla, como descargar un chat. Cada resultado dice dónde coincidió (`matched_in`: `text`, `transcript`, `filename` o `file`). Para comparar la cuenta con lo que esperas, `stats messages show` (en las últimas versiones) cuenta coincidencias por chat, remitente, día u hora.

## Recetas [#recetas]

Sustituye los nombres por los tuyos.

| Objetivo | Comando |
| --- | --- |
| Un acuerdo y su fuente | `tg personal search messages 'chat:"Book club" agreed date>=2026-10-01' --limit 5` |
| Todo sobre una persona este mes | `tg personal contacts timeline "Kai Sample" --since-time 2026-10-01` |
| Dónde aparece un número de teléfono | `tg personal search messages 'phone:"+1 555 010 0100"' --brief` |
| Archivos enviados a un chat la semana pasada | `tg personal search messages 'chat:"Book club" has:file date>=2026-10-07' --brief` |
| Qué dice un documento de Drive sobre un tema | `drive personal search 'budget' --exact --limit 5` |

Para recetas más largas: [Telegram](/llms.mdx/docs/es/tg/recipes/content.md) y [MAX](/llms.mdx/docs/es/max/recipes/content.md).

## Errores habituales [#errores-habituales]

| Error | Qué pasa | Qué hacer |
| --- | --- | --- |
| Buscar antes de descargar el historial | Pocos resultados o ninguno | Descarga el chat; lee `missing` en la respuesta |
| Leer una respuesta vacía como «nunca se envió» | El archivo puede estar incompleto | Comprueba lo que la respuesta dice haber cubierto |
| Entrecomillar una frase para obtener la forma exacta | Las comillas aceptan cualquier forma de las palabras | `exact:"final invoice"` |
| `mime:application/pdf` sin comillas | La `/` inicia una expresión regular | `mime:"application/pdf"` o `filename:*.pdf` |
| `mime:` en MAX | MAX no informa del tipo de archivo | `filename:*.pdf` |
| `has:photo` para buscar lo que muestra una imagen | Solo dice que hay una foto adjunta | Búsqueda de imágenes, en inglés |
| Un campo de mensajes en una búsqueda de Drive | Drive tiene sus propios filtros | `tag:` y `--exact`, o `catalog list` |
| `From:` en lugar de `from:` | Un error | Los nombres de campo van en minúsculas |
| Preguntar en otro idioma a la búsqueda de imágenes | El modelo solo conoce el inglés | Que tu agente traduzca primero |

## Comprueba el resultado [#comprueba-el-resultado]

Abre la fuente del mejor resultado y compárala con lo que recordabas. Si un tipo de contenido nunca aparece, comprueba el único paso que necesita: [Qué se indexa](/llms.mdx/docs/es/what-is-indexed/content.md#qu%C3%A9-necesita-cada-tipo). Si falta un vínculo entre registros, consulta [Cómo se vincula todo](/llms.mdx/docs/es/how-things-are-linked/content.md#si-falta-un-v%C3%ADnculo).

Siguiente: el lenguaje de consulta de [Telegram](/llms.mdx/docs/es/tg/query-language/content.md) o de [MAX](/llms.mdx/docs/es/max/query-language/content.md) lista todos los campos, ajustes preestablecidos y formas de fecha.