Conecta tu agente

Tres pasos

1. 1

   Crea una clave

   La clave la crea un adulto de la familia — aquí mismo. Inicia sesión y volverás a este formulario.

   Iniciar sesión y crear una clave
2. 2

   Instala la skill

   La skill le enseña al agente las rutas y el orden de los pasos. Sirve para agentes que pueden ejecutar comandos: Claude Code, Cursor, OpenClaw y similares.

3. 3

   Pide

   “¿Qué tienen hoy los niños?”, “Aprueba todo lo que marcaron”, “Añade una misión para Teo — sacar la basura los miércoles, 10 puntos”.

La skill

El primer comando instala la skill; los demás guardan la clave donde la skill la busca. No hace falta pegar la clave en el chat del agente. github.com/usavilov/questburg-skills

npx -y skills add usavilov/questburg-skills
mkdir -p ~/.config/questburg
printf '%s' 'qb_…' > ~/.config/questburg/key
chmod 600 ~/.config/questburg/key

API

Si la skill no te sirve, la misma API está abierta directamente. La clave va en una cabecera y las respuestas llegan en JSON.

https://questburg.com/api/v1

Puedes darle al agente una sola dirección — ahí está lo mismo, escrito para él: questburg.com/llms.txt

• GET/me

  La familia, los miembros con sus códigos y puntos, lo que puede hacer la clave.

• GET/today

  Tareas del día. ?member=código — un miembro, ?date=AAAA-MM-DD — otro día.

• GET/approvals

  Lo que marcaron los niños y lo que espera tu respuesta.

• POST/occurrences/{id}/done

  Marcar una tarea como hecha.

• POST/occurrences/{id}/approve

  Aprobar: se suman los puntos. Un día cerrado — dentro de una semana.

• POST/occurrences/{id}/reject

  Rechazar una marca.

• POST/approvals/approve-all

  Aprobar todo lo que marcaron los niños.

• GET/offers

  Misiones activas.

• POST/offers

  Añadir una misión: title, assignees (códigos o "kids"), points, weekdays.

• PATCH/offers/{code}

  Cambiar una misión: envía solo lo que cambia.

• DELETE/offers/{code}

  Quitar una misión. El historial se conserva.

• POST/occurrences/{id}/undo

  Anular una aprobación: los puntos se devuelven y la tarea vuelve a esperar respuesta.

• GET/starters

  Tareas y premios listos; first indica por dónde empezar. POST { key } añade una tarea para los niños, { reward } un premio.

• GET/rewards

  Regalos. POST añade uno: title y price, o streak { quest, days }.

• PATCH/rewards/{code}

  Cambiar un regalo; DELETE lo quita.

• GET/redemptions

  Peticiones de regalos que esperan respuesta.

• POST/redemptions/{id}/grant

  El regalo se entregó; /refuse lo rechaza.

• GET/gates

  Permisos y qué niños los tienen abiertos hoy. POST añade uno: name, quests, price.

• PATCH/gates/{code}

  Cambiar un permiso; DELETE lo quita.

• POST/gates/{code}/override

  Dar o cerrar un permiso por hoy: member, state (granted | blocked), note.

• GET/members/{code}

  Página de un miembro: saldo, rachas, últimos días, permisos, faltas.

• POST/members/{code}/points

  Sumar o restar puntos: delta, note.

• GET/strikes

  Tipos de faltas. POST añade uno: title, penalty; PATCH y DELETE por código.

• POST/strikes/{code}/log

  Registrar una falta: member, note. La penalización se descuenta al momento.

• GET/stats

  Informe de un periodo: ?days=7, 30 o 90.

• GET/feed

  La actividad de la familia.

export QUESTBURG_API_KEY=qb_…
curl -s -H "Authorization: Bearer $QUESTBURG_API_KEY" https://questburg.com/api/v1/me

curl -s -X POST https://questburg.com/api/v1/offers \
  -H "Authorization: Bearer $QUESTBURG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title": "Take out the trash", "assignees": "kids", "points": 10, "weekdays": [3]}'

Qué conviene saber

• La clave actúa en nombre del adulto que la creó: lo que aprueba el agente queda registrado a su nombre.
• La clave no llega a contraseñas, códigos de acceso ni invitaciones. Una misión, un regalo o un permiso que se quita pasa al archivo — el historial se conserva.
• Repetir una marca o una aprobación es seguro: los puntos no se suman dos veces.
• El límite es de 60 peticiones por minuto por clave. Si se supera, llega un 429.
• Un error siempre tiene la misma forma: { error: { code, message } }.
• Puedes revocar la clave donde la creaste. El acceso se corta al instante.