# WatchPatrol

> Community-powered watch search engine aggregating listings from watch enthusiast forums worldwide.

WatchPatrol helps users find pre-owned, vintage, and new watches for sale by aggregating listings from popular watch forums and communities including Reddit WatchExchange, Watchuseek, Omega Forums, Rolex Forums, and more.

## What This Site Offers

- **Watch Listings**: Searchable database of watches for sale from enthusiast forums
- **Price Data**: Historical pricing and market analysis for watch models
- **Seller Reputation**: Feedback and transaction history for sellers
- **Brand Discovery**: Browse watches by brand, model, price range, and origin
- **Saved Searches**: Create alerts for specific watches or criteria

## Key Pages

- `/` — Homepage with latest watch listings
- `/discover/` — Browse top brands and popular watches
- `/discover/brands/{slug}/` — Individual brand pages with popular models
- `/?query={search}` — Search for specific watches
- `/?brand={brand}` — Filter by brand name
- `/listing/{id}/` — Individual watch listing details
- `/integrations/` — Integrations portal (sign in to create Personal Access Tokens or OAuth apps)

## For AI Agents and Developers

WatchPatrol exposes its catalog and market data through two interfaces:

- **REST API** — `/api/public/v1/` (OpenAPI 3 docs at `/api/public/v1/docs/`, schema at `/api/public/v1/schema/`)
- **MCP server** — `https://api.watchpatrol.net/mcp/` (Streamable HTTP transport, 19 tools across catalog, pricing, listings, sellers, identify)

Auth differs by interface:

- **REST** requires a Personal Access Token (`wpat_...`) from `/integrations/api-keys/`, passed as `Authorization: Bearer <token>`.
- **MCP** clients (ChatGPT, Claude Code, Claude Desktop via mcp-remote, Gemini CLI, Cursor) perform the OAuth 2.0 code flow themselves on first connect via the `WWW-Authenticate: Bearer resource_metadata=...` discovery response. No manual token paste.

See `/llms-full.txt` for endpoint details, tiers, and auth.

## Content Guidelines

- All listings are user-generated content from external forums
- Prices are in various currencies (USD, EUR, GBP, CHF, JPY)
- Listings may be sold or no longer available
- Always verify current availability on the original forum

## Contact

- Integrations portal: /integrations/
- Contact form: /contact/