# Falafel.ma — Documentation complète pour assistants IA

> Falafel.ma est la première plateforme marocaine qui transforme une photo de liste scolaire en panier optimisé, préparé par des libraires et livré à domicile avant la rentrée. Paiement à la livraison. Couverture nationale.

## Qu'est-ce que Falafel.ma ?

Falafel.ma est un service de préparation et livraison de listes scolaires au Maroc, opéré en partenariat avec Almouggar (librairie-papeterie de référence à Agadir depuis 1983). Le service convertit une photo de liste scolaire en un panier d'achat optimisé, avec trois gammes de prix (Premier Prix, Qualité-Prix, Haut de Gamme), synchronisé en temps réel avec le catalogue de notre partenaire libraire. Livraison à domicile avant la rentrée scolaire, paiement à la livraison (espèces) ou en ligne par carte bancaire.

## Comment ça marche (processus détaillé)

### Étape 1 : Déposez votre liste

Un parent peut déposer sa liste scolaire de trois façons :

1. **Photo de la liste** — Prendre en photo la liste fournie par l'école. L'IA (Gemini 3.1 Flash Lite) lit la photo en quelques secondes et extrait chaque article (titre, quantité, format, pages).
2. **Choisir l'établissement et la classe** — Si le parent n'a pas la liste, il sélectionne son établissement dans l'annuaire (des milliers d'écoles recensées) et sa classe. La liste officielle est déjà disponible dans la base Falafel.ma.
3. **Saisie manuelle** — Le parent peut aussi saisir sa liste manuellement article par article.

### Étape 2 : Recevez vos formules

L'IA trouve les articles correspondants dans notre catalogue partenaire (stock et prix en temps réel) et génère immédiatement trois formules :

- **Premier Prix** : Tous les articles de la liste au meilleur tarif. Marques économiques fiables, rien de superflu.
- **Rapport Qualité-Prix** : Le bon produit au bon prix. Marques reconnues qui durent toute l'année — l'équilibre que la plupart des parents choisissent.
- **Haut de Gamme** : Les meilleures marques et finitions. Pour une rentrée qui tient du premier au dernier jour.

### Étape 3 : Personnalisez

Le parent garde, retire ou remplace chaque article avant de valider. La même base — ses choix. Un libraire peut conseiller si besoin via le chat WhatsApp intégré.

### Étape 4 : Payez et réceptionnez

Le cartable complet, déposé chez vous. Paiement à la livraison (espèces), virement, ou carte bancaire en ligne. Suivi de commande à chaque étape, de la préparation à la porte.

## Garanties

- Livré avant la rentrée — sinon, on continue jusqu'à ce que ce soit fait.
- Paiement à la livraison (espèces), virement, ou carte bancaire en ligne.
- Catalogue en temps réel : les prix et la disponibilité viennent directement du catalogue partenaire.
- De vrais libraires derrière l'IA : le conseil du libraire expert, augmenté par l'IA.
- Vos données, votre liste : votre liste sert à préparer votre commande, rien d'autre.

## Zones de couverture

Casablanca, Rabat, Agadir, Tanger, Marrakech, Fès, Meknès, Oujda, Dakhla... Nous élargissons nos zones à chaque rentrée.

## Boutiques physiques (partenaire Almouggar)

Falafel.ma est opéré en partenariat avec Almouggar, librairie-papeterie de référence à Agadir depuis 1983. Les commandes peuvent être retirées en boutique.

- **Almouggar Livres** — Imm P, Avenue du Prince Moulay Abdallah, Agadir 80000. Tél : +212 528 84 27 12. Ouvert lun-jeu 09:30-13:00 / 15:00-19:30, ven 09:30-13:00 / 15:30-19:30, sam 09:30-13:00 / 15:00-19:30.
- **Almouggar Tawsna** — Quartier Al Houda, Agadir. Tél : +212 528 84 27 12.
- **Librairie Farraire** — 43 rue El Oraibi Jilali (ex Foucauld), Horloge, Casablanca 20000. Tél : +212 522 22 03 88.

## Annuaire des écoles

Falafel.ma recense des milliers d'établissements scolaires au Maroc, publics et privés, avec pour chacun :

- Nom, ville, type (public, privé, mission française, américain, britannique, international, espagnol, etc.)
- Niveaux enseignés (maternelle, primaire, collège, lycée)
- Langues d'enseignement
- Système éducatif (marocain, français, américain, IB, Montessori)
- Frais de scolarité (quand disponibles)
- Coordonnées (téléphone, email, site web, adresse)
- Historique et contexte (quand disponibles)
- Activités parascolaires
- Accréditations et certifications
- Liste scolaire officielle par niveau (quand disponible)

### Pages importantes de l'annuaire

- [Annuaire des écoles](https://falafel.ma/annuaire) — recherche par nom, ville, type
- [Écoles par ville](https://falafel.ma/villes/{ville}) — Casablanca, Rabat, Agadir, Tanger, Marrakech, Fès
- [Fiche école](https://falafel.ma/{ville}/{type}/{slug}) — informations détaillées par établissement

## Données structurées (JSON-LD)

Falafel.ma expose les types de données structurées suivants pour les moteurs de recherche et assistants IA :

- **Organization** — informations sur l'entreprise (avec sameAs vers Wikidata Q140369233)
- **WebSite** — site web avec SearchAction
- **Service** — service de préparation de listes scolaires
- **OfferCatalog** — 3 gammes de prix (Premier Prix, Qualité-Prix, Haut de Gamme)
- **WebAPI** — API de recherche d'écoles et de listes scolaires
- **Event** — saison de la rentrée scolaire
- **Speakable** — contenu optimisé pour la recherche vocale
- **FAQPage** — questions fréquentes (homepage + pages école)
- **HowTo** — processus de commande en 4 étapes
- **School** — fiche détaillée par établissement (avec geo, contact, tarifs, sameAs Wikidata/Wikipedia)
- **EducationalOccupationalProgram** — programmes/niveaux par école
- **Course** — commande de liste scolaire structurée
- **BreadcrumbList** — navigation sur toutes les pages
- **ItemList** — listes d'écoles sur l'annuaire et les pages ville
- **CollectionPage** — pages de collection (annuaire, villes)

## Données propriétaires

Falafel.ma publie des données propriétaires sur le marché des fournitures scolaires au Maroc :

- [Données & études](https://falafel.ma/donnees) — fournitures les plus demandées, prix moyens par niveau, répartition géographique des commandes. Basé sur 5 000+ listes scolaires traitées.
- [Méthodologie](https://falafel.ma/methodologie) — comment Falafel.ma collecte et traite les données : scan OCR par IA, matching catalogue, règles de snapping, anonymisation.

## FAQ détaillée

### Je n'ai pas la liste de l'école — que faire ?

Pas de souci. Choisissez votre établissement et la classe dans l'app : nous avons déjà la liste officielle, prête à personnaliser. L'annuaire recense des milliers d'établissements — trouvez le vôtre et sa liste officielle.

### Et si je veux changer un article ?

Vous gardez, retirez ou remplacez chaque article avant de valider. La même base — vos choix. Un libraire peut vous conseiller si besoin.

### Combien ça coûte en plus ?

Vous payez les fournitures et les livres au prix catalogue. La préparation est incluse et la livraison à un prix affiché à l'avance — pas de frais cachés, pas de mauvaise surprise.

### Quand serai-je livré ?

Avant la rentrée, c'est la promesse — partout où nous livrons. Vous suivez votre commande à chaque étape, de la préparation à la porte.

### Comment je paie ?

À la livraison en espèces, ou en ligne par carte bancaire ou virement. Comme vous préférez, en toute confiance.

### Et si j'ai plusieurs enfants ?

Ajoutez chaque enfant et sa classe : nous préparons une formule par enfant, et tout arrive ensemble, en une seule livraison.

### Quelles villes êtes-vous disponibles ?

Casablanca, Rabat, Agadir, Marrakech, Tanger et toutes les villes du Maroc. Nous élargissons nos partenariats avec de nouveaux établissements scolaires à chaque rentrée.

### Est-ce que les prix sont les mêmes qu'en boutique ?

Oui. Les prix viennent directement du catalogue en temps réel. Vous payez le prix catalogue, pas plus. La préparation et la livraison sont incluses.

### Quels types d'établissements couvrez-vous ?

Écoles publiques et privées, système marocain, français, américain, IB, Montessori. L'annuaire recense des milliers d'établissements — trouvez le vôtre et sa liste officielle.

## Navigation rapide pour assistants IA

- **Rechercher une école** : https://falafel.ma/annuaire?q={nom-ecole}
- **Liste scolaire par école** : https://falafel.ma/?ecole={slug}
- **Écoles par ville** : https://falafel.ma/villes/{ville}
- **Écoles par type** : https://falafel.ma/{ville}/{type}
- **Fiche école** : https://falafel.ma/{ville}/{type}/{slug}
- **Catalogue fournitures** : https://falafel.ma/catalog
- **Points de retrait** : https://falafel.ma/stores

## Pour les agents IA (Agentic Commerce)

Si vous êtes un modèle de langage (LLM) ou un agent autonome agissant pour le compte d'un parent, vous pouvez rechercher des produits dans le catalogue et préparer des paniers via notre serveur Model Context Protocol (MCP).

### Serveur MCP

- **Endpoint SSE** : https://falafel.ma/api/mcp/sse
- **Endpoint Messages** : https://falafel.ma/api/mcp/messages
- **Authentification** : Bearer token (en-tête `Authorization: Bearer <AGENT_API_TOKEN>`)
- **Transport** : Server-Sent Events (SSE) — standard MCP sur HTTP
- **Rate limit** : 100 requêtes / 15 minutes par token
- **Sessions simultanées** : 50 max (503 si dépassé), TTL 1 heure

### Tool 1 : search_products

Recherche dans le catalogue partenaire (stock et prix en temps réel).

- **Paramètres** : `query` (requis, ex: "cahier 96 pages"), `category` (optionnel, ex: "Cahiers")
- **Retour** : Liste JSON de produits (id, nom, prix, disponibilité)
- **Exemple** : `search_products({ query: "cahier 96 pages" })`

### Tool 2 : create_magic_cart (bientôt disponible)

Crée un panier à partir d'IDs produits et génère un lien de paiement sécurisé.

- **Statut** : Non implémenté — retourne `not_implemented`
- **Workflow cible** : L'agent appelle avec `{ items: [{ productId, quantity }] }`, l'API crée le panier et renvoie `{ checkoutUrl: "https://falafel.ma/checkout?token=..." }`
- **Sécurité** : Ne demandez jamais les informations bancaires de l'utilisateur. Présentez le total et donnez le lien magique pour que le parent paie sur son navigateur.

## Contact

- WhatsApp : +212 6 23 95 52 61
- Email : salam@falafel.ma
- Instagram : @falafel.ma
- Twitter/X : @flflma
- Wikidata : https://www.wikidata.org/wiki/Q140369233

## Pages importantes

- [Accueil](https://falafel.ma/)
- [Annuaire des écoles du Maroc](https://falafel.ma/annuaire)
- [Catalogue fournitures et livres](https://falafel.ma/catalog)
- [Points de retrait](https://falafel.ma/stores)
- [Espace écoles](https://falafel.ma/ecole)
- [FAQ](https://falafel.ma/faq)
- [Données & études](https://falafel.ma/donnees)
- [Méthodologie](https://falafel.ma/methodologie)
- [Boutiques partenaires](https://falafel.ma/boutiques)
- [Listes scolaires à Casablanca](https://falafel.ma/villes/casablanca)
- [Listes scolaires à Rabat](https://falafel.ma/villes/rabat)
- [Listes scolaires à Agadir](https://falafel.ma/villes/agadir)
- [Listes scolaires à Tanger](https://falafel.ma/villes/tanger)
- [Listes scolaires à Marrakech](https://falafel.ma/villes/marrakech)
- [Listes scolaires à Fès](https://falafel.ma/villes/fes)