Runbook

Um runbook para encontrar backlinks de sites sem deixar o modelo improvisar

O acesso às ferramentas é metade do trabalho. A outra metade é um prompt do sistema que faz o assistente dizer o que fez e parar quando a ferramenta diz que não.

Equipe de pesquisa da SEO AI Pal · Atualizado 2026-10-29

Garras de ferro apertando uma corda grossa conectando dois pilares de pedra

Comece pela falha que você quer evitar

Quando o resultado de uma ferramenta está ausente, um assistente frequentemente preenche a lacuna com algo plausível. Peça a ele para encontrar backlinks de sites sem nada utilizável à frente, e a resposta pode parecer tão organizada quanto uma real. O mesmo tom em ambos os casos. Cada linha do prompt abaixo fecha uma dessas lacunas.

Trate o prompt como um runbook, não como uma feitiçaria. Cada regra numerada mapeia algo que dá errado na prática. Chamadas puladas vêm primeiro. Retentativas silenciosas vêm a seguir, depois números lembrados de antes na conversa e, por último, uma nota ausente sobre a atualização mensal.

O prompt do sistema, seis regras

Cole-o exatamente como está, depois edite os nomes das ações para corresponder ao que você expôs.

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.

Tabela de decisão: o que o assistente faz com cada resultado

O que voltou	Resposta correta	Resposta errada
`ok` é verdadeiro, linhas presentes	Resuma as linhas, cite `_credits`.	Adicione figuras "aproximadamente" da memória.
`ok` é verdadeiro, zero linhas	Diga que o índice não contém nada para aquele domínio ainda. Sugira verificar a ortografia e a atualização mensal.	Diga que o domínio não tem backlinks de forma alguma.
HTTP 401	Relate uma chave ausente ou inválida, pare.	Retente com uma chave inventada.
HTTP 402	Relate que os créditos acabaram, ofereça o `overview` gratuito.	Afirme que o site está fora do ar.
Tempo esgotado, sem JSON	Diga que a chamada falhou, não dê números.	Descreva o que a resposta provavelmente continha.

Lousa branca apoiada contra uma parede de tijolos com suprimentos de pintura

Por que o prompt não pode reter seus dados

Um prompt define regras para uma conversa. Ele não é uma fonte de dados. Os três pontos abaixo cobrem onde as pessoas erram, e cada um termina com a correção.

Um prompt contém regras, não números

Algumas pessoas colam um arquivo JSON no prompt e esperam que cada nova pergunta o utilize. Um prompt define as regras para uma conversa, e não é um banco de dados. Se as figuras importam, busque-as. O assistente deve fazer uma chamada toda vez.

Cite a chamada, não a memória. As regras acima já dizem isso, e uma resposta que cita uma chamada é fácil de verificar. A configuração do GPT personalizado mostra onde essas regras vão.

A raspagem quebra onde a API não quebra

Algumas pessoas perguntam se as mesmas figuras podem ser extraídas de uma página de resultados em vez disso. Rastrear uma página funciona até que o layout mude. Os layouts mudam. Então o script retorna nada, ou a coluna errada.

Uma chamada de API retorna os mesmos campos cada vez, é por isso que o prompt pode nomeá-los. Digamos que você teste um scraper na segunda-feira e ele quebre na quinta-feira. Isso é um trabalho de manutenção. Não é uma leitura de backlink, e a conversa não notará a diferença. Se um colega insiste em rastrear, peça a ele para nomear o layout que ele espera e a data em que verificará. Sem isso, ninguém assume a quebra.

Falhas silenciosas e atualizações de fornecedores

Os modelos mudam, e assim fazem os produtos que os envolvem. Uma regra que funcionou em uma versão pode mudar na próxima. Nada anuncia isso. A cura é maçante: mantenha o conjunto de teste abaixo e execute-o novamente após qualquer mudança.

Mantenha os mesmos três domínios e as mesmas três perguntas. Se os recibos pararem de ser impressos, o desvio está no prompt ou no modelo. Data a primeira resposta errada. O changelog então mostra o que mudou naquela semana.

A verificação semanal, cinco movimentos

Execute os mesmos cinco movimentos toda semana, com a mesma formulação, para que uma diferença venha dos dados e não da sua redação.

1
Escolha três domínios que você já conhece
O seu, um concorrente, um site grande. Você sabe aproximadamente como cada um deve parecer.
2
Faça as mesmas três perguntas
Classificação, principais domínios de referência, âncoras. Mesma formulação toda semana, para que as diferenças venham dos dados.
3
Verifique os recibos
Cada resposta deve nomear uma ação e imprimir _credits. Recibo ausente, teste falhou.
4
Verifique um número com curl
Execute curl "https://seoaipal.com/api.php?action=refdomains&q=example.com&per=10&key=sk_live_..." e compare as primeiras linhas. Dois créditos.
5
Registre o que mudou
Se o prompt começou a ignorar uma regra, aperte essa regra. Não adicione mais regras.

Três hábitos que quebram silenciosamente o prompt

Em uma conversa longa, o modelo se apoia mais no texto recente do que na sua primeira mensagem. As regras no topo escorregam. Inicie uma nova conversa para cada cliente.

Suponha que você cole uma captura de tela de números de outro fornecedor na mesma conversa. O modelo pode misturar as duas fontes, e você não as desvendará depois. Mantenha uma fonte por conversa.

Um pouco de elogio pode fazer mal. Dizer ao modelo que um número corresponde ao que você esperava ensina a próxima resposta a inclinar-se na mesma direção. Se um número parecer estranho, diga isso de forma neutra. Peça o nome da ação. Quando uma resposta falha, a tabela de erros diz a você se a culpa é do prompt, da chave ou dos dados.

Antes do prompt ir para uma equipe

Coloque uma versão e uma data no topo do prompt.
Verifique se todas as ações nomeadas nas regras existem no seu esquema.
Execute o teste de três domínios e leia os recibos, não apenas a prosa.
Dê a cada colega sua própria conversa, com uma fonte de dados por conversa.
Adicione a nota de atualização mensal, para que um link ausente seja explicado em vez de negado.

Dois blocos de pedra lado a lado com uma régua não marcada

Datas que pertencem às suas notas

Coloque uma versão e uma data no topo do prompt, por exemplo 2026-10-29, da maneira como você marcaria código. Então, quando uma resposta ficar estranha em março, você pode dizer qual redação a produziu.

O conselho de links também se move com o Google. A atualização principal de março de 2024 e a atualização de spam de agosto de 2025 mudaram ambas o que as pessoas perguntavam sobre links, e prompts escritos antes deles assumiram coisas que já não se sustentavam. Revise as regras duas vezes por ano.

Mantenha um changelog curto ao lado do prompt. Três linhas por mudança são suficientes. Isso transforma um mistério em um diff.

Mantenha o conjunto de teste pequeno e entediante

A verificação semanal só funciona se o conjunto de teste permanecer o mesmo. Escolha-o uma vez, anote-o e resista à tentação de trocar domínios quando um resultado parecer estranho.

Escolha domínios que você pode julgar a olho nu

Seu próprio site é a primeira escolha, porque você conhece seus links melhor que qualquer pessoa. Um concorrente que você segue de perto vem em segundo. Um site muito grande faz uma terceira útil. Sua escala é fácil de julgar.

Evite um domínio recém-criado como teste. Seus números são ruidosos. Um desvio na resposta diz pouco. Escolha sites com um histórico que você possa ver. Inclua um site cujos links você leu à mão, porque é sua verdade fundamental.

Faça as mesmas três perguntas nas mesmas palavras

Mantenha a formulação fixa. Classificação, principais domínios de referência e âncoras, perguntados da mesma maneira toda semana. Mudar a formulação muda a resposta, e então você não pode dizer se os dados mudaram ou a pergunta.

Armazene as três respostas como texto plano ao lado do prompt. Em um mês, uma comparação lado a lado dirá mais do que qualquer memória de como a conversa parecia.

Precifique o teste antes de executá-lo

Cada chamada paga no teste custa créditos, então o teste tem um preço também. A classificação é gratuita, o que deixa duas perguntas pagas por domínio.

Três domínios e duas perguntas pagas resultam em seis chamadas a 2 créditos cada, então a verificação semanal custa doze créditos, cerca de $0.0012. Escreva essa figura na planilha de teste e verifique-a contra o saldo uma vez por mês.

O que fazer quando o teste falha

Um teste falhado é informação. Reescreva por último. Primeiro verifique os recibos, depois os códigos de status, depois a ortografia do domínio. Só depois disso você deve tocar nas regras.

Mude uma regra de cada vez. Duas edições ao mesmo tempo tornam a próxima falha impossível de explicar.

Mantenha também a resposta falha. Cole-a no changelog com a data e a regra que você mudou. Esse registro é a única maneira de distinguir uma correção real de uma resposta sorteada na próxima execução.

Perguntas que equipes fazem sobre este prompt

Posso encurtar as regras para economizar tokens?

Pode, mas corte as palavras em vez das regras. Cada linha numerada fecha uma falha que você pode imaginar. Funda duas linhas que dizem uma coisa. Deixe a regra dos recibos sozinha.

O prompt substitui a leitura dos dados?

Não. Ele faz o assistente relatar o que ele leu. Uma classificação e uma lista de domínios de referência ainda precisam dos seus olhos, especialmente quando um número o surpreende.

Qual ação o assistente deve tentar primeiro?

Comece com overview, que é gratuito, e passe para refdomains quando precisar da lista. Classificação e links respondem perguntas diferentes, então uma chamada não cobrirá ambas.

Quanto custa a verificação semanal?

Com o conjunto de teste acima, duas perguntas pagas para cada um de três domínios, a verificação usa cerca de doze créditos. Esse é um número pequeno, e vale a pena anotar para que a verificação mensal do saldo tenha uma linha de base.

E se a equipe quiser uma regra que o prompt não tem?

Adicione-a ao changelog com uma data e um motivo, depois teste-a nos três domínios. Um limite novo escrito uma vez é mais fácil de auditar do que uma instrução digitada no meio de uma sessão.

Nossa posição

Recibos batem tom

Nós preferiríamos ter um assistente maçante que imprime um nome de ação e um saldo do que um fluente que parece certo. A fluência é barata. Um primeiro olhar na explicação mostra por quê.