CultureLib pour les développeurs, et pour les agents IA

CultureLib Discover agrège et réconcilie l'offre culturelle française (théâtre, concerts, expositions, sorties enfants, 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. Tout est accessible en lecture, sans clé, via une API REST et un serveur MCP.

Serveur MCP

Six tools métier : search_shows, whats_on (ville + date + budget), get_show, compare_offers (meilleur prix multi-revendeurs), find_venues, get_catalog_meta (fraîcheur des données). S'y ajoutent search et fetch, au format attendu par les connecteurs ChatGPT (deep research). Configuration Claude Desktop / Cursor / clients MCP :

{
  "mcpServers": {
    "culturelib-discover": {
      "url": "https://www.culturelib.fr/api/mcp/mcp"
    }
  }
}

Référencé au registre MCP officiel sous le nom io.github.tbalcinha/culturelib-discover : les clients compatibles peuvent le découvrir et l'installer directement depuis le registre.

API REST v1

JSON, sans authentification, 60 requêtes/min/IP. Le contrat v1 est stable : tout changement cassant ira dans une v2.

• GET /api/v1/shows : liste & recherche (q, category, city, region, price_max, date, pagination par cursor)
• GET /api/v1/shows/{slug} : détail avec offres vivantes triées par prix (avec last_seen_at et attribution par offre), prochaines séances, lieu canonique
• GET /api/v1/venues?q=&city= et GET /api/v1/venues/{id} : lieux canoniques et leur affiche
• GET /api/v1/meta : compteurs, revendeurs couverts, data_freshness

curl "https://www.culturelib.fr/api/v1/shows?q=cantatrice%20chauve&limit=3"

Règles d'usage

• Attribution : chaque réponse inclut les mentions de licence des sources (ex. « Que Faire à Paris ?, Ville de Paris, licence ODbL »). Affichez-les avec les données.
• Fraîcheur : les prix sont horodatés (last_seen_at). Mentionnez leur ancienneté à vos utilisateurs ; vérifiez /api/v1/meta avant de vous fier aux prix.
• Crawlers IA bienvenus sur le catalogue public : voir llms.txt et le JSON-LD schema.org/Event de chaque page spectacle.

Un cas d'usage, un besoin de quota supérieur, une intégration (plateforme d'agents, OTA, conciergerie) ? tbalcinha@culturelib.fr