JPFW SEO

01

Ce qu'il fallait, et ce que j'ai construit

Beaucoup de sites d'entreprises au Cameroun sont introuvables sur Google, et leurs propriétaires ne savent pas pourquoi. Les outils d'audit existent, mais ils sont en anglais, écrits pour des spécialistes du SEO, et pleins d'alertes qui ne sont pas de vrais problèmes. Le propriétaire ne sait pas ce qui compte, et un rapport avec de fausses alertes perd sa confiance.

01 · Des mots simples

ProblèmeLes outils d'audit parlent aux spécialistes du SEO. Un chef d'entreprise ne sait pas ce qui compte ni quoi faire.

ConstruitChaque problème dit ce qu'il change et quoi faire, avec des exemples du site. Les trois à corriger en premier ouvrent le rapport.

Messages en français et en anglais avec les mêmes variables, de vrais pluriels, et la note technique repliée pour le développeur

02 · Confiance

ProblèmeUne fausse alerte dans un rapport fait douter le propriétaire de tout le reste.

ConstruitLes vérifications ne se déclenchent que sur une preuve claire, et le rapport dit ce qu'il n'a pas pu vérifier au lieu d'affirmer qu'il n'y a pas de problème.

Des sites enregistrés rejoués hors ligne : le test exige exactement les constats attendus, dans l'ordre

03 · Plusieurs sites

ProblèmeAuditer plusieurs sites un par un, puis comparer à la main avec le mois dernier, prend un après-midi.

ConstruitUne file de 20 sites maximum avec une barre de progression en direct, et chaque rapport comparé avec l'analyse précédente du site.

Une analyse à la fois, pour que les mesures de vitesse ne se gênent pas ; chaque analyse enregistrée en JSON avec son rapport

02

Comment c'est construit

J'ai construit un moteur de diagnostic et une petite application qui le lance. Le moteur lit les pages du site comme Google, puis vérifie les titres, les liens, les redirections, les données structurées, les informations d'entreprise locale, la vitesse sur téléphone et ce que les assistants IA peuvent lire. Chaque problème explique ce qu'il change, quoi faire, avec des exemples pris sur le site, et une note repliée pour le développeur. Le rapport commence par les trois choses à corriger en premier, et s'imprime en PDF prêt à envoyer.

Langage

TypeScript on Node.js 22Un seul langage du robot au rapport. Node exécute le TypeScript directement, donc pas d'étape de compilation qui casse.

Robot

Crawlee + CheerioCrawlee gère la file, les nouvelles tentatives, robots.txt et le rythme ; Cheerio lit le HTML sans navigateur, ce qui est rapide.

Vitesse

Lighthouse + PuppeteerLes mêmes mesures que Google, dans un vrai Chrome sur un téléphone simulé, dans un module à part pour que le robot reste léger.

Interface

Plain HTML, no frameworkUne application locale sur 127.0.0.1 avec quelques pages. Du HTML simple n'a rien à compiler ni à mettre à jour.

Tests

Vitest + recorded sitesChaque vérification est testée sur des sites avec des problèmes plantés et sur de vrais sites enregistrés à l'octet près, hors ligne et identiques à chaque fois.

Distribution

GitHub Actions + ReleasesChaque fusion est testée sur Linux et Windows, empaquetée, et publiée comme mise à jour que l'application installe seule après avoir vérifié son empreinte.

03

Ce qui était difficile

• Pas de fausses alertes. Un rapport qui signale ce qui n'est pas un problème perd la confiance du propriétaire. Chaque vérification est testée sur 18 sites avec des problèmes plantés et des pièges, et sur 7 vrais sites enregistrés et revus constat par constat : un test échoue si un problème est manqué ou si un problème qui ne devrait pas apparaître apparaît.
• Même site, même rapport. Les serveurs répondent dans un ordre aléatoire, donc une limite de pages pouvait couper l'exploration à une page différente à chaque fois. Le robot lit les pages par vagues, dans l'ordre des liens, donc deux analyses du même site s'arrêtent au même endroit.
• Les menus construits en JavaScript. Certains sites n'ont aucun lien dans leur HTML, donc l'analyse s'arrêtait à la page d'accueil. L'outil ouvre maintenant la page d'accueil dans Chrome et suit les liens qui apparaissent une fois le JavaScript exécuté.
• Les mises à jour sur données mobiles. Le paquet complet pèse 74 Mo. Chaque version enregistre une empreinte de Node.js et des bibliothèques ; quand elle n'a pas changé, l'application ne télécharge que le code, environ 1 Mo.

04

Résultat

C'est un outil fonctionnel que j'utilise pour mes audits : une application Windows qui se met à jour seule, avec 865 tests automatisés lancés sur Linux et Windows à chaque modification. Le code est dans un dépôt privé ; l'exemple de rapport montre exactement ce que reçoit un client.

05

Écrans

6 écrans · touchez pour agrandir