E1 · rotina.sh semana
20 minCopia el rotina.sh, ajusta las cuatro variables y ejecuta la parte semanal (con tus CSV o con los de ejemplo).
Listo cuando: existe la carpeta rotina/ con la fecha de hoy y, dentro de ella, gsc/relatorio.json.
Clase 7 · 18 min
Uniendo todo: la rutina semanal y mensual con un agente
Cinco herramientas sueltas se vuelven trabajo olvidado. Un script ejecuta las de cada semana y las de cada mes y guarda la salida con fecha. Un agente por suscripción (Claude Code o Codex) lee el informe y propone tres acciones con el número que las justifica. Quien decide y quien cambia el sitio eres tú: esa es la control humano.
Empezar la clase
En esta clase vas a
- 1Qué se ejecuta cada semana y qué se ejecuta cada mes
- 2Un rotina.sh que guarda todo con fecha
- 3El agente como observador: solo lee y propone
- 4La control humano y el registro de la decisión
Objetivo: armar la rutina semanal y mensual de las 5 herramientas y un agente que lee los informes y solo propone, con la control humano antes de cambiar el sitio.
01La rutina
La máquina mide y propone; el humano decide. Toca cada etapa.
Haz clic en cada bloque del diagrama para ver qué hace.
Nada cambia en el sitio sin pasar por la puerta.
02Arma la rutina en cuatro pasos
Haz clic en cada paso.
1. Script
Copia el rotina.sh del bloque de abajo a una carpeta de trabajo y ajusta las cuatro variables: dónde está el inemaseo-sistemas, la propiedad de Search Console, la home y la carpeta de los CSV.
Ejecuta bash rotina.sh semana y revisa la carpeta con fecha.
2. Agenda
La parte semanal puede ir en el cron, justo después de gsc_semanal.py. La mensual tiene dos pasos manuales (exportar desde Bing y copiar el log): un recordatorio en el calendario funciona mejor que un cron que falla en silencio.
3. Agente
Envía el pedido y el relatorio.json al agente, sin herramientas: no puede cambiar nada.
El pedido indica usar solo los números del reporte y recuerda que la pauta de contenidos es heurística.
Suscripción, no API
claude -p y codex exec corren con tu suscripción. Llamar a un modelo con una clave de API es otra cosa, con costo por uso.
4. Compuerta
Para cada propuesta: acepto, pospongo o rechazo, con una línea de motivo. La pregunta "para que el humano decida" es tuya; el agente no tiene el contexto del negocio.
En las próximas rondas, suma el decisoes.md al pedido (un cat más antes del reporte) para que el agente no repita lo que ya rechazaste.
03La rutina y el pedido al agente
Modelos para copiar. Todos los comandos que contienen son los de los README de las herramientas.
rotina.sh (modelo)
#!/bin/bash
# rotina.sh — semana | mes. Ejecuta las herramientas de inemaseo-sistemas y guarda la salida con fecha.
set -e
SIS=~/inemaseo-sistemas/ferramentas # donde lo clonaste
SITE=tusitio.com # propiedad de Search Console
URL=https://tusitio.com # home del sitio
CSV=~/ruta/de/la/carpeta/gsc # carpeta de gsc_semanal.py
D=rotina/$(date +%F); mkdir -p $D dados
case "$1" in
semana)
python3 $SIS/gsc-historico/gsc_historico.py importar $CSV --db dados/gsc.sqlite
python3 $SIS/gsc-historico/gsc_historico.py relatorio --db dados/gsc.sqlite --site $SITE --saida $D/gsc
;;
mes)
python3 $SIS/auditor/auditor.py $URL --max 50 -q --saida $D/auditor
python3 $SIS/agente-ready/agente-ready.py $URL --saida $D/agente-ready
# bing-ia: solo después de exportar el CSV en el panel de Bing (no hay API)
ls bing/*.csv >/dev/null 2>&1 && python3 $SIS/bing-ia/bing_ia.py importar bing/*.csv --db dados/bing.sqlite \
&& python3 $SIS/bing-ia/bing_ia.py relatorio --db dados/bing.sqlite --gsc-db dados/gsc.sqlite --site $SITE --saida $D/bing-ia
# botlog: solo después de copiar el log (fíltralo antes de guardarlo)
ls logs/* >/dev/null 2>&1 && python3 $SIS/botlog/botlog.py analisar logs/* --saida $D/botlog
;;
*) echo "uso: bash rotina.sh semana|mes"; exit 1 ;;
esac
echo "salida en $D"pedido-semana.md (modelo del pedido al agente)
Eres el observador semanal de SEO del sitio. Abajo está el relatorio.json de gsc-historico (Search Console de la semana, solo consultas sin marca). Reglas: - Solo lectura. No modifiques ningún archivo, no publiques nada, no ejecutes comandos. - Usa solo los números del reporte; no inventes datos. - La regla de "página dueña" es heurística: revisa la columna de las páginas que aparecen hoy antes de proponer una página nueva. Responde en español, en máximo 12 líneas: 1. Una frase con el número de la semana (clics e impresiones sin marca, comparado con la anterior). 2. Exactamente 3 propuestas, cada una con: acción (escribir página nueva / mejorar página existente / reescribir título), URL o consulta, y el número del reporte que la justifica. 3. Una línea "Para que el humano decida:" con la pregunta que solo el dueño del sitio puede responder.
Terminal · semana + agente (Claude Code, sin herramientas)
bash rotina.sh semana (cat pedido-semana.md; echo; cat rotina/$(date +%F)/gsc/relatorio.json) | claude -p --tools "" > rotina/$(date +%F)/leitura-agente.md
decisoes.md (control humano)
# Decisiones — semana del <dd/mm/aaaa> | propuesta del agente | decisión | motivo | quién | cuándo | |---|---|---|---|---| | <mejorar /es/aprender-…/> | acepto | <la página ya aparece; reforzar el inicio> | <nombre> | <dd/mm> | | <reescribir título de /cursos/…> | pospongo | <solo 5 impresiones; esperar 2 semanas más> | <nombre> | <dd/mm> | | <…> | rechazo | <…> | <nombre> | <dd/mm> |
Ejemplo del repositorio
bash rotina.sh semana con los CSV de ejemplo de inema.club:
importado: 10 linha(s) de resumo, 244 linha(s) de consulta → dados/gsc.sqlite inema.club semana 2026-10-11 (comparada com 2026-10-04): sem marca 0 cliques / 157 impr.; subiram 15, caíram 15, pauta 18, páginas sem clique 5 → rotina/2026-10-19/gsc/relatorio.html salida en rotina/2026-10-19
Respuesta real de claude -p (Claude Code con la suscripción, sin herramientas) al pedido anterior, acortada:
1. Semana 05–11/10: 0 cliques e 157 impressões sem marca, contra 0 cliques
e 47 impressões em 28/09–04/10.
2. Propostas (todas já têm página respondendo, então nenhuma página nova):
- Melhorar /es/aprender-inteligencia-artificial/: 106 impressões,
22 consultas, posição média 39,1 e 0 cliques. A pauta indicava página
nova para algumas dessas consultas, mas é esta página que já aparece.
- Reescrever o título de /cursos/278-laya-jev-decisoes-estruturadas-na-pratica/:
posição média 7,4, 5 impressões e 0 cliques.
- Melhorar /agentes-de-inteligencia-artificial/ para "curso de agentes
de ia": 4 impressões, posição 34,8.
3. Para o humano decidir: vale investir no público em espanhol, que trouxe
quase todo o crescimento da semana, ou o foco continua no português?El agente también separó, por su cuenta, una consulta que parecía una prueba interna y no la usó. La decisión sobre el español queda con el dueño.
- Darle herramientas de escritura al observador: él lee y propone; quien cambia el sitio pasa por la compuerta.
- Pedir "analiza el SEO": sin reglas (solo números del reporte, formato fijo), la respuesta se vuelve opinión genérica.
- Cron en el export de Bing: no hay API; esa parte es manual, con recordatorio.
- Olvidar el decisoes.md: sin él, el agente repite cada semana lo que ya rechazaste.
04Práctica: tu rutina en marcha
Empieza por la semana; el mes entra cuando tengas a mano el export de Bing y el log.
E2 · Agente + compuerta
25 minEnvía el pedido y el reporte al agente sin herramientas y registra tu decisión sobre cada propuesta.
Listo cuando: leitura-agente.md tiene 3 propuestas con número, y decisoes.md tiene una línea por propuesta con acepto, pospongo o rechazo y el motivo.
05Prueba lo que aprendiste
La explicación aparece después de tu respuesta.
Pregunta 1 de 4
¿Por qué el agente corre sin herramientas (--tools vacío)?competencia
Correcto
La control humano solo funciona si el agente no puede actuar solo. Quien aplica el cambio eres tú, después de decidir.No es esa
La control humano solo funciona si el agente no puede actuar solo. Quien aplica el cambio eres tú, después de decidir.Repasar: La rutinaPregunta 2 de 4
¿Qué parte de la rutina mensual no se puede automatizar por completo?
Correcto
El CSV sale del panel. El botlog también depende de copiar el log; por eso lo mensual funciona mejor con recordatorio que con cron.No es esa
El CSV sale del panel. El botlog también depende de copiar el log; por eso lo mensual funciona mejor con recordatorio que con cron.Repasar: Arma la rutina en cuatro pasosPregunta 3 de 4
La pauta de contenidos pedía una página nueva, y el agente propuso mejorar una página existente. ¿Quién tenía razón?
Correcto
La página en español ya aparecía en las consultas. Crear otra página para el mismo tema dividiría la señal. La decisión final sigue siendo del humano.No es esa
La página en español ya aparecía en las consultas. Crear otra página para el mismo tema dividiría la señal. La decisión final sigue siendo del humano.Repasar: La rutina y el pedido al agentePregunta 4 de 4
¿Para qué sirve el decisoes.md?
Correcto
Es la memoria de la puerta. Mes a mes, muestra qué se decidió y por qué.No es esa
Es la memoria de la puerta. Mes a mes, muestra qué se decidió y por qué.Repasar: Arma la rutina en cuatro pasosPrueba completada
Acertaste {a} de {n}. Si aciertas todas, la clase se marca como completada.Elige una alternativa. La explicación aparece después de tu intento.
06Para llevar
CadenciaSemana: gsc-historico. Mes: auditor, agente-ready, bing-ia y botlog.
AgentePor la suscripción, sin herramientas: lee el JSON y propone 3 acciones con número.
CompuertaTú decides y anotas; solo entonces cambia el sitio.