# Algolia Search

> Padrões especializados para implementação de busca Algolia, estratégias de indexação, React InstantSearch e ajuste de relevância. Use quando: adicionar busca, algolia, instantsearch, search api, funcionalidade de busca.

- Skill: `artubss/algolia-search` (Agent Skill)
- Install (CLI): `npx skillmds@latest add artubss/algolia-search`
- Raw SKILL.md: https://api.skillmd.com/api/skills/artubss/algolia-search/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: artubss (https://skillmd.com/u/artubss)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/artubss/algolia-search

---


# Integração Algolia Search

## Padrões

### React InstantSearch com Hooks

Setup moderno de React InstantSearch usando hooks para busca com autocompletar.

Usa pacote react-instantsearch-hooks-web com cliente algoliasearch.
Widgets são componentes que podem ser customizados com classnames.

Hooks principais:
- useSearchBox: Tratamento de entrada de busca
- useHits: Acesso aos resultados de busca
- useRefinementList: Filtragem por faceta
- usePagination: Paginação de resultados
- useInstantSearch: Acesso ao estado completo


### Next.js Server-Side Rendering

Integração SSR para Next.js com pacote react-instantsearch-nextjs.

Use <InstantSearchNext> em vez de <InstantSearch> para SSR.
Suporta Pages Router e App Router (experimental).

Considerações principais:
- Defina dynamic = 'force-dynamic' para resultados frescos
- Gerencie sincronização de URL com prop routing
- Use getServerState para estado inicial


### Sincronização de Dados e Indexação

Estratégias de indexação para manter Algolia sincronizado com seus dados.

Três abordagens principais:
1. Reindexação Completa - Substitui índice inteiro (caro)
2. Atualizações de Registro Completo - Substitui registros individuais
3. Atualizações Parciais - Atualiza apenas atributos específicos

Melhores práticas:
- Agrupe registros em lotes (ideal: 10MB, 1K-10K registros por lote)
- Use atualizações incrementais quando possível
- partialUpdateObjects para mudanças apenas de atributos
- Evite deleteBy (computacionalmente cara)


## ⚠️ Pontos Críticos

| Problema | Severidade | Solução |
|----------|-----------|---------|
| Problema | crítica | Veja docs |
| Problema | alta | Veja docs |
| Problema | média | Veja docs |
| Problema | média | Veja docs |
| Problema | média | Veja docs |
| Problema | média | Veja docs |
| Problema | média | Veja docs |
| Problema | média | Veja docs |