API для ИИ-агентов
Ключ позволяет ИИ-агенту или скрипту работать с GEObobr: читать сводку и ответы нейросетей, создавать AI-проекты, добавлять вопросы и конкурентов, запускать бесплатный GEO-анализ сайта.
Что агент может и чего не может
- Может: видеть AI-проекты, сводку (видимость, цитирование, доля голоса, позиция, тональность), ответы нейросетей с полным текстом, источники и кандидатов в конкуренты; создавать проекты, добавлять вопросы и конкурентов; запускать GEO-анализ и читать отчёты.
- Запуск AI-замеров (они списывают ваши баллы) по умолчанию выключен. Вы выдаёте его ключу отдельно: без ограничений (каждый запуск агент согласует с вами, называя стоимость) или с лимитами баллов на один запуск и за сутки.
- Не может никогда: удалять проекты, выдавать доступ другим людям, менять расписание.
- Ключ действует от вашего имени и не даёт больше, чем у вас есть. Его можно ограничить разделами и сроком и отозвать в любой момент.
Как выдать ключ
- Профиль → «API для агентов» → «Новый ключ».
- Отметьте разделы (AI-трекер, GEO-анализ) и права: «только чтение» или «чтение и запись».
- Скопируйте ключ сразу: он показывается один раз. Потеряли — отзовите и выдайте новый. Сразу после создания панель показывает готовый код подключения для Claude Code, Cursor, Codex и opencode.
Запросы
Базовый адрес — https://geobobr.ru/api/v1/, формат — JSON, заголовок Authorization: Bearer <ключ>. Список всех вызовов отдаёт GET /api/v1/ без ключа.
curl -H "Authorization: Bearer $TOKEN" https://geobobr.ru/api/v1/ai/projects
Запуск замеров
Замер списывает баллы владельца проекта, поэтому защита не держится на поведении агента: сервер сам проверяет право запуска у ключа, лимиты (если заданы) и подтверждение стоимости — confirm_cost должен совпасть с оценкой из GET /ai/projects/{id}/estimate. Каждый запуск через ключ пишет вам уведомление в панели.
Ошибки и лимиты
- Ошибка приходит как
{"error": {"code", "message"}}с HTTP-статусом: 400 — неверные данные, 401 — нет или неверный ключ, 403 — нет прав (ключ только для чтения, вне раздела), 404 — не найдено, 409 — конфликт, 429 — лимит. - Не больше 120 запросов в минуту на ключ. Десять неверных ключей с одного адреса блокируют адрес на 12 часов.
- Все запросы ключа пишутся в журнал, последний запрос виден в списке ключей.
MCP для AI-видимости
Сервис сам работает как MCP-сервер (MCP по HTTP): агенту нужны только адрес и ключ. Те же права, ограничения и журнал, что у обычного API. Нужен ключ с разделом «AI-трекер».
Claude Code:
claude mcp add --transport http geobobr-ai https://geobobr.ru/mcp/ai --header "Authorization: Bearer gbk_..."
Cursor (файл ~/.cursor/mcp.json или .cursor/mcp.json проекта):
{"mcpServers": {"geobobr-ai": {"url": "https://geobobr.ru/mcp/ai", "headers": {"Authorization": "Bearer gbk_..."}}}}
MCP для GEO-анализа
Сервер /mcp/geo: агент запускает бесплатный GEO-анализ сайта (нужен ключ с правом записи, лимиты те же, что на странице анализа), получает отчёт — итог, проблемы с объяснением и советом, доступ ИИ-ботов, изменения с прошлой проверки — и список своих анализов.
claude mcp add --transport http geobobr-geo https://geobobr.ru/mcp/geo --header "Authorization: Bearer gbk_..."
Клиентам, которые умеют запускать только локальные программы (stdio), подойдёт мост mcp/server.py из папки проекта.