Resolución de problemas
Las llamadas a la herramienta de verificación de backlinks fallan en tu asistente: una tabla de síntomas
Los asistentes suavizan los errores. Esta página enumera lo que ves en el chat, lo que ocurrió detrás y la solución, comenzando por los síntomas que más cuestan.
Equipo de investigación de SEO AI Pal ·
Síntoma, causa, solución
| Lo que muestra el chat | Lo que ocurrió | Solución |
|---|---|---|
| "No pude recuperar datos" sin detalles | Probablemente HTTP 401. La clave falta, está mal escrita o se pegó con un espacio al final. | Vuelve a pegar la clave. Prueba con la acción gratuita overview en un terminal. |
| Funcionaba ayer, "servicio no disponible" hoy | Probablemente HTTP 402. El saldo llegó a cero después de un bucle o una sesión larga. | Recarga con USDT (TRC-20) desde la página de la cuenta. Las acciones gratuitas siguen respondiendo. |
| Una calificación de 0 o sin filas para un sitio real | El índice puede no contener el dominio aún, o el nombre se envió con una ruta o https://. | Envía el dominio sin más. Reintenta el próximo mes si el sitio es muy nuevo. |
| Falta el nuevo enlace que construiste | El índice se actualiza aproximadamente una vez al mes. | Espera la actualización. No vuelvas a ejecutar la llamada diez veces. |
| Los números difieren del panel de otro proveedor | Diferentes rastreadores y diferente puntuación. Nuestro DR es una métrica propia. | Compara tendencias, no cifras individuales. |
| La respuesta lista muchas menos filas de las esperadas | El esquema limitó per, o el asistente leyó solo la página uno. | Pide page=2 explícitamente. |
La respuesta tiene números pero no _credits | No se hizo ninguna llamada. El modelo respondió desde la memoria. | Aplica las reglas en el manual de ejecución de prompts. |
| Cobros más altos de los previstos | El asistente reintentó una acción de pago o hizo un bucle sobre una lista. | Limita los reintentos a uno y agrupa con bulk_dr. |
Por qué el código de estado importa más que la frase
Un asistente convierte un 402 en un párrafo educado. Lees el párrafo, no el código. Pide el estado en crudo. Es el diagnóstico más barato que tienes.
Divide la culpa en dos. Antes de culpar al modelo, ejecuta la misma URL en un terminal. Si curl devuelve JSON con ok true, la API está bien y la culpa está en el envoltorio o en el prompt. Si curl falla también, el problema es la clave o el saldo, y ninguna redacción del prompt lo solucionará.
Noventa segundos de triaje
- Ejecuta la llamada fallida con curl y una acción gratuita. ¿Vuelve
ok? - Ejecútala con una acción de pago. Un 401 apunta a la clave, un 402 al saldo.
- Imprime el dominio exactamente como lo envió el asistente. Busca
www., rutas y comillas. - Compara la fecha de tu último pedido con la actualización mensual.
- Lee el registro de llamadas a herramientas de tu producto asistente, no su resumen.
Cuando un script se detiene a mitad de camino
Los scripts son donde la factura crece silenciosamente. Los tres casos siguientes muestran cómo una detención, una cadena o un error silencioso se convierte en más llamadas de las previstas.
Un Ctrl-C puede dejar un lote a medio hacer
Muchos scripts hacen un bucle sobre una lista de dominios y realizan una llamada de pago por elemento. Presiona Ctrl-C a mitad de camino. Las llamadas que ya se ejecutaron se facturan, y el resto nunca ocurre. Tu archivo de salida debería indicar qué dominios terminaron.
Escribe cada resultado en disco tan pronto como llegue. Así, un reinicio puede saltarse los dominios ya procesados en lugar de pagar por ellos dos veces.
Encadenar scripts multiplica las llamadas
Ejecutar tres scripts y fusionar su salida en un solo correo electrónico parece ordenado. Digamos que cada uno de los tres scripts hace dos llamadas de pago, y una ejecución única factura seis. Cuenta primero, luego programa.
Un solo script que recopila los datos una vez y luego los formatea mantiene la factura y la lógica en un solo lugar. Un script programado también debería imprimir su conteo de llamadas al final, para que la próxima revisión del saldo tenga un número con el que comparar.
Lee el cuerpo del error antes de volver a ejecutar
Una llamada fallida generalmente aún devuelve un cuerpo con ok en false y un mensaje corto. Lee el mensaje primero. Un reintento con la misma clave y el mismo saldo fallará de la misma manera.
Los scripts que absorben el cuerpo e imprimen solo la palabra "failed" desperdician la única pista que tenías. Cita el estado y el mensaje tal como llegaron. Una paráfrasis del asistente ya perdió el detalle que habría ayudado. Verbatim, siempre.
Errores y soluciones en el propio envoltorio
Los mismos tres errores aparecen en la mayoría de los envoltorios. Poner la clave en la URL significa que aparece en los registros y en las transcripciones compartidas, así que usa el encabezado bearer donde tu producto lo permita.
Exponer todas las acciones es la segunda. Tu GPT solo necesita cuatro de ellas, y cada acción extra es otra forma de gastar créditos que no planeabas. La tercera es solicitar 5.000 filas cuando una respuesta usa diez.
Solúctalos una vez y la mayoría de la tabla anterior deja de aplicar. Los números incorrectos que sobrevivan todo esto se cubren en la página de mitos.
Configura un registro de llamadas que muestre las fallas
Un registro es el diagnóstico más barato que comprarás. No cuesta nada mantenerlo, y convierte una queja vaga sobre el chat en una lista de códigos de estado que puedes contar. Dos hábitos son suficientes.
Una línea por llamada, con el estado
Escribe la marca de tiempo, la acción, el dominio, el estado HTTP y el valor de _credits en una línea. Texto plano es suficiente. Una hoja de cálculo puede leerla después, y una columna de estados muestra un patrón que una sola respuesta del chat oculta.
Mantén las llamadas gratuitas y de pago en columnas separadas, para que un aumento en los errores de pago no se oculte en el total. Marca cualquier llamada que se haya reintentado, y guarda el conteo de reintentos junto al original. Los 402 repetidos en la misma hora apuntan a un bucle, no a un mal día. Lee el registro primero. Culpa al modelo al final.
Alerta por el estado, no por el tono
Una ventana de chat puede leer calma mientras el registro muestra un 402 en cada fila. Establece una regla para los códigos de estado que te importen. Manténla aburrida. Un 401 significa la clave, un 402 el saldo, y cualquier otra cosa significa leer el cuerpo.
Que las acciones gratuitas sigan respondiendo mientras las de pago fallan es una señal clara. El saldo es la causa probable. La recarga y el conteo de reintentos son lo primero. Las acciones gratuitas también sirven como control, ya que muestran que la ruta en sí sigue funcionando.
Reproduce una llamada fallida en cinco pasos
Trabaja de afuera hacia adentro. Cada paso descarta una capa, para que la culpa termine en un solo lugar.
- 1
Copia la URL exacta
Toma la solicitud que tu asistente o script envió, byte por byte, incluyendo el dominio y su ortografía. Los espacios ocultos y un
https://suelto son culpables comunes. - 2
Ejecuta la acción gratuita overview
Envía el mismo dominio a
overview, que no necesita clave. Si eso responde conoktrue, la ruta y el dominio están bien, y el problema está con la clave o el saldo. - 3
Ejecuta la acción de pago con la clave
Repite la llamada de pago con la clave en el encabezado, como recomienda la configuración de GPT personalizado. Un 401 apunta a la clave, y un 402 al saldo.
- 4
Compara la primera fila
Verifica que la primera fila devuelta coincida con la misma llamada realizada en un terminal. Una discrepancia significa que el envoltorio cambió algo en el camino.
- 5
Escribe el resultado
Mantén el estado, la acción, el dominio y el valor de
_creditsjuntos. La próxima persona que lea el registro sabrá qué ocurrió sin preguntar.
Distinguir un resultado vacío real de uno roto
Dos tipos de respuesta se parecen en una ventana de chat y significan cosas muy diferentes. Distingue primero. Cambiar la cosa incorrecta cuesta tiempo y a veces créditos.
Cero filas es una respuesta
Un dominio puede devolver ok true y una lista vacía. Eso es un hallazgo sobre el índice. No un fallo en la llamada. Puede ser un sitio nuevo, una discrepancia de ortografía o un enlace que aún no ha llegado a la actualización mensual.
Trátalo como un resultado. Infórmalo en una oración. Mantén una lista corta de dominios que devolvieron vacío, con la fecha de cada llamada. Si el mismo dominio se mantiene vacío durante un mes, la ortografía es el siguiente sospechoso, y la actualización mensual solo puede explicar tanto.
Demasiadas pocas filas es un ajuste
A veces la respuesta es corta porque el esquema limitó las filas, o porque el script leyó solo la página uno. Una llamada se factura una vez sin importar el conteo de filas, así que un per más grande en la solicitud no cuesta créditos adicionales. Verifica el límite en tu esquema primero. Comienza ahí.
Pide la página dos a propósito, y dilo en el prompt, en lugar de esperar que el asistente note que hay más.
Respuestas rápidas
- ¿Es una herramienta de verificación de backlinks lo mismo que un rastreador de posiciones?
- No. Lee enlaces: dominios de referencia, anclas, páginas principales y una calificación de 0-100. Las posiciones de palabras clave y los rastreados diarios pertenecen a Ahrefs o Semrush, que son productos más completos para ese trabajo. Usa cada uno donde sea fuerte.
- ¿Cuántas filas puede devolver una llamada?
- Hasta 1.000 filas por llamada, con
pageyper(10 a 5000) para paginación, y paginación profunda limitada a 50.000. La llamada se factura una vez sin importar el conteo de filas, así que unpermás grande no cuesta más. - ¿Por qué mi DR difiere de Ahrefs?
- Nuestra calificación es round(100 log(ref_domains+1) / log(210^7)), una escala logarítmica en dominios de referencia. El DR de Ahrefs es una métrica separada con su propio método. Similar en espíritu, nunca el mismo número.
