Runbook
Un runbook per trovare i backlink del sito web senza lasciare che il modello improvvisi
L'accesso agli strumenti è metà del lavoro. L'altra metà è un prompt di sistema che fa sì che l'assistente dica cosa ha fatto e si fermi quando lo strumento restituisce un risultato negativo.
Team di ricerca di SEO AI Pal ·

Parti dal fallimento che vuoi prevenire
Quando il risultato di uno strumento è assente, un assistente spesso colma il vuoto con qualcosa di plausibile. Chiedigli di trovare i backlink del sito web senza nulla di utilizzabile davanti, e la risposta può sembrare ordinata come una vera. Stesso tono in entrambi i casi. Ogni riga del prompt qui sotto chiude una di queste lacune.
Tratta il prompt come un runbook, non come una formula magica. Ogni regola numerata corrisponde a qualcosa che va storto nella pratica. Le chiamate saltate vengono per prime. I retry silenziosi vengono dopo, poi i numeri ricordati da prima nella chat e, infine, una nota mancante sul refresh mensile.
Il prompt di sistema, sei regole
Incollalo così com'è, poi modifica i nomi delle azioni per adattarli a ciò che hai esposto.
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.Tabella delle decisioni: cosa fa l'assistente con ogni risultato
| Cosa è tornato | Risposta corretta | Risposta errata |
|---|---|---|
ok è true, righe presenti | Riassumi le righe, cita _credits. | Aggiungi le cifre "circa" dalla memoria. |
ok è true, zero righe | Dì che l'indice non contiene nulla per quel dominio ancora. Suggerisci di verificare l'ortografia e il refresh mensile. | Dì che il dominio non ha backlink affatto. |
| HTTP 401 | Segnala una chiave mancante o errata, fermati. | Riprova con una chiave inventata. |
| HTTP 402 | Segnala che i crediti sono esauriti, offri il overview gratuito. | Afferma che il sito è giù. |
| Timeout, nessun JSON | Dì che la chiamata è fallita, non dare numeri. | Descrivi cosa conteneva probabilmente la risposta. |

Perché il prompt non può contenere i tuoi dati
Un prompt stabilisce regole per una chat. Non è una fonte di dati. I tre punti seguenti coprono dove le persone sbagliano, e ognuno termina con la soluzione.
Un prompt contiene regole, non numeri
Alcuni incollano un file JSON nel prompt e si aspettano che ogni nuova domanda lo utilizzi. Un prompt stabilisce le regole per una chat, e non è un database. Se le cifre sono importanti, recuperale. L'assistente dovrebbe fare una chiamata ogni volta.
Cita la chiamata, non la memoria. Le regole sopra lo dicono già, e una risposta che cita una chiamata è facile da verificare. La configurazione del GPT personalizzato mostra dove vanno queste regole.
Lo scraping si rompe dove l'API non lo fa
Alcuni chiedono se le stesse cifre possono essere estratte da una pagina dei risultati invece. Lo scraping di una pagina funziona finché il layout non cambia. I layout cambiano. Poi lo script non restituisce nulla, o la colonna sbagliata.
Una chiamata API restituisce gli stessi campi ogni volta, ed è per questo che il prompt può nominarli. Supponi di testare uno scraper lunedì e che si rompa giovedì. Questo è un lavoro di manutenzione. Non è una lettura dei backlink, e la chat non noterebbe la differenza. Se un collega insiste per fare scraping, chiedigli di nominare il layout che si aspetta e la data in cui lo controllerà. Senza quello, nessuno si assume la responsabilità del guasto.
Fallimenti silenziosi e aggiornamenti del fornitore
I modelli cambiano, e così i prodotti che li avvolgono. Una regola che funzionava in una versione può derivare nella successiva. Nulla lo annuncia. La cura è noiosa: tieni il set di test qui sotto, e rieseguilo dopo qualsiasi modifica.
Mantieni gli stessi tre domini e le stesse tre domande. Se le ricevute smettono di stamparsi, la deriva è nel prompt o nel modello. Data la prima risposta errata. Il changelog mostra poi cosa è cambiato quella settimana.
Il controllo settimanale, cinque mosse
Esegui le stesse cinque mosse ogni settimana, con la stessa formulazione, così che una differenza derivi dai dati e non dalla tua formulazione.
- 1
Scegli tre domini che già conosci
Il tuo, un concorrente, un grande sito. Conosci approssimativamente come dovrebbe apparire ciascuno.
- 2
Fai le stesse tre domande
Valutazione, domini che rimandano principali, anchor text. Stessa formulazione ogni settimana, così le differenze derivano dai dati.
- 3
Verifica le ricevute
Ogni risposta deve nominare un'azione e stampare
_credits. Ricevuta mancante, test fallito. - 4
Verifica un numero con curl
Esegui
curl "https://seoaipal.com/api.php?action=refdomains&q=example.com&per=10&key=sk_live_..."e confronta le prime righe. Due crediti. - 5
Registra cosa è derivato
Se il prompt ha iniziato a ignorare una regola, stringi quella regola. Non aggiungere altre regole.
Tre abitudini che rompono silenziosamente il prompt
In una chat lunga, il modello si affida al testo recente più che al tuo primo messaggio. Le regole in cima scivolano. Inizia una nuova chat per ogni cliente.
Supponi di incollare uno screenshot dei numeri di un altro fornitore nella stessa conversazione. Il modello potrebbe mescolare le due fonti, e non sarai in grado di separarle dopo. Mantieni una fonte per chat.
Un po' di lode può fare danno. Dire al modello che un numero corrisponde a ciò che ti aspettavi insegna alla risposta successiva ad inclinarsi nella stessa direzione. Se un numero sembra sbagliato, dillo in modo neutrale. Chiedi il nome dell'azione. Quando una risposta va male, la tabella degli errori ti dice se la colpa è del prompt, della chiave o dei dati.
Prima che il prompt vada a un team
- Metti una versione e una data in cima al prompt.
- Verifica che ogni azione nominata nelle regole esista nel tuo schema.
- Esegui il test dei tre domini e leggi le ricevute, non solo la prosa.
- Dai a ogni collega la propria chat, con una fonte di dati per chat.
- Aggiungi la nota sul refresh mensile, così un link mancante sia spiegato piuttosto che negato.

Date che appartengono alle tue note
Metti una versione e una data in cima al prompt, ad esempio 2026-10-29, nel modo in cui faresti taggare il codice. Poi, quando una risposta diventa strana a marzo, puoi dire quale formulazione l'ha prodotta.
I consigli sui link si muovono anche con Google. L'aggiornamento principale di marzo 2024 e l'aggiornamento spam di agosto 2025 hanno entrambi spostato ciò di cui le persone chiedevano riguardo ai link, e i prompt scritti prima di loro assumevano cose che non erano più valide. Rivedi le regole due volte all'anno.
Tieni un breve changelog accanto al prompt. Tre righe per modifica sono sufficienti. Trasforma un mistero in un diff.
Mantieni il set di test piccolo e noioso
Il controllo settimanale funziona solo se il set di test rimane lo stesso. Sceglielo una volta, scrivilo e resisti all'impulso di scambiare i domini quando un risultato sembra strano.
Scegli domini che puoi giudicare a occhio
Il tuo sito è la prima scelta, perché conosci i suoi link meglio di chiunque altro. Un concorrente che segui da vicino viene secondo. Un sito molto grande costituisce un terzo utile. La sua scala è facile da giudicare.
Evita un dominio appena creato come test. I suoi numeri sono rumorosi. Una deriva nella risposta ti dice poco. Scegli siti con una storia che puoi vedere. Includi un sito i cui link hai letto a mano, perché è la tua verità fondamentale.
Fai le stesse tre domande con le stesse parole
Mantieni la formulazione fissa. Valutazione, domini che rimandano principali e anchor text, chiesti nello stesso modo ogni settimana. Cambiare la formulazione cambia la risposta, e poi non puoi dire se i dati sono cambiati o la domanda.
Archivia le tre risposte come testo semplice accanto al prompt. Tra un mese, un confronto fianco a fianco ti dirà più di qualsiasi ricordo su come si sentiva la chat.
Valuta il test prima di eseguirlo
Ogni chiamata a pagamento nel test costa crediti, quindi il test ha un prezzo. La valutazione è gratuita, il che lascia due domande a pagamento per dominio.
Tre domini e due domande a pagamento equivalgono a sei chiamate a 2 crediti ciascuna, quindi il controllo settimanale costa dodici crediti, circa $0.0012. Scrivi quella cifra sul foglio del test, e controllala contro il saldo una volta al mese.
Cosa fare quando il test fallisce
Un test fallito è un'informazione. Riscrivi per ultimo. Prima controlla le ricevute, poi i codici di stato, poi l'ortografia del dominio. Solo dopo quelle tre dovresti toccare le regole.
Cambia una regola alla volta. Due modifiche contemporanee rendono impossibile spiegare il prossimo fallimento.
Tieni anche la risposta fallita. Incollala nel changelog con la data e la regola che hai cambiato. Quel record è l'unico modo per distinguere una vera correzione da una risposta fortunata nella prossima esecuzione.
Domande che i team pongono su questo prompt
Posso accorciare le regole per risparmiare token?
Puoi, ma taglia le parole piuttosto che le regole. Ogni riga numerata chiude un fallimento che puoi immaginare. Unisci due righe che dicono una cosa. Lascia la regola delle ricevute intatta.
Il prompt sostituisce la lettura dei dati?
No. Fa sì che l'assistente rapporta ciò che ha letto. Una valutazione e un elenco di domini che rimandano hanno ancora bisogno dei tuoi occhi, specialmente quando un numero ti sorprende.
Quale azione dovrebbe provare prima l'assistente?
Inizia con overview, che è gratuito, e passa a refdomains quando hai bisogno dell'elenco. Valutazione e link rispondono a domande diverse, quindi una chiamata non coprirà entrambe.
Quanto costa il controllo settimanale?
Con il set di test sopra, due domande a pagamento per ciascuno di tre domini, il controllo utilizza circa dodici crediti. È un numero piccolo, ed è utile scriverlo così che il controllo mensile del saldo abbia una linea di base.
Cosa succede se il team vuole una regola che il prompt non ha?
Aggiungila al changelog con una data e una ragione, poi testala sui tre domini. Un limite nuovo scritto una volta è più facile da auditare rispetto a un'istruzione digitata nel mezzo di una sessione.
La nostra posizione
Le ricevute battono il tono
Preferiremmo un assistente noioso che stampa un nome di azione e un saldo piuttosto che uno fluido che sembra sicuro. La fluidità è economica. Una prima occhiata alla spiegazione mostra perché.