Développeurs et agents IA

Ce qui accompagne chaque article

• l’adresse permanente de l’article sur madda.ma
• le numéro de l’article, le titre et le numéro du texte
• la date de la version consolidée
• le lien vers la version officielle (PDF) sur le portail Adala
• une note de qualité lorsqu’une partie du texte provient d’une reconnaissance optique de caractères (OCR)

Texte brut (Markdown)

Ajoutez.md à l’adresse d’un texte ou d’un article, ou envoyez l’en-tête Accept: text/markdown. Index général : /llms.txt; liste de tous les textes : /llms-full.txt.

curl https://madda.ma/ar/loi-70-03/4.md

API JSON

API en lecture seule, décrite en OpenAPI 3.1. /api/v1/openapi.json

• GET/api/v1/search?q=…&lang=ar&kind=&category=&limit=10
• GET/api/v1/texts/{lang}/{slug}
• GET/api/v1/articles/{lang}/{slug}/{key}
• GET/api/v1/articles/{lang}/{slug}/{key}/versions
• GET/api/v1/categories?lang=ar

Exemple

curl "https://madda.ma/api/v1/articles/ar/loi-70-03/4"

{
  "label": "المادة 4",
  "paragraphs": ["الزواج ميثاق تراض وترابط شرعي …"],
  "citation": {
    "canonical_url": "https://madda.ma/ar/loi-70-03/4",
    "marker": "المادة 4",
    "text_title": "قانون بمثابة مدونة الأسرة",
    "text_number": "70.03",
    "consolidated_at": "2021-07-29",
    "official_pdf_url": "https://adala.justice.gov.ma/api/…",
    "quality_note": null,
    "citation_line": "المادة 4 من القانون رقم 70.03 — madda.ma"
  }
}

Serveur MCP

Pour les agents compatibles MCP (Streamable HTTP, sans session). Outils : recherche, lecture d’un article, d’un texte et de son sommaire, versions précédentes d’un article, matières.

• MCPhttps://madda.ma/mcp
• toolsearch_law
• toolget_article
• toolget_text
• toolget_versions
• toollist_categories

Configuration du client

{
  "mcpServers": {
    "madda": { "type": "http", "url": "https://madda.ma/mcp" }
  }
}

Limites et clés

• L’usage gratuit est limité par adresse IP (de l’ordre de 60 requêtes par minute et 2 000 par jour ; une recherche compte plus qu’une lecture d’article).
• Un usage intensif ou un export complet nécessite une clé, envoyée dans Authorization: Bearer ou X-API-Key.
• Pour obtenir une clé : [email protected] (formulaire à venir).

Règles

• Les textes de loi relèvent du domaine public ; la structure, la normalisation et les versions sont notre travail.
• Indiquez toujours la date de la version consolidée et le lien vers la version officielle. Seul fait foi le texte publié au Bulletin officiel.
• madda ne fournit pas de conseil juridique et ne met pas en relation avec des professionnels.