Algolia DocSearch
Buscador gratuito alojado para documentación open source, basado en un crawler de Algolia y un widget JavaScript de autocompletado que registra consultas y analítica de clics.
¿Qué hace Algolia DocSearch?
Qué es Algolia DocSearch
Algolia DocSearch es un programa gratuito ofrecido por Algolia SAS, empresa francesa de infraestructura de búsqueda, que permite a los proyectos open source añadir una búsqueda rápida y tolerante a errores tipográficos en su documentación. Un crawler indexa periódicamente las páginas públicas y un pequeño widget JavaScript (docsearch.js o el componente React) muestra un menú de autocompletado que llama a la API de búsqueda con cada tecla pulsada.
Datos que recoge el widget
Cada consulta se transmite a Algolia junto con la dirección IP, el user agent, el referer y datos de tiempo. Cuando Algolia Insights o la analítica de clics están activas, el widget guarda un identificador anónimo en el localStorage (clave aa-anonymous-user-id) y envía eventos de clic y conversión que alimentan la analítica y el ranking dinámico.
Implicaciones del RGPD y ePrivacy
El mero hecho de teclear una consulta y recibir resultados puede ampararse en el interés legítimo, pero almacenar el identificador anónimo y enviar eventos de comportamiento están sujetos al artículo 22.2 LSSI y al RGPD y requieren consentimiento previo. La IP es dato personal, por lo que deben documentarse el registro de actividades y el plazo de conservación.
Transferencias internacionales
Aunque Algolia es francesa, su red distribuida abarca varios continentes. Las consultas pueden dirigirse al clúster más cercano y algunas funciones corporativas las gestiona Algolia Inc. en Estados Unidos. Las transferencias se basan en cláusulas contractuales tipo y en el Data Privacy Framework. Se puede contratar enrutamiento exclusivamente europeo en planes de pago.
Pasos prácticos de cumplimiento
Desactive la analítica de clics por defecto, condicione el widget al consentimiento, mencione a Algolia como encargado en la política de privacidad, firme el acuerdo de tratamiento de datos y configure el crawler para no indexar páginas con datos personales.
Algolia DocSearch y el RGPD
Algolia DocSearch está clasificado como «Preferencias». En un sitio dirigido a visitantes europeos, solo debe cargarse después del consentimiento del visitante y debe figurar en su política de cookies.
- Base jurídica
- The search box itself can run on legitimate interests (Art. 6(1)(f) GDPR) when used purely to deliver requested results, but the storage of the aa-anonymous-user-id token, click and conversion analytics, and the transmission of IP plus query content for analytics purposes require prior consent (Art. 6(1)(a) GDPR and Art. 5(3) ePrivacy Directive) because they involve storage on the terminal and behavioural analysis.
- Nivel de riesgo
- medium
- Normativa aplicable
- GDPR, ePrivacy Directive (Cookie Law), CCPA, French Data Protection Act
Evaluación de impacto (EIPD)
Una EIPD completa no suele ser obligatoria para DocSearch en documentaciones públicas, pero conviene mantener el registro de actividades del artículo 30 del RGPD, evaluar el plazo de conservación de los registros de consultas y analizar el impacto de activar la analítica de clics, que puede perfilar a usuarios autenticados.
Texto de ejemplo para su banner
Con su consentimiento, usamos Algolia DocSearch para ofrecer la búsqueda en esta documentación. Cada consulta se envía a los servidores de Algolia junto con su dirección IP y un identificador anónimo para mejorar la relevancia de los resultados y medir los artículos más consultados.
Lo que Algolia DocSearch instala y contacta
- Método de seguimiento
- Client side JavaScript widget (docsearch.js or @docsearch/react) that loads on documentation sites, queries the Algolia Search API via XHR/fetch using a public search only API key, builds an autocomplete dropdown, and sends each keystroke to Algolia servers. The Algolia crawler periodically scrapes the documentation pages and pushes structured records into the Algolia index. The widget collects query strings, click and conversion events, user agent, IP address, and may set a local storage anonymous user token (aa-anonymous-user-id) when analytics or click analytics are enabled.
- Ubicación de los servidores
- France (Algolia SAS headquartered in Paris) with production search clusters distributed worldwide (Amazon Web Services and bare metal in Europe, North America, Asia Pacific). Open source projects using the free DocSearch program are usually allocated to EU clusters; commercial Algolia customers can pin to specific regions including Frankfurt, Paris, Dublin, or US East.
- Modo sin cookies disponible
- Sí
- Transferencia de datos fuera de la UE
- While Algolia is a French company, its search clusters span multiple regions and queries are typically routed via the closest distributed search network (DSN) node. For DocSearch on open source projects the default region is EU, but Algolia Inc. (the US subsidiary) may process billing, support, and aggregated analytics data in the United States. Algolia relies on Standard Contractual Clauses and the EU US Data Privacy Framework for any transatlantic flows. Customers can contractually request EU only routing on paid plans.
Cookies instaladas (4)
| Nombre | Tipo | Duración | Finalidad |
|---|---|---|---|
| aa-anonymous-user-id | localStorage | Persistent until cleared | Anonymous identifier stored by Algolia Insights to attribute click and conversion events to a session. |
| _ALGOLIA | localStorage | Persistent | Caches Algolia client configuration and recent query suggestions for the autocomplete component. |
| docsearch-recent-searches | localStorage | Persistent | Stores the most recent queries typed by the user so they appear in the suggestions panel on next visit. |
| docsearch-favorite-searches | localStorage | Persistent | Stores queries the user has marked as favourite directly from the DocSearch modal. |
Dominios de terceros contactados (5)
*.algolia.net*.algolianet.cominsights.algolia.iocrawler.algolia.comcdn.jsdelivr.net
Preguntas frecuentes sobre Algolia DocSearch
¿No encuentra su pregunta? Escríbanos, respondemos rápido.
¿DocSearch utiliza cookies?
DocSearch no usa cookies HTTP. Guarda un identificador anónimo (aa-anonymous-user-id) en el localStorage cuando se activa Algolia Insights o la analítica de clics, almacenamiento equivalente a una cookie según el artículo 22.2 LSSI.
¿Es necesario el consentimiento?
Sí para las funciones de analítica. La búsqueda simple puede ampararse en el interés legítimo, pero almacenar el identificador anónimo y enviar eventos de clic requieren consentimiento previo según el artículo 22.2 LSSI y el RGPD.
¿Cuál es la base jurídica?
El interés legítimo (art. 6(1)(f) RGPD) cubre la consulta de búsqueda. La capa de analítica, incluido aa-anonymous-user-id, se basa en el consentimiento (art. 6(1)(a) RGPD y artículo 22.2 LSSI).
¿Hay transferencias a Estados Unidos?
Es posible. Algolia es francesa pero su red global enruta consultas al clúster más cercano, y Algolia Inc. en EE. UU. gestiona soporte y facturación. Se aplican cláusulas contractuales tipo y el Data Privacy Framework.
¿Hace falta una EIPD?
Una EIPD completa no suele ser necesaria para una búsqueda en documentación pública. Mantenga el registro del art. 30, documente la retención de logs y reevalúe si activa la analítica de clics en portales autenticados.
¿Cómo implementar DocSearch conforme?
Cargue docsearch.js solo tras el consentimiento para cookies de analítica, desactive Insights por defecto, firme el DPA de Algolia, mencione a Algolia como encargado en la política de privacidad y excluya el contenido privado del crawler.
¿Existen alternativas?
Hay opciones auto alojadas como Typesense, Meilisearch o Elasticsearch con interfaz propia. Lunr.js o Pagefind ofrecen búsqueda totalmente en cliente sin enviar consultas a un tercero.
¿Cómo actualizar la política de cookies?
Añada una entrada que mencione Algolia DocSearch, la clave localStorage aa-anonymous-user-id, las finalidades (búsqueda, analítica, ranking), el plazo de conservación y un enlace a la política de privacidad y DPA de Algolia.
Haga que su sitio cumpla la normativa hoy mismo.
Gratis hasta 25.000 sesiones al mes. Sin tarjeta de crédito, sin compromiso.