Entité de marque et JSON-LD · Skill /geo-entite

Ce que ce Skill change

Le problème

La marque s'écrit de trois façons, deux extensions balisent chacune l'organisation, une note de 4,8 est balisée sans être affichée : les moteurs voient plusieurs entités floues.

Avec ce Skill

Les noms relevés source par source, les blocs à fusionner, les profils à corriger, et un bloc JSON-LD rempli seulement avec des informations vraies et visibles.

Comment ça marche

Un Skill est un mode d'emploi que ton IA garde sous la main. Concrètement :

I
Tu installes le Skill une seule fois dans ton IA (2 minutes, sans code).
II
Tu fais ta demande comme d'habitude, en langage courant.
III
Ton IA reconnaît la tâche et applique la méthode du Skill : même structure, même niveau d'exigence, à chaque fois.

Ce que tu peux lui demander

Une fois le Skill installé, copie une de ces demandes dans ta conversation.

« /geo-entite https://www.monsite.fr »
Les variantes du nom et le bloc à coller.
« ChatGPT nous confond avec une autre société : que faire ? »
Noms, sameAs, Wikidata et homonymes.

Variantes sectorielles

Tu travailles dans un secteur spécifique ? Propose ta variante ou ta propre ressource.

Le fichier complet, tel que ton IA le lira (149 lignes). Tu peux l'adapter librement.

Télécharger

name: geo-entite
description: Vérifie que la marque est une seule entité, nommée pareil partout, pour que les moteurs et les modèles ne la confondent ni avec un homonyme ni avec un concurrent : nom dans le title (coupé au bon séparateur), og:site_name, H1, JSON-LD (Organization et tous ses sous-types, @graph) et mention ©, un seul bloc Organization avec @id, logo et sameAs, profils sameAs classés et appelés, valeurs du JSON-LD visibles sur la page (une note ou un prix balisé mais invisible est critique), candidats Wikidata à confirmer. Produit le bloc JSON-LD à coller, rempli seulement avec du vrai. Utilise-le pour « schema », « JSON-LD », « données structurées », « entité de marque », « sameAs », « Wikidata », « l'IA nous confond avec une autre société ». Pas pour les erreurs factuelles des IA (/geo-exactitude) ni la présence sur les sites tiers (/geo-mentions). Aucun balisage « pour l'IA ».

geo-entite

Un modèle ne connaît pas un site, il connaît des entités : une marque, ses produits, ses dirigeants, reliés entre eux. Si la marque s'appelle « Assurly » dans le title, « Assur.ly » dans og:title et « Assurly Courtage » dans le JSON-LD, si son sameAs pointe vers le profil personnel d'une salariée, les moteurs ont plusieurs entités floues au lieu d'une. Ce Skill aligne les noms et les profils, et ne balise que ce qui est vrai et visible.

Google le dit : aucune donnée structurée n'est requise pour les Aperçus IA et aucune n'est propre à l'IA. Elles servent à décrire l'entité et aux résultats enrichis encore actifs. Pas de promesse de citation.

À lire avant de commencer : commun/regles.md et commun/preuves.md (§2 Google). site-context.md donne le nom officiel, la raison sociale et les profils.

1. Lancer le contrôle

python3 scripts/entite.py https://www.site.fr/ --marque "Assurly"
python3 scripts/entite.py accueil.html --marque "Assurly" --verifier --wikidata
python3 scripts/entite.py accueil.html --marque "Assurly" --bloc

Sur la page d'accueil d'abord, puis la page « à propos » et une page produit. --verifier appelle chaque lien sameAs ; --wikidata cherche la marque sur Wikidata (API publique, sans clé).

2. Ce que le script contrôle

Bloc	Contrôle	Pourquoi
Noms	title, og:site_name, og:title, H1, JSON-LD, mention © : la marque, une variante ou rien	un nom déclaré (JSON-LD, og:site_name, ©) doit être la marque, forme juridique mise à part ; un title ou un H1 peut la contenir
Séparateurs	le title se coupe à chaque `\|`, `–`, `—`, `-`, `·`, `:` entourés d'espaces	« Guide \| Assurly » et « Assurly – Guide » donnent la marque ; « Coca-Cola » reste entier
Organisation	un seul bloc, ou des blocs reliés par le même `@id` ; `@id`, `url`, `logo`, `sameAs` présents	deux blocs aux noms différents (thème et extension) font deux entités
Sous-types	`InsuranceAgency`, `Restaurant`, `Dentist`, `@type` en liste… comptent comme Organization	un commerce local est une organisation
sameAs	plateformes reconnues, doublons, lien non https, profil LinkedIn personnel	l'organisation pointe vers ses propres profils
Visible	téléphone, e-mail, adresse, prix, note, nombre d'avis retrouvés dans le texte	un avis ou un prix balisé sans être affiché est contraire aux règles de Google sur les données structurées
FAQ, HowTo	signalés	plus de résultat enrichi FAQ depuis le 7 mai 2026 ; HowTo retiré

Sans exécution de code : relève les mêmes noms à la main (code source de la page, Ctrl+U) et applique le tableau.

3. Corriger

Dans l'ordre :

Un nom. Choisis la forme officielle (celle du logo et de site-context.md) et aligne title, og:site_name, JSON-LD et ©. La raison sociale va dans legalName, les autres écritures dans alternateName.
Un bloc Organization par site, avec un @id stable (https://www.site.fr/#organization) que les autres blocs référencent. Deux extensions qui balisent chacune : en désactiver une.
sameAs : page entreprise LinkedIn (pas un profil personnel), chaîne YouTube, Wikidata et Wikipédia s'ils existent, fiche Google, et les annuaires officiels (annuaire des entreprises). Les personnes ont leur propre bloc Person.
Visible ou retiré : une note, un nombre d'avis ou un prix balisé doit être affiché sur la même page. Sinon, on retire le balisage.
Le bloc à coller (--bloc) : il reprend les valeurs vraies du site, retire profils personnels et doublons, et met {{à compléter}} ailleurs. Modèles pour article, auteur, produit, service et commerce local : references/jsonld.md.
Valider : test des résultats enrichis de Google (search.google.com/test/rich-results) et validator.schema.org. Donne les deux liens ; l'utilisateur publie.

4. Wikidata et homonymes

Wikidata relie une entité à ses identifiants (site, SIREN, profils). Le script liste des candidats ; seul l'utilisateur confirme qu'un élément est bien sa marque. Créer un élément, gérer un homonyme, aligner les profils tiers : references/entite.md.

5. La sortie (format fixe)

ENTITÉ · accueil-assurly.html · marque lue : « Assurly »

NOMS (JSON-LD, og:site_name et © doivent être la marque ; title et H1 peuvent la contenir)
  ok       title                                        « Assurly »
  VARIANTE og:title                                     « Assur.ly, la mutuelle des indépendants »
  VARIANTE JSON-LD Organization.name                    « Assurly Courtage »
ORGANISATION · 2 bloc(s) · types JSON-LD : FAQPage, InsuranceAgency, LocalBusiness, Organization, WebSite
  manque : logo
  ! 2 blocs Organization aux noms différents
  ! sameAs vers un profil LinkedIn personnel
SAMEAS · 3 profil(s)
JSON-LD VISIBLE · 4/6 valeurs vérifiables retrouvées sur la page
  CRITIQUE InsuranceAgency/LocalBusiness.aggregateRating.ratingValue = 4.8 : note balisé mais absent du texte visible

Exemple fictif (evals/geo-entite/). Sous la sortie : 3 corrections au plus, puis le bloc si l'utilisateur le demande.

Erreurs et cas limites

Situation	Que faire
Page en 403 ou non lue	Demander le HTML enregistré depuis le navigateur ; relancer sur le fichier.
JSON-LD injecté en JavaScript	Absent du HTML serveur : le dire, et demander le code de la page rendue (outil d'inspection) ; Google le lit souvent, d'autres robots non [à vérifier par moteur].
JSON-LD invalide	Le script ignore le bloc et le signale (« bloc JSON-LD illisible ») ; le corriger d'abord.
Wikidata en 429 ou non lu	« NON LU » : chercher la marque sur wikidata.org à la main.
Marque au nom commun (« Orange », « Alan »)	`alternateName` et `sameAs` complets ; `/geo-exactitude` avec les homonymes en `--concurrent`.
Plusieurs marques sur un site	Un bloc Organization pour la société, des blocs `Brand` pour les marques produits.
Coordonnées absentes de l'accueil	Normal si elles figurent sur la page contact : ligne « info », pas une erreur.

Ressources

scripts/entite.py · commun/page.py
references/jsonld.md : modèles Organization, WebSite, article et auteur, produit, service, commerce local.
references/entite.md : Wikidata, homonymes, profils tiers à aligner.

Skills liés

/geo-exactitude (ce que les IA disent de la marque), /geo-mentions (profils tiers et sources), /geo-contenu (la page « à propos »), /seo-local (fiche Google et commerce local, pack SEO).

Règles du pack

Zéro invention : pas de note, d'avis, de prix, de date ni de profil ajouté au balisage sans être vrai et visible.
Rien n'est publié : le bloc est proposé, l'utilisateur l'installe.
Texte simple dans la conversation ; seul le bloc JSON-LD va dans un bloc de code.

Démo bientôt disponible

Une démonstration (demande d'exemple → résultat) arrive prochainement. En attendant, installe le Skill et teste-le sur tes propres cas.

Comment installer le Skill « /geo-entite · Entité de marque et JSON-LD » ?

En deux minutes, sans code : 1) Télécharge le fichier depuis le bouton « Télécharger » de cette page. 2) Sur Claude : Personnaliser → Skills → importe le fichier (le bouton « Importer dans Claude » t'y emmène directement). Sur ChatGPT, Gemini ou Mistral, suis les étapes de l'encadré « Installer » selon ton IA. 3) Commence à converser : « /geo-entite · Entité de marque et JSON-LD » s'active dès que ta demande correspond.

« /geo-entite · Entité de marque et JSON-LD » fonctionne-t-il avec ChatGPT ou seulement Claude ?

Tous nos Skills sont conçus et testés en priorité sur Claude (Anthropic), notre environnement de référence. Il est pleinement compatible avec Claude, et partiellement avec ChatGPT, Gemini et Mistral. Les badges de compatibilité en haut de page indiquent le niveau exact par IA.

Qu'est-ce que « /geo-entite · Entité de marque et JSON-LD » me fait gagner concrètement ?

Il prend en charge les étapes répétitives de la tâche (structure, vérifications, rédaction) pour que tu te concentres sur les décisions. Les mesures de temps gagné seront publiées à partir des retours des premiers utilisateurs.

Ai-je besoin de compétences techniques pour utiliser « /geo-entite · Entité de marque et JSON-LD » ?

Non. Aucun terminal, aucune clé API, aucun code à manipuler. Si tu sais télécharger un fichier et l'importer dans ton IA, tu sais utiliser « /geo-entite · Entité de marque et JSON-LD ». C'est justement la cible : rendre l'IA accessible aux marketeurs non-techniques.

Puis-je modifier « /geo-entite · Entité de marque et JSON-LD » et l'utiliser pour mes clients ?

Oui. « /geo-entite · Entité de marque et JSON-LD » est gratuit et open-source (licence MIT). Tu peux le forker, l'adapter à ton entreprise ou à tes clients, et redistribuer ta version, à condition de citer l'auteur original et Join Médicis.

Une autre question ? Écris-nous.