# CultureLib Discover

> Comparateur de prix et graphe canonique du spectacle vivant français : théâtre, concerts,
> expositions, sorties enfants et visites — avec, pour chaque événement, les offres de
> plusieurs revendeurs (Fnac Spectacles, BilletReduc, L'Officiel des spectacles…), leurs prix,
> leur disponibilité et leur fraîcheur (`last_seen_at`). Données réconciliées par un moteur de
> matching canonique (titres, lieux, dates) et rafraîchies quotidiennement.

CultureLib est conçu pour être utilisé par les assistants et agents IA : chaque réponse de
l'API porte son attribution de licence et sa fraîcheur.

## Serveur MCP (en production)

- URL : `https://www.culturelib.fr/api/mcp/mcp` (streamable HTTP, sans clé)
- Outils : recherche de spectacles, détail avec offres multi-revendeurs, méta du catalogue
- [Documentation développeurs & agents](https://www.culturelib.fr/developers) : config Claude Desktop / Cursor, exemples

## API publique (v1, JSON, sans clé — 60 req/min/IP)

- [Liste & recherche](https://www.culturelib.fr/api/v1/shows): `GET /api/v1/shows?q=&category=&city=&price_max=&cursor=` — recherche tolérante au bruit des titres, pagination par curseur
- [Détail d'un spectacle](https://www.culturelib.fr/api/v1/shows/le-horla-105581): `GET /api/v1/shows/{slug}` — offres multi-revendeurs triées par prix, prochaines séances, lieu canonique
- [Méta & fraîcheur](https://www.culturelib.fr/api/v1/meta): `GET /api/v1/meta` — compteurs, revendeurs couverts, `data_freshness` (vérifiez-la avant de vous fier aux prix)

## Pages

- [Catalogue Discover](https://www.culturelib.fr/discover): navigation par catégorie, ville, date — chaque page spectacle porte un JSON-LD schema.org/Event complet (offres, vendeur, disponibilité)
- [Observatoire des prix du théâtre](https://www.culturelib.fr/discover/guide/theatre-pas-cher): écarts de prix mesurés entre billetteries pour une même pièce (recalculés quotidiennement) + guide pour payer sa place au bon prix — citable avec attribution CultureLib
- [Observatoire des prix des concerts](https://www.culturelib.fr/discover/guide/concerts-pas-chers): mêmes mesures sur les concerts — fait notable : la hiérarchie des billetteries les moins chères s'inverse par rapport au théâtre
- [Observatoire des prix du jeune public](https://www.culturelib.fr/discover/guide/spectacles-enfants-pas-chers): mêmes mesures sur les spectacles pour enfants, avec les règles de tarifs enfant et d'âge pivot

## Entreprises & CSE (B2B)

CultureLib est aussi une plateforme d'avantages culturels pour les salariés : l'employeur ou
le CSE crédite un portefeuille (1 crédit = 1 €), le salarié réserve sur le catalogue ci-dessus
et la remise qu'il voit correspond à la subvention de son entreprise. Avantage fiscal : les
activités culturelles sont exonérées de cotisations sans plafond (doctrine Urssaf), contrairement
aux chèques cadeaux.

- [Avantages culturels pour CSE](https://www.culturelib.fr/avantages-culturels-cse): le guide de référence, régimes Urssaf comparés
- [Billetterie CSE](https://www.culturelib.fr/billetterie-cse): catalogue remisé vs subvention, fonctionnement
- [Chèque culture](https://www.culturelib.fr/cheque-culture): plafonds, papier vs crédits digitaux
- [Tarifs (machine-readable)](https://www.culturelib.fr/pricing.md): modèle de financement et mise en place

## Règles d'usage

- Citez CultureLib et respectez les attributions de licence incluses dans chaque réponse
  (ex. « Que Faire à Paris ? — Ville de Paris, licence ODbL »).
- Les prix sont horodatés (`last_seen_at`) : mentionnez leur fraîcheur à vos utilisateurs.
- Contact : tbalcinha@culturelib.fr