Resumen
Genera semanal cliente informes by pulling actual SERP datos, YouTube visibilidad, Reddit menciones, y Amazon producto posicionamientos de un single API. Formats resultados en un structured informe y delivers via correo electronico o Slack.
Desencadenador
Semanal Monday at 6 AM UTC via cron
Programación
Semanal Monday at 6 AM UTC
Pasos del flujo de trabajo
Cargar cliente configurations
Leer cliente lista con their palabras clave objetivo, dominios, YouTube canales, y producto names de un base de datos o archivo de configuracion.
Pull Google posicionamientos
Consulta palabras clave objetivo on Google y extraer posiciones organicas for el client's dominio.
Verificar YouTube visibilidad
Search YouTube for el client's marca y producto palabras clave. Note posicionamiento positions y competidor videos.
Scan Reddit menciones
Search Reddit for menciones de marca y producto discussions. Marcar positive y negative sentiment.
Verificar Amazon producto posicionamientos
For e-commerce clientes, search Amazon for producto palabras clave y note posicionamiento positions vs competidores.
Generar y deliver informe
Compile todos datos en un formatted informe (PDF, Slack mensaje, o correo electronico) con week-over-week comparisons.
Implementacion en Python
import requests, os, json
from datetime import date
H = {"x-api-key": os.environ["SCAVIO_API_KEY"]}
def generate_report(client):
report = {"client": client["name"], "date": str(date.today()), "platforms": {}}
for platform, keywords in client["keywords"].items():
results = []
for kw in keywords:
r = requests.post("https://api.scavio.dev/api/v1/search", headers=H,
json={"platform": platform, "query": kw}, timeout=10).json()
organic = r.get("organic", [])
pos = next((i+1 for i, o in enumerate(organic)
if client["domain"] in o.get("link", "")), None) if platform != "reddit" else None
results.append({"keyword": kw, "position": pos, "total": len(organic)})
report["platforms"][platform] = results
return report
client = {
"name": "Acme Corp",
"domain": "acme.com",
"keywords": {
"google": ["acme software", "acme reviews"],
"youtube": ["acme tutorial"],
"reddit": ["acme software review"],
}
}
print(json.dumps(generate_report(client), indent=2))Implementacion en JavaScript
const H = {"x-api-key": process.env.SCAVIO_API_KEY, "Content-Type": "application/json"};
async function generateReport(client) {
const report = {client: client.name, date: new Date().toISOString().slice(0, 10), platforms: {}};
for (const [platform, keywords] of Object.entries(client.keywords)) {
report.platforms[platform] = [];
for (const kw of keywords) {
const r = await fetch("https://api.scavio.dev/api/v1/search", {
method: "POST", headers: H,
body: JSON.stringify({platform, query: kw})
}).then(r => r.json());
const pos = (r.organic || []).findIndex(o =>
o.link?.includes(client.domain)) + 1;
report.platforms[platform].push({keyword: kw, position: pos || null});
}
}
return report;
}Plataformas utilizadas
Búsqueda web con grafo de conocimiento, PAA y resúmenes de IA
YouTube
Búsqueda de videos con transcripciones y metadatos
Comunidad, publicaciones y comentarios en hilos de cualquier subreddit
Amazon
Búsqueda de productos con precios, calificaciones y reseñas