Liste des 123 spécialités Doctolib (slug à utiliser dans les autres outils, nom, id). query filtre sans tenir compte des accents (ex. 'derma', 'kiné', 'ophtal').

Autocomplétion Doctolib : spécialités / actes (searchEntries) et praticiens ou centres par nom (profiles). Astuce : le moteur préfère les préfixes courts ('derma' plutôt que 'dermatologue').

Filtres de recherche proposés par Doctolib pour une spécialité (délais, secteurs, langues, vidéo).

Communes françaises par nom ou code postal, avec coordonnées (geo.api.gouv.fr).

Adresse précise → coordonnées (api-adresse.data.gouv.fr), pour centrer une recherche sur un domicile.

Autocomplétion de lieux côté Doctolib (villes, codes postaux, adresses). Ne renvoie pas de coordonnées.

Praticiens d'une spécialité autour d'un lieu (ville/code postal/adresse ou lat+lng), triés par distance.

Chaque résultat donne : distance, adresse, motif principal (id, nom, nouveaux patients acceptés ?), agendas, secteur de conventionnement, moyens de paiement, langues, profile_id (→ practitioner_practical_info), slug (→ practitioner_booking_info) et booking_url.

• available_within_days : seulement ceux avec un créneau sous N jours (filtre Doctolib, incomplet).

• languages : codes Doctolib (gb, es, de, it, ar, pt, ru, cn…).

• Les bornes de téléconsultation en pharmacie sont exclues par défaut.

• online_booking_only=False inclut les fiches annuaire (pas de RDV en ligne, souvent téléphone uniquement).

TOUS les créneaux libres d'une spécialité autour d'un lieu, sur N jours, en un appel.

Renvoie la liste chronologique des créneaux (heure, praticien, distance, motif, remplaçant, lien de réservation) et l'état de chaque praticien (nb de créneaux, premier créneau, prochain créneau hors période, agenda fermé…). Peut prendre 10 à 60 s selon le nombre de praticiens (≈ 3 requêtes/s vers Doctolib).

Données du tunnel de réservation d'un praticien : lieux (adresse, GPS, téléphone), agendas (fermés ?), tous les motifs (vidéo, réservés aux patients déjà suivis sur tel agenda, restrictions d'âge, où ils sont réservables).

Infos pratiques : horaires d'ouverture, accepte les nouveaux patients, téléconsultation, secteur, carte Vitale, moyens de paiement, langues, adresses. profile_id vient de search_practitioners ; sinon fournir url_or_slug (résolu via le tunnel de réservation).

Catégories de demandes par messagerie Doctolib (renouvellement, résultats…) si le praticien l'a activée.

Créneaux d'un praticien pour un motif, sur N jours (Doctolib limite à 15 j par appel : l'outil enchaîne).

Deux usages :

• url_or_slug (+ motive_id / practice_id optionnels) : agendas résolus automatiquement ; sans motive_id, TOUS les motifs réservables sont interrogés.

• motive_id + agenda_ids (+ practice_id) : appel direct (ids issus de search_practitioners). Renvoie slots, substitutes (créneaux assurés par un remplaçant), next_slot si rien dans la période, reason (agenda fermé / pas encore ouvert) et booking_url.

Variante « vue liste » de Doctolib (7 jours max) avec filtre de régime d'assurance. Réponse brute.

Lien vers le tunnel de réservation Doctolib avec lieu et motif pré-sélectionnés (le créneau ne peut pas l'être).

Sitemaps publics Doctolib : 'sitemap' (index), 'sitemap_specialities/1', 'sitemap_skills/1' (1604 actes), 'sitemap_practitioner_doctors/1'… (≈ 295 000 fiches au total). Renvoie les URL.

Surveille un praticien : notification dès qu'un nouveau créneau s'ouvre (via doctolib-mcp-watch, à planifier). Sans motive_id : motif de l'URL, sinon le premier motif réservable. before = AAAA-MM-JJ ignore les créneaux plus tardifs.

Surveille TOUTE une zone : notification dès qu'un nouveau créneau apparaît chez n'importe quel praticien de la spécialité dans le rayon (via doctolib-mcp-watch, à planifier).

Surveillances et leur état (dernière vérification, nb de créneaux, dernière alerte, erreur).

Met en pause (ou supprime avec delete=True) une surveillance.

Lance immédiatement une passe de surveillance (notifie les nouveaux créneaux).

Canaux d'alerte : notification macOS, push téléphone via ntfy.sh (app gratuite, s'abonner au topic), webhook JSON (POST {title, message, url}) vers n8n, Slack, Discord… Envoie une notification de test.