Code Sandbox
Ejecute cálculos programáticos en sus datos de GSC — sumas, promedios, agrupamientos y desgloses filtrados sin números alucinados.
Por qué existe
Los LLM fabrican números. Pregunta a un chatbot “¿cuál es mi total de clics?” y producirá una cifra plausible que puede ser completamente errónea. El Code Sandbox resuelve esto — cuando el agente necesita un resultado numérico, llama la herramienta code_sandbox para ejecutar un cálculo real con sus datos de GSC sincronizados y retornar la respuesta exacta.
Cada número que el agente reporta de sus datos de GSC proviene del Code Sandbox, no del modelo de lenguaje. El LLM maneja el razonamiento y la estrategia; el sandbox maneja la aritmética.
Operaciones disponibles
Seis operaciones se ejecutan contra sus datos de GSC sincronizados del proyecto actual:
| Operación | Qué hace | Ejemplo de uso |
|---|---|---|
| sum | Suma los valores de un campo numérico | Total de clics en un conjunto de palabras clave |
| avg | Media aritmética de un campo numérico | Posición promedio para palabras clave filtradas |
| min | Valor más pequeño en el campo | Mejor posición de ranking en un conjunto |
| max | Valor más grande en el campo | Número de impresiones más alto para una palabra clave única |
| count | Número de filas coincidentes | Palabras clave que coinciden con una condición de filtro |
| group | Segmenta por un campo, retorna suma/promedio/conteo por grupo (top 20) | Clics desglosados por URL de página |
Campos y filtros
Las operaciones se ejecutan en estos campos: clicks, impressions, ctr (decimal, p. ej. 0.05 = 5%), position, query y page. Delimite cualquier operación a un subconjunto usando filtros — un filtro combina un campo, operador y valor, y múltiples filtros pueden aplicarse juntos.
| Operador | Significado | Ejemplo |
|---|---|---|
| eq | Coincidencia exacta | page eq /blog/seo-guide |
| gt / lt | Mayor / menor que | position gt 10 |
| gte / lte | Mayor / menor que o igual | clicks gte 100 |
| contains | String contiene (campos query/page) | query contains seo |
No necesita conocer la sintaxis de filtros. Describa lo que desea en inglés plano y el agente lo traduce a la operación, campos y filtros correctos.
Agrupamiento
La operación group segmenta sus datos por un campo y retorna suma, promedio y conteo por segmento (top 20). Agrupe por página para ver qué URLs generan más tráfico, o por query para encontrar clusters de palabras clave.
“Agrupar mis palabras clave por página y mostrar qué página recibe más impresiones”
Ejecuta una operación de grupo en el campo de página, retornando impresiones totales, CTR promedio y conteo de palabras clave por URL.
Solicitudes de ejemplo
“¿Cuál es mi total de clics en todas las palabras clave este mes? Necesito el número exacto”
Activa una operación de suma en el campo de clics sin filtro — retorna el total preciso.
“Calcular la posición promedio para palabras clave que contienen \'seo\' frente a todas las demás palabras clave”
Ejecuta dos operaciones de promedio con filtros de contiene opuestos y presenta una comparación lado a lado.
“¿Cuántas palabras clave tienen un CTR por debajo del 1% pero más de 500 impresiones?”
Una operación de conteo con dos filtros: ctr lte 0.01 e impressions gte 500.
Consejos
- Pida números exactos — decir “número exacto” indica al agente que use el Code Sandbox en lugar de estimar.
- Segmente por rangos de posición — agrupar por 1-3, 4-10, 11-20 proporciona una imagen instantánea de su distribución de ranking.
- Combine filtros con agrupamiento — p. ej. “agrupar por página pero solo para palabras clave de marca” aísla el tráfico de marca por URL.
- Empareje con GSC Query — después de extraer palabras clave con
gsc_query, pida cálculos agregados de seguimiento. El agente ejecuta cálculos de sandbox en el mismo contexto de datos.
Pruebe estos prompts
© 2026 Agentic SEO. Todos los derechos reservados.