La visibilidad de la descripción general de la IA se está convirtiendo en una métrica de SEO crítica a medida que Google presenta respuestas generadas por IA para más consultas. Un informe semanal que rastrea cuáles de sus palabras clave objetivo activan descripciones generales de IA, si su dominio es citado y cómo cambian las citas con el tiempo le brinda inteligencia procesable para la estrategia OEA. Este tutorial muestra cómo crear un informe AEO semanal automatizado utilizando la API de Scavio. Supervisará una lista de palabras clave, realizará un seguimiento del recuento de citas y generará un informe formateado que muestre los cambios semana tras semana.
Requisitos previos
- Python 3.8+ instalado
- solicita biblioteca instalada
- Una clave API de Scavio de scavio.dev
- Una lista de palabras clave objetivo para monitorear
Guia paso a paso
Paso 1: Definir la lista de palabras clave
Configure las palabras clave que desea monitorear para la visibilidad de la descripción general de AI.
import os, requests, json
from datetime import date, timedelta
API_KEY = os.environ["SCAVIO_API_KEY"]
KEYWORDS = [
"best crm for startups",
"how to build a landing page",
"project management tools comparison",
"what is product-led growth",
"saas pricing strategies",
]Paso 2: Consulte la descripción general de IA para cada palabra clave
Consulta cada palabra clave y extrae datos de citas y presencia de AI Overview.
def check_aeo(keyword):
resp = requests.post("https://api.scavio.dev/api/v1/search",
headers={"x-api-key": API_KEY},
json={"platform": "google", "query": keyword})
data = resp.json()
aio = data.get("ai_overview", {})
sources = aio.get("sources", []) if aio else []
return {
"keyword": keyword,
"has_aio": bool(aio),
"source_count": len(sources),
"domains": [s.get("link","").split("/")[2] for s in sources if s.get("link")],
}Paso 3: Cree la instantánea semanal
Ejecute comprobaciones de todas las palabras clave y guarde la instantánea para compararla.
def weekly_snapshot():
snapshot = {"date": date.today().isoformat(), "keywords": []}
for kw in KEYWORDS:
result = check_aeo(kw)
snapshot["keywords"].append(result)
filename = f"aeo_snapshot_{date.today().isoformat()}.json"
with open(filename, "w") as f:
json.dump(snapshot, f, indent=2)
return snapshotPaso 4: Comparar con la semana anterior
Cargue la instantánea anterior y calcule los cambios semana tras semana.
def compare_weeks(current, previous_file):
try:
with open(previous_file) as f:
previous = json.load(f)
except FileNotFoundError:
return current
prev_map = {k["keyword"]: k for k in previous.get("keywords", [])}
for kw in current["keywords"]:
prev = prev_map.get(kw["keyword"], {})
kw["aio_change"] = "new" if kw["has_aio"] and not prev.get("has_aio") else \
"lost" if not kw["has_aio"] and prev.get("has_aio") else "stable"
kw["source_delta"] = kw["source_count"] - prev.get("source_count", 0)
return current
snap = weekly_snapshot()
prev_date = (date.today() - timedelta(days=7)).isoformat()
report = compare_weeks(snap, f"aeo_snapshot_{prev_date}.json")
for kw in report["keywords"]:
print(f"{kw['keyword']}: AIO={'yes' if kw['has_aio'] else 'no'} sources={kw['source_count']}")Ejemplo en Python
import os, requests
API_KEY = os.environ["SCAVIO_API_KEY"]
def aeo_check(kw):
resp = requests.post("https://api.scavio.dev/api/v1/search",
headers={"x-api-key": API_KEY},
json={"platform": "google", "query": kw})
aio = resp.json().get("ai_overview", {})
sources = aio.get("sources", []) if aio else []
return {"keyword": kw, "aio": bool(aio), "sources": len(sources)}
for kw in ["best crm", "what is plg"]:
print(aeo_check(kw))Ejemplo en JavaScript
const H = {"x-api-key": process.env.SCAVIO_API_KEY, "Content-Type": "application/json"};
async function aeoCheck(kw) {
const r = await fetch("https://api.scavio.dev/api/v1/search", {
method: "POST", headers: H,
body: JSON.stringify({platform: "google", query: kw})
});
const aio = (await r.json()).ai_overview || {};
return {keyword: kw, aio: !!Object.keys(aio).length,
sources: (aio.sources||[]).length};
}
aeoCheck("best crm").then(console.log);Salida esperada
A weekly AEO report showing which keywords trigger AI Overviews, domain citation counts, and week-over-week changes in AI Overview visibility.