Minha Receita est un projet de code source libre et de données ouvertes né d’un besoin réel de transparence. Aujourd’hui, c’est une pièce fondamentale de l’infrastructure civique brésilienne, transformant les fichiers massifs et confus de l’Agence du revenu du Brésil pour le CNPJ (le Registre national des personnes juridiques — qui contient les registres publics de chaque organisation au pays, tels que les noms légaux, les adresses et les structures de propriété) en une API propre, gratuite et ouverte pour toute personne (ou machine).

Comment tout a commencé

L’histoire du projet débute en 2018, lorsque l’avocat Bruno Morassutti, le spécialiste en technologie civique Turicas et moi-même avons tenté d’obtenir des données du CNPJ par le biais de la Loi sur l’accès à l’information (LAI). Contrairement à ce que prévoit la loi, les données n’étaient disponibles que derrière un CAPTCHA. L’Agence du revenu du Brésil a rejeté la demande, alléguant que les données nécessiteraient un « traitement additionnel » pour être livrées.

À l’époque, la seule alternative proposée dans les réponses officielles de l’organisme gouvernemental fédéral était le Serpro, qui demandait environ un demi-million de reais pour ces données — des données qui devraient être ouvertes, selon la loi. Ce montant rendait évidemment irréalisable tout travail journalistique, toute recherche indépendante ou tout projet de responsabilité civique ou sociale.

Nous avons fait appel et, dans l’une des dernières instances administratives, nous avons réussi à faire en sorte que l’Agence du revenu du Brésil fasse le strict minimum : respecter la loi. Mais même lorsque l’Agence du revenu du Brésil a commencé à rendre les données disponibles, bien qu’elles fussent ouvertes, elles n’étaient définitivement pas accessibles. Les téléchargements étaient extrêmement lents et instables (rendant souvent l’accès réel impossible), le format des données ne suivait pas les normes courantes et il n’existait aucun outil pour les utiliser facilement. De plus, l’organisme ne proposait pas d’API de consultation, seulement quelques fichiers massifs qui exigeaient une expertise technique et du matériel puissant pour être exploités.

Minha Receita a été ma réponse à ce scénario. J’ai donc décidé de rendre ces données — désormais ouvertes — accessibles en créant un projet offrant des outils de téléchargement et de traitement des données, ainsi qu’une API gratuite et ouverte.

Impact et échelle

Ce qui a commencé comme un projet individuel est devenu une option robuste et populaire pour les données ouvertes sur les entreprises au Brésil. Aujourd’hui, Minha Receita est le moteur derrière des initiatives comme BrasilAPI, qui compte près de 10 000 étoiles sur GitHub en date de mai 2026. Chaque fois que quelqu’un consulte le CNPJ par le biais de ces agrégateurs, c’est l’infrastructure de Minha Receita qui travaille en arrière-plan.

Les chiffres (mesurés en mai 2026) montrent l’ampleur de ce que nous avons bâti et peuvent être suivis en temps réel sur les métriques du projet. Tout cela est maintenu avec une infrastructure simple et peu coûteuse qui revient à environ 130 R$ par mois — un montant qui couvre le domaine, la base de données et les serveurs. L’API Web traite environ 150 millions de requêtes mensuelles (près de 3 000 par minute) avec une latence extrêmement faible : les réponses P50 et P95 se situent respectivement autour de 160 ms et 250 ms.

Toute cette performance est le résultat d’une architecture pensée pour une efficacité maximale en tant qu’API. Chaque décision technique — y compris le choix du langage Go — a été prise pour garantir le meilleur rendement avec le coût opérationnel le plus bas possible. Bien que je sois le mainteneur principal et responsable de l’infrastructure, le projet est une construction collective : au fil de son histoire, plus de 20 personnes ont contribué directement au code (incluant l’initiative d’un membre de la communauté pour ajouter le support d’une base de données différente de la base « officielle » du projet), totalisant plus de 150 forks. La reconnaissance du projet est également visible par sa popularité, avec près de 2 000 étoiles sur GitHub.

Tout ce parcours pour rendre les données accessibles a fini par obtenir une reconnaissance de la part de la société. GitHub Brasil, par exemple, a mentionné Minha Receita comme un projet ayant simplifié l’accès aux données ouvertes et a célébré des aspects tels que la citoyenneté et la transparence. Cette pertinence a franchi les frontières : le projet est également cité par des organisations internationales comme exemple d’infrastructure civique à faible coût et à grande échelle. Dans les universités, le projet est devenu un outil essentiel pour la recherche, servant de base à des études allant d’analyses approfondies sur le marché du travail des archéologues jusqu’à des solutions pratiques de recherche de prix de détail.

Gardien de la mémoire publique

En plus de faciliter l’accès actuel, le projet a assumé le rôle de gardien historique. Pendant des années, il a maintenu un miroir de données qui préservait des informations de périodes que le gouvernement fédéral a cessé de publier, comme l’intervalle entre octobre 2021 et avril 2022.

Malheureusement, ce sous-service a dû être désactivé à la fin de 2025. Comme je l’ai expliqué à l’époque dans une discussion sur la pérennité du projet, « le miroir consomme presque la totalité des revenus du projet ». Restaurer cette fonctionnalité et garantir la préservation de ces données historiques demeure l’un des grands objectifs à long terme pour la santé publique des données au Brésil.

Soutenez le projet

Maintenir une infrastructure qui dessert des millions d’accès quotidiens a des coûts. Bas, certes, mais réels.

Le projet est maintenu de façon indépendante et survit grâce au soutien de la communauté par le biais d’APOIA.se ou de Pix, en utilisant la clé d6ede813-6621-4df4-9a93-8d0108fd9b6a.

Si Minha Receita vous est utile, à vous ou à votre entreprise, considérez soutenir le projet pour le maintenir en ligne et stable.