# Pricesaurus

Pricesaurus watches a product URL and tells you when the price drops.

Paste a product link. We read the current price. You set an alert. You get email and a push when it falls.

## When to use this

Use Pricesaurus when a person or an agent needs to:

- Read the live price of a product page from any store
- Watch that URL over time
- Fire an alert when the price drops or crosses a threshold

Do not use it as a store catalog, a shopping cart, or a general web scraper.

## API

The canonical HTTP API is versioned at `/api/v1`.

- OpenAPI: [/openapi.json](/openapi.json)
- Human docs: [/docs/api.md](/docs/api.md)
- HTML docs: [/developers](/developers)
- SDK: [github.com/alfonsobries/pricesaurus-js](https://github.com/alfonsobries/pricesaurus-js) (`npm install pricesaurus`)
- CLI: `npx pricesaurus` (same package; `pricesaurus --help`)
- Auth: [/auth.md](/auth.md)
- Catalog: [/.well-known/api-catalog](/.well-known/api-catalog)
- Pricing: [/pricing.md](/pricing.md)
- Home markdown: [/index.md](/index.md)
- About: [/about.md](/about.md)
- Docs index: [/docs/llms.txt](/docs/llms.txt)
- MCP docs (public): [/mcp](/mcp)
- MCP watch (Bearer token): [/.well-known/mcp](/.well-known/mcp) (also [/mcp/watch](/mcp/watch))
- MCP catalog: [/.well-known/mcp.json](/.well-known/mcp.json)
- MCP server card: [/.well-known/mcp/server-card.json](/.well-known/mcp/server-card.json)
- Agent skills: [/.well-known/agent-skills/index.json](/.well-known/agent-skills/index.json)

Auth is a Sanctum personal access token as `Authorization: Bearer <token>`. Create a token in the account API keys screen. The same API is what the iOS/Android app and the web app will consume.

## Loop

1. `POST /api/v1/extract` with `{ "url": "https://..." }` to preview a snapshot (no save)
2. `POST /api/v1/products` with the same URL to start watching
3. `POST /api/v1/products/{id}/alerts` with `{ "condition": "drops" }`
4. `GET /api/v1/products/{id}` and `GET /api/v1/products/{id}/prices` to read history

The user never picks a store. Host contracts (Amazon Product API, etc.) are internal.

## Site

The product lives at [pricesaurus.com](https://pricesaurus.com). Spanish: [pricesaurus.com/es](https://pricesaurus.com/es). Sign in at `/login`. The mobile API is the same host under `/api/v1`.

## Locales

Spanish and English. Product pages themselves stay in the store's language.