La mayoría de los equipos de contenido escriben primero y verifican el potencial de clasificación más tarde, perdiendo horas en publicaciones que no pueden clasificarse. Una verificación previa a la escritura de Scavio de 60 segundos muestra la dificultad de SERP, la presencia de descripción general de AI y la brecha de autoridad de dominio antes de comenzar. Este tutorial integra el cheque en su proceso editorial.
Requisitos previos
- Python 3.10+
- Una clave API de Scavio
- Un título de publicación propuesto o una palabra clave objetivo
Guia paso a paso
Paso 1: Consultar la palabra clave de destino
Extraiga la descripción general de SERP + AI.
import requests, os
API_KEY = os.environ['SCAVIO_API_KEY']
def pre_check(keyword):
r = requests.post('https://api.scavio.dev/api/v1/search',
headers={'x-api-key': API_KEY},
json={'query': keyword, 'include': ['ai_overview', 'paa']})
return r.json()Paso 2: Puntuación de las 10 autoridades principales
Cuente DR>50 dominios en el top 10. Recuento alto = SERP estricto.
HIGH_AUTH = {'wikipedia.org', 'forbes.com', 'techcrunch.com', 'nytimes.com'}
def authority_score(results):
top10 = results.get('organic_results', [])[:10]
return sum(1 for r in top10 if any(d in r['link'] for d in HIGH_AUTH))Paso 3: Verifique la presencia de descripción general de IA
Si ya existe una descripción general, la clasificación es más difícil pero valiosa desde el punto de vista geográfico.
def has_overview(r):
return bool(r.get('ai_overview'))Paso 4: Informar un veredicto de aprobación o no
Reglas generales integradas en un anotador de 30 líneas.
def verdict(r):
auth = authority_score(r)
if auth >= 6: return 'NO-GO: top 10 dominated by DR>50'
if auth >= 4: return 'MAYBE: hard but possible with unique angle'
return 'GO: top 10 has room'Paso 5: Añadir a tu CMS editorial
Deja caer el veredicto en cada nuevo billete de draft.
# Notion/Linear webhook example:
POST /webhook { "verdict": "MAYBE", "keyword": "..." }Ejemplo en Python
import os, requests
API_KEY = os.environ['SCAVIO_API_KEY']
HIGH = {'wikipedia.org', 'forbes.com', 'techcrunch.com'}
def check(kw):
r = requests.post('https://api.scavio.dev/api/v1/search',
headers={'x-api-key': API_KEY},
json={'query': kw, 'include': ['ai_overview']}).json()
top = r.get('organic_results', [])[:10]
auth = sum(1 for x in top if any(d in x['link'] for d in HIGH))
return {'authority_count': auth, 'ai_overview': bool(r.get('ai_overview')), 'verdict': 'NO-GO' if auth >= 6 else 'GO'}
print(check('how to build an ai agent'))Ejemplo en JavaScript
const API_KEY = process.env.SCAVIO_API_KEY;
const HIGH = ['wikipedia.org', 'forbes.com', 'techcrunch.com'];
export async function check(kw) {
const r = await fetch('https://api.scavio.dev/api/v1/search', {
method: 'POST',
headers: { 'x-api-key': API_KEY, 'Content-Type': 'application/json' },
body: JSON.stringify({ query: kw, include: ['ai_overview'] })
});
const d = await r.json();
const top = (d.organic_results || []).slice(0, 10);
const auth = top.filter(x => HIGH.some(h => x.link.includes(h))).length;
return { authority_count: auth, ai_overview: !!d.ai_overview, verdict: auth >= 6 ? 'NO-GO' : 'GO' };
}Salida esperada
Per-keyword verdict in under 5 seconds. Typical team saves 20-40 hours/month skipping no-go topics.