Conceptos básicos#

Una referencia rápida de los términos que encontrarás en el panel y en esta documentación.

Proyecto#

Un proyecto es el contenedor principal de una tienda o sitio web. Agrupa todos los feeds y motores de búsqueda que pertenecen al mismo tenant. Lo habitual es crear un proyecto por tienda.

Feed#

Un feed es un archivo de texto plano —en formato XML o CSV— que lista tus productos y sus atributos. Tu plataforma de ecommerce suele generarlo automáticamente (por ejemplo, un export de Google Shopping). SoloSearch ejecuta una Reindexación del feed según el calendario configurado: descarga el archivo, analiza los productos y los publica en el índice de búsqueda para que puedan consultarse.

Un feed XML mínimo con un solo producto tiene esta estructura:

<?xml version="1.0" encoding="UTF-8"?>
<products>
  <product>
    <id>SKU-001</id>
    <title>Running Shoes</title>
    <price>89.99</price>
    <link>https://myshop.com/running-shoes</link>
    <image>https://myshop.com/images/shoes.jpg</image>
  </product>
</products>

Motor de búsqueda#

Un motor de búsqueda es la instancia de búsqueda configurada para un proyecto. Vincula un proyecto con un feed y define cómo funciona la búsqueda: qué campos se indexan, sus pesos relativos, sinónimos, filtros, impulsos (boosts) y qué dominios tienen permiso para usarlo. Cada proyecto puede tener más de un motor de búsqueda.

Widget#

El widget es la experiencia de búsqueda visible para los usuarios finales en tu tienda —el campo de búsqueda, el panel de resultados o el desplegable, y todo lo que el visitante ve e interactúa. El widget es cargado y controlado por el snippet.

Snippet / Etiqueta script#

El snippet es la etiqueta <script> que pegas en el HTML de tu tienda. Carga el código del widget desde SoloSearch y lo configura mediante atributos data-*. Como mínimo necesitas dos atributos: data-engine (el UUID de tu motor de búsqueda) y data-api (la URL del servidor API). El panel genera un snippet listo para usar en cada motor de búsqueda, bajo General → Snippet.

<script
  src="https://search.solosearch.app/widget.js"
  data-engine="c4b119f6-321e-4268-9d98-8d030f6dfb1a"
  data-api="https://search.solosearch.app"
  defer
></script>

Template Set#

Un template set es el diseño que se aplica al widget —el HTML y CSS que renderizan el campo de búsqueda, los resultados, los filtros y las tarjetas de producto. SoloSearch incluye de serie varios template sets listos para usar, y son totalmente personalizables: duplica uno y edítalo en el panel, en Design → Template Sets, o crea el tuyo desde cero.

Anclado o superpuesto#

Cada template set define su propio modo de renderizado:

Anclado — los resultados aparecen en línea, justo debajo del campo de búsqueda, sin cubrir el resto de la página. El usuario permanece en contexto mientras escribe.

Superpuesto — los resultados se abren en un panel sobre el contenido de la página, ya sea centrado o ocupando toda la ventana. Encaja mejor con catálogos con muchos filtros, o con una experiencia de navegación más inmersiva.

Puedes ver todos los template sets estándar —además de algunos totalmente personalizados creados para tiendas reales— en la página de Demos.

Búsqueda difusa (Fuzzy Search)#

La búsqueda difusa es la capacidad del motor de encontrar resultados aunque la consulta contenga pequeños errores tipográficos. En lugar de exigir una coincidencia exacta carácter a carácter, acepta términos cercanos a lo que se escribió.

La cercanía se mide por el número de ediciones de un solo carácter necesarias para transformar una palabra en otra: inserciones, eliminaciones, sustituciones o transposiciones. Esto se conoce como distancia de edición. Por ejemplo, "snakers" está a una edición de "sneakers" (un carácter faltante), así que el motor los trata como coincidencia.

SoloSearch aplica la búsqueda difusa automáticamente para consultas a partir de una longitud mínima. Las consultas cortas (uno o dos caracteres) usan coincidencia exacta para evitar resultados irrelevantes; las consultas más largas admiten una o dos ediciones según la longitud del término. No requiere configuración —funciona desde el primer momento.

Por eso los sinónimos para errores tipográficos pequeños suelen ser innecesarios. Los sinónimos son más útiles para términos estructuralmente distintos que comparten el mismo significado, como zapatillas y deportivas.

CORS / Orígenes permitidos#

Por seguridad, cada motor de búsqueda solo responde a peticiones que provienen de dominios que hayas autorizado explícitamente. Estos son los orígenes permitidos —habitualmente el dominio de tu tienda (p. ej. https://myshop.com).

Si el widget no carga o no devuelve resultados, comprueba que el dominio de tu tienda figure en General → Allowed Origins.