# search

Busca en la memoria autorizada cuando no se conoce de antemano la redacción o el registro relevante.

- Canonical: https://docs.xmemo.dev/es/docs/tools/search
- Locale: es-ES
- Content-Locale: es-ES
- Canonical-Content-Digest: e4c087a8f0e12c7c67bbf556d6d2f73b0e61a736a9b8686e77e1b181a14238a7
- Edition-Digest: 6c01ce9196539ef5c00956b56e98b3c17e0f8c1b9c5ad5622dc387d101818beb
- Source-Revision: sha256:0f9b76db3972abc862d49a83f61e83eed6529dc4507a3c290949f892dcaa48f9

## Tool Reference: `search_memory`

### Purpose

Busca memorias XMemo autorizadas con coincidencias estrictamente dirigidas, para que las coincidencias débiles no se traten silenciosamente como respuesta.

### Parameters

- `query` (string, required): Tema o redacción exactos que se deben comparar.
- `limit` (integer, optional, default: 5): Cantidad de resultados.
- `path_filter` (string, optional, default: %): Solo en el perfil del plugin de Claude: filtro ILIKE de path lógico. No se acepta en el perfil público genérico.
- `memory_type` (string, optional, default: %): Solo en el perfil del plugin de Claude: filtro de tipo de memoria. No se acepta en el perfil público genérico.
- `prefer_working` (boolean, optional, default: false): Solo en el perfil del plugin de Claude: coloca el estado de trabajo activo antes de los resultados vectoriales.

### Returns

Respuesta de texto ordenada con referencias opacas, ubicaciones, contenido y metadatos opcionales de explicación o límite del agente. El resultado sigue limitado a las memorias autorizadas.

### Errors

- 401/403: falta memory:read o no se puede acceder al scope/equipo seleccionado.
- Error de validación: query, limit, patrón de path o tipo de memoria no es válido.
- Respuesta sin coincidencias: ningún resultado sólido satisface los filtros objetivo y autorizados; el llamador no debe sustituir silenciosamente la semántica de recall.

### Examples

#### Búsqueda estricta con alcance de proyecto



```typescript
search_memory({
  query: "token identity fallback",
  limit: 5
})
```

### Related Tools

- [recall](/docs/tools/recall): Usa recuperación flexible de mejor esfuerzo cuando no sea necesaria una coincidencia estricta.
- [recall_context](/docs/tools/recall-context): Usa recuperación acotada de varias memorias para el contexto de un prompt.
- [forget](/docs/tools/forget): Elimina un registro exacto solo después de revisar la referencia devuelta.

## Acota una búsqueda con demasiados resultados

Añade los filtros de alcance y path antes de aumentar el límite; un límite más amplio en una consulta sin alcance devuelve más ruido, no más señal.

```ts
search_memory({
  query: "token identity fallback",
  limit: 5
})
```