Get started
Overview
Findlane is hosted product search for online stores. Upload your catalog from your server, then search it from your storefront with typo tolerance, facets, filters, and sorting.
How it works
- Upload your catalog. Your server sends product records to an index with a secret API key, using
@findlane/serveror the HTTP API. Writes are searchable as soon as they return. - Choose how it searches. Pick the fields to search and how much each counts, and the fields shoppers can filter, facet, and sort by. You can change them at any time, and the index keeps serving searches while a change applies.
- Search from the storefront. The browser calls the index with its public ID, using
@findlane/browser. Only origins you allow can use it.
Concepts
| Term | What it is |
|---|---|
| Workspace | Your team's account: its members, API keys, indexes, and plan. |
| Index | A searchable collection of records, such as a store's products, with its own settings. A workspace can have several, for example one per store or language. |
| Record | A JSON object with a string objectID: one product, with the fields you want to search, filter, show, or sort by. |
| API key | A secret for your server. It has the search scope, the write scope, or both, and can be limited to one index. |
| Public ID | An index's ID for browser search (pub_…). It is public by design: it can only search, only its own index, and only from allowed origins. |
Where to start
- Quick start: upload a catalog and search it from a page, in about ten minutes.
- Records: what a record looks like, and keeping records in sync with your store.
- Set up search: set an index up for what people will type, and keep those searches working.
- Search settings: searchable fields, facets, filters, sorts, ranking, and synonyms.
- Searching: queries, filters, facets, paging, and highlighting.
- Security: API keys, public IDs, and what browser search exposes.
- AI agents (MCP): let Claude Code, Cursor, or another agent set up and manage your search.
Packages
| Package | Runs in | Authenticates with |
|---|---|---|
@findlane/server | Node.js 18+, Bun, Deno, and edge runtimes | A workspace API key |
@findlane/browser | Browsers, from npm or a script tag | An index's public ID |
Both are small, typed, and have no dependencies. From other languages, call the HTTP API directly.
Use with AI assistants
Agents can set up search for you through Findlane's MCP server: they create indexes, load records, choose settings, and test searches in the workspace you allow.
Every page is also plain Markdown: add .md to its address, as in /docs/quick-start.md, ask for it with an Accept: text/markdown header, or use Copy page at the top. For coding assistants and other LLM tools:
- /llms.txt lists every page with a one-line summary, following the llms.txt convention.
- /llms-full.txt has all the docs in one file, to attach or paste as context.