# Sideby

> Side-by-side product comparison for OpoShop stores. Adds a Compare control to product pages and collection cards; selected products open a comparison drawer laying them out as columns on a spec sheet — price, availability, rating, the options they are sold in, and the merchant's own product fields — with the best value in each numeric row marked and matching rows foldable away. Builds its own sheet by reading which attributes already exist across the catalogue. Two read-only scopes, never writes to a store, stores nothing that identifies a shopper.

This app is built on the OpoShop platform. It is agent-friendly: the full
API is described in OpenAPI and wrapped by an MCP server so an LLM can drive it
directly.

## Machine interfaces
- API contract (OpenAPI): https://app.trysideby.com/openapi.json
- API docs (Swagger): https://app.trysideby.com/docs
- Fuller LLM context: https://app.trysideby.com/llms-full.txt
- Release notes: https://app.trysideby.com/api/release-notes
- MCP endpoint (hosted): https://app.trysideby.com/mcp — add this URL to Claude or any LLM
  client to drive the app in natural language. Auth with your own OpoShop store
  token via Authorization: Bearer <token>.

## Auth
Get an access token via POST /api/auth/login, then send it as
`Authorization: Bearer <token>` on /api/* requests (and to the /mcp endpoint).