GuidesSEO technique

Tuto : un maillage interne automatique avec les embeddings

Par l’équipe Banzai LabsMis à jour le 2 min de lecture

Les pages proches en sens se lient entre elles
Chaque page est reliée aux pages les plus proches par le sens, calculées avec des embeddings.

1. Un vecteur par page

// scripts/embeddings.ts : exécuté avant le build
const pages = await chargerPages(); // titre, résumé, url
for (const p of pages) {
  if (cache[p.url]?.hash === hash(p.titre + p.resume)) continue;
  cache[p.url] = { hash: hash(p.titre + p.resume), v: await embed(`${p.titre}. ${p.resume}`) };
}
await ecrire('src/data/embeddings.json', cache);

2. Les voisines

const cos = (a: number[], b: number[]) => {
  let p = 0, na = 0, nb = 0;
  for (let i = 0; i < a.length; i++) { p += a[i] * b[i]; na += a[i] ** 2; nb += b[i] ** 2; }
  return p / Math.sqrt(na * nb);
};

export function voisines(url: string, n = 4, seuil = 0.5) {
  const v = cache[url].v;
  return Object.entries(cache)
    .filter(([u]) => u !== url)
    .map(([u, e]) => ({ u, s: cos(v, e.v) }))
    .filter((x) => x.s >= seuil)
    .sort((a, b) => b.s - a.s)
    .slice(0, n);
}

3. Le bloc « À lire aussi »

  1. 1Quatre liensLes plus proches au-dessus du seuil.
  2. 2Ancre = titreClair pour le lecteur et le moteur.
  3. 3Même langueOn filtre par langue avant de comparer.

4. Les réglages

Réglage Effet
Seuil de similarité Évite des liens sans rapport sur les pages isolées
Liens manuels prioritaires Une page pilier peut imposer ses liens
Exclusions Mentions légales, pages de contact

Les vecteurs : les embeddings expliqués. Le suivi : brancher Google Search Console.

Questions fréquentes

Combien de liens par page ?
Trois à cinq dans un bloc dédié suffisent. Au-delà, chaque lien perd de son intérêt pour le lecteur comme pour les moteurs.
Quel texte d’ancre utiliser ?
Le titre de la page cible, ou une version courte. Il dit au lecteur et au moteur de quoi parle la page.
Faut-il recalculer à chaque build ?
Les embeddings, seulement pour les pages modifiées : on garde un cache. Le calcul des voisines, lui, est instantané.

À lire ensuite

Tous les guides