Aller au contenu
SEO AI Pal
SEO AI PalS'inscrire

Cahier des charges

Un cahier des charges pour trouver les backlinks de site web sans laisser le modèle improviser

L'accès aux outils ne représente que la moitié du travail. L'autre moitié est un prompt système qui amène l'assistant à dire ce qu'il a fait et à s'arrêter lorsque l'outil indique non.

Équipe de recherche SEO AI Pal ·

Étau en fer serrant une corde épaisse reliant deux piliers de pierre

Partez de l'échec que vous souhaitez prévenir

Lorsqu'un résultat d'outil est manquant, un assistant comble souvent ce vide avec quelque chose de plausible. Demandez-lui de trouver des backlinks de site web sans rien d'utilisable sous les yeux, et la réponse peut sembler aussi soignée qu'une réponse réelle. Le ton est identique dans les deux cas. Chaque ligne du prompt ci-dessous ferme une telle faille.

Traitez le prompt comme un cahier des charges, et non comme une formule magique. Chaque règle numérotée correspond à un problème qui survient en pratique. Les appels manqués arrivent en premier. Les nouvelles tentatives silencieuses ensuite, puis les nombres mémorisés plus tôt dans la conversation, et enfin une note manquante sur l'actualisation mensuelle.

Le prompt système, six règles

Collez-le tel quel, puis modifiez les noms des actions pour qu'ils correspondent à ce que vous avez exposé.

text
You answer backlink questions ONLY from tool results.

1. For any question about links, call the tool. Never answer from memory.
2. After each call, print the `ok` value and the `_credits` remaining.
3. If ok is false, or the status is 401 or 402, say that in one line
   and stop. Do not retry more than once.
4. Name the action you used (overview, refdomains, anchors, toppages).
5. The data is refreshed about monthly. Mention it when a link is missing.
6. Never state a number you did not receive in this chat.

Tableau de décision : ce que fait l'assistant avec chaque résultat

Ce qui est revenuRéponse correcteRéponse incorrecte
ok est vrai, lignes présentesRésumez les lignes, citez _credits.Ajoutez les chiffres approximatifs issus de la mémoire.
ok est vrai, zéro ligneDites que l'index ne contient rien pour ce domaine pour le moment. Suggérez de vérifier l'orthographe et l'actualisation mensuelle.Dites que le domaine n'a aucun backlink.
HTTP 401Signalez une clé manquante ou incorrecte, arrêtez.Nouvelle tentative avec une clé inventée.
HTTP 402Signalez que les crédits sont épuisés, proposez le overview gratuit.Affirmez que le site est hors ligne.
Délai d'attente dépassé, pas de JSONDites que l'appel a échoué, ne donnez aucun chiffre.Décrivez ce que la réponse contenait probablement.
Ardoise blanche appuyée contre un mur de briques avec du matériel de peinture

Pourquoi le prompt ne peut pas contenir vos données

Un prompt définit des règles pour une conversation. Ce n'est pas une source de données. Les trois points ci-dessous couvrent les erreurs courantes, et chacun se termine par la solution.

Un prompt contient des règles, pas des chiffres

Certaines personnes collent un fichier JSON dans le prompt et s'attendent à ce que chaque nouvelle question l'utilise. Un prompt définit les règles pour une conversation, et ce n'est pas une base de données. Si les chiffres sont importants, récupérez-les. L'assistant doit effectuer un appel à chaque fois.

Citez l'appel, pas la mémoire. Les règles ci-dessus le disent déjà, et une réponse qui cite un appel est facile à vérifier. La configuration du GPT personnalisé montre où placer ces règles.

Le scraping échoue là où l'API ne plante pas

Certaines personnes demandent si les mêmes chiffres peuvent être extraits d'une page de résultats au lieu de passer par l'API. Le scraping d'une page fonctionne tant que la mise en page ne change pas. Les mises en page changent. Ensuite, le script ne retourne rien, ou retourne la mauvaise colonne.

Un appel API retourne les mêmes champs à chaque fois, c'est pourquoi le prompt peut les nommer. Supposons que vous testiez un scraper lundi et qu'il casse jeudi. C'est une tâche de maintenance. Ce n'est pas une lecture de backlink, et la conversation ne remarquera pas la différence. Si un collègue insiste pour faire du scraping, demandez-lui de nommer la mise en page attendue et la date à laquelle il vérifiera. Sans cela, personne ne sera responsable de la panne.

Les échecs silencieux et les mises à jour des fournisseurs

Les modèles changent, et les produits qui les enveloppent aussi. Une règle qui fonctionnait dans une version peut dériver dans la suivante. Rien ne l'annonce. Le remède est fastidieux : gardez l'ensemble de tests ci-dessous, et relancez-le après tout changement.

Conservez les trois mêmes domaines et les trois mêmes questions. Si les reçus cessent d'imprimer, la dérive se situe dans le prompt ou le modèle. Datez la première réponse incorrecte. Le journal des modifications montre alors ce qui a changé cette semaine.

Le passage hebdomadaire, cinq étapes

Exécutez les mêmes cinq étapes chaque semaine, avec la même formulation, afin qu'une différence provienne des données et non de votre formulation.

  1. 1

    Choisissez trois domaines que vous connaissez déjà

    Le vôtre, un concurrent, un grand site. Vous savez approximativement à quoi chacun devrait ressembler.

  2. 2

    Posez les trois mêmes questions

    Évaluation, domaines référents principaux, ancres. Même formulation chaque semaine, afin que les différences proviennent des données.

  3. 3

    Vérifiez les reçus

    Chaque réponse doit nommer une action et afficher _credits. Reçu manquant, test échoué.

  4. 4

    Vérifiez un chiffre avec curl

    Exécutez curl "https://seoaipal.com/api.php?action=refdomains&q=example.com&per=10&key=sk_live_..." et comparez les premières lignes. Deux crédits.

  5. 5

    Journalisez ce qui a dérivé

    Si le prompt a commencé à ignorer une règle, serrez cette règle. N'ajoutez pas plus de règles.

Trois habitudes qui cassent silencieusement le prompt

Dans une longue conversation, le modèle s'appuie davantage sur le texte récent que sur votre premier message. Les règles en haut s'estompent. Commencez une nouvelle conversation pour chaque client.

Supposons que vous colliez une capture d'écran des chiffres d'un autre fournisseur dans la même conversation. Le modèle peut mélanger les deux sources, et vous ne pourrez pas les démêler par la suite. Gardez une source par conversation.

Un peu de louange peut faire du mal. Dire au modèle qu'un chiffre correspond à ce que vous attendiez l'enseigne à la prochaine réponse à pencher dans la même direction. Si un chiffre semble incorrect, dites-le de manière neutre. Demandez le nom de l'action. Lorsqu'une réponse échoue, le tableau des erreurs vous indique si la faute est au prompt, à la clé ou aux données.

Avant que le prompt ne soit partagé à l'équipe

  • Mettez une version et une date en haut du prompt.
  • Vérifiez que chaque action nommée dans les règles existe dans votre schéma.
  • Exécutez le test à trois domaines et lisez les reçus, pas seulement le texte.
  • Donnez à chaque collègue sa propre conversation, avec une source de données par conversation.
  • Ajoutez la note sur l'actualisation mensuelle, afin qu'un lien manquant soit expliqué plutôt que nié.
Deux blocs de pierre côte à côte avec une règle non marquée

Les dates qui doivent figurer dans vos notes

Mettez une version et une date en haut du prompt, par exemple 2026-10-29, de la même manière que vous tagueriez du code. Ensuite, lorsqu'une réponse est étrange en mars, vous pouvez dire quelle formulation l'a produite.

Les conseils sur les liens évoluent aussi avec Google. La mise à jour principale de mars 2024 et la mise à jour spam d'août 2025 ont toutes deux déplacé ce dont les gens parlaient à propos des liens, et les prompts écrits avant eux supposaient des choses qui ne tenaient plus. Révisez les règles deux fois par an.

Gardez un court journal des modifications à côté du prompt. Trois lignes par changement suffisent. Cela transforme un mystère en un diff.

Gardez l'ensemble de tests petit et ennuyeux

Le passage hebdomadaire ne fonctionne que si l'ensemble de tests reste le même. Choisissez-le une fois, notez-le, et résistez à l'envie d'échanger les domaines lorsqu'un résultat semble étrange.

Choisissez des domaines que vous pouvez juger à l'œil

Votre propre site est le premier choix, car vous connaissez mieux ses liens que quiconque. Un concurrent que vous suivez de près vient en deuxième. Un très grand site constitue un troisième utile. Son ampleur est facile à juger.

Évitez un domaine tout nouveau comme test. Ses chiffres sont bruyants. Une dérive dans la réponse vous apprend peu. Choisissez des sites avec un historique visible. Incluez un site dont les liens vous avez lus à la main, car c'est votre vérité terrain.

Posez les trois mêmes questions dans les mêmes termes

Gardez la formulation fixe. Évaluation, domaines référents principaux et ancres, posés de la même manière chaque semaine. Changer la formulation change la réponse, et alors vous ne pouvez pas dire si les données ont bougé ou si la question a changé.

Stockez les trois réponses en texte brut à côté du prompt. Dans un mois, une comparaison côte à côte vous en apprendra plus que n'importe quel souvenir de ce à quoi la conversation ressemblait.

Évaluez le coût du test avant de le lancer

Chaque appel payant dans le test coûte des crédits, donc le test a aussi un prix. L'évaluation est gratuite, ce qui laisse deux questions payantes par domaine.

Trois domaines et deux questions payantes font six appels à 2 crédits chacun, donc le passage hebdomadaire coûte douze crédits, soit environ 0,0012 $. Écrivez ce chiffre sur la feuille de test, et vérifiez-le contre le solde une fois par mois.

Que faire lorsque le test échoue

Un test échoué est une information. Réécrivez en dernier. Vérifiez d'abord les reçus, puis les codes d'état, puis l'orthographe du domaine. Seulement après ces trois vérifications devez-vous toucher aux règles.

Changez une règle à la fois. Deux modifications à la fois rendent la prochaine erreur impossible à expliquer.

Conservez aussi la réponse échouée. Collez-la dans le journal des modifications avec la date et la règle que vous avez modifiée. Ce registre est le seul moyen de distinguer une vraie correction d'une réponse chanceuse lors du prochain lancement.

Questions que les équipes posent à propos de ce prompt

Puis-je raccourcir les règles pour économiser des tokens ?

Vous le pouvez, mais coupez les mots plutôt que les règles. Chaque ligne numérotée ferme une erreur que vous pouvez imaginer. Fusionnez deux lignes qui disent une seule chose. Laissez la règle des reçus seule.

Le prompt remplace-t-il la lecture des données ?

Non. Il amène l'assistant à rapporter ce qu'il a lu. Une évaluation et une liste de domaines référents ont encore besoin de vos yeux, surtout lorsqu'un chiffre vous surprend.

Quelle action l'assistant devrait-il essayer en premier ?

Commencez par overview, qui est gratuit, et passez à refdomains lorsque vous avez besoin de la liste. Rating et liens répondent à des questions différentes, donc un seul appel ne couvrira pas les deux.

Combien coûte le passage hebdomadaire ?

Avec l'ensemble de tests ci-dessus, deux questions payantes pour chacun des trois domaines, le passage utilise environ douze crédits. C'est un petit nombre, et il est utile de le noter pour que la vérification mensuelle du solde ait une base de référence.

Que faire si l'équipe veut une règle que le prompt n'a pas ?

Ajoutez-la au journal des modifications avec une date et une raison, puis testez-la sur les trois domaines. Une nouvelle limite écrite une fois est plus facile à auditer qu'une instruction tapée au milieu d'une session.

Notre position

Les reçus battent le ton

Nous préférerions avoir un assistant ennuyeux qui imprime un nom d'action et un solde plutôt qu'un assistant fluide qui a l'air sûr de lui. La fluidité est bon marché. Un premier regard sur l'explication montre pourquoi.