Подключите своего агента

Три шага

1. 1

   Выпустите ключ

   Ключ выпускает взрослый из семьи — прямо здесь. Войдите, и вернётесь к этой же форме.

   Войти и выпустить ключ
2. 2

   Поставьте скилл

   Скилл учит агента маршрутам и порядку действий. Подходит агентам, которые умеют запускать команды: Claude Code, Cursor, OpenClaw и похожим.

3. 3

   Попросите

   «Что сегодня у детей?», «Засчитай всё, что отметили», «Заведи Феде задание — выносить мусор по средам, 10 баллов».

Скилл

Первая команда ставит скилл, остальные кладут ключ туда, где скилл его ищет. В чат агенту ключ вставлять не нужно. 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

Если скилл не подходит — тот же API открыт напрямую. Ключ передаётся в заголовке, ответы в JSON.

https://questburg.com/api/v1

Агенту можно дать один адрес — там всё то же, но для него: questburg.com/llms.txt

• GET/me

  Семья, участники с кодами и баллами, права ключа.

• GET/today

  Дела на день. ?member=код — один участник, ?date=ГГГГ-ММ-ДД — другой день.

• GET/approvals

  Что дети отметили и что ждёт вашего ответа.

• POST/occurrences/{id}/done

  Отметить дело сделанным.

• POST/occurrences/{id}/approve

  Засчитать: баллы начисляются. Закрытый день — в пределах недели.

• POST/occurrences/{id}/reject

  Не принять отметку.

• POST/approvals/approve-all

  Засчитать всё, что дети отметили.

• GET/offers

  Действующие задания.

• POST/offers

  Завести задание: title, assignees (коды или "kids"), points, weekdays.

• PATCH/offers/{code}

  Изменить задание: присылать только то, что меняется.

• DELETE/offers/{code}

  Убрать задание. История остаётся.

• POST/occurrences/{id}/undo

  Отменить зачёт: баллы возвращаются, дело снова ждёт ответа.

• GET/starters

  Готовые дела и награды; first — с чего начать. POST { key } — дело детям, { reward } — награду.

• GET/rewards

  Подарки. POST — завести: title и price либо streak { quest, days }.

• PATCH/rewards/{code}

  Изменить подарок; DELETE — убрать.

• GET/redemptions

  Просьбы о подарках, ждущие ответа.

• POST/redemptions/{id}/grant

  Подарок выдан; /refuse — отказ.

• GET/gates

  Доступы и кто из детей открыл их сегодня. POST — завести: name, quests, price.

• PATCH/gates/{code}

  Изменить доступ; DELETE — убрать.

• POST/gates/{code}/override

  Выдать или закрыть доступ на сегодня: member, state (granted | blocked), note.

• GET/members/{code}

  Страница участника: баланс, серии, последние дни, доступы, страйки.

• POST/members/{code}/points

  Начислить или списать баллы: delta, note.

• GET/strikes

  Виды нарушений. POST — завести: title, penalty; PATCH и DELETE по коду.

• POST/strikes/{code}/log

  Зафиксировать нарушение: member, note. Штраф списывается сразу.

• GET/stats

  Отчёт за период: ?days=7, 30 или 90.

• GET/feed

  Лента событий семьи.

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]}'

Что важно знать

• Ключ действует от имени взрослого, который его выпустил: засчитанное агентом записывается на него.
• Ключу недоступны пароли, коды входа и приглашения. Убранное задание, подарок или доступ уходит в архив — история остаётся.
• Повторный запрос на отметку или зачёт безопасен: баллы второй раз не начислятся.
• Лимит — 60 запросов в минуту на ключ. Сверх него приходит 429.
• Ошибка всегда одной формы: { error: { code, message } }.
• Отозвать ключ можно там же, где выпускали. Доступ пропадает сразу.