# openrouter-analytics-query

Скилл openrouter-analytics-query для построения и выполнения запросов к аналитике OpenRouter. Нужен, чтобы извлекать метрики по использованию моделей, группировать их по размерностям и фильтровать по времени и параметрам.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 355 установок · ★ 327 у репозитория
- Автор: OpenRouterTeam
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/OpenRouterTeam/skills/tree/HEAD/skills/openrouter-analytics-query/SKILL.md
- Обновлён: 2026-10-24
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/openrouter-analytics-query

## Что делает

Скилл предоставляет полный справочник по конструированию запросов к эндпоинту `POST /api/v1/analytics/query`. Поддерживает метрики (количество запросов, использование токенов), размерности (модель, API-ключ, страна, причина завершения), временные диапазоны с выбором гранулярности (минута, час, день, неделя, месяц), фильтры и сортировку. Можно группировать результаты по двум размерностям одновременно и применять дополнительные ограничения через `group_limit`.

Для работы требуется переменная окружения `OPENROUTER_API_KEY`, установленная на ключ управления — обычные API-ключи не подходят. Ключи управления выдаются отдельно в разделе Management Keys на openrouter.ai. Скилл включает справку по параметрам запроса, включая фильтры на основе классификаторов и работу с размерностями, которые требуют ID вместо читаемых имён (например, `api_key_id` хранит численный ID или хеш SHA-256, а не имя ключа).

Используй скилл при отладке аналитического запроса, проверке формата запроса и ответа или понимании того, как структурировать фильтры и размерности.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add OpenRouterTeam/skills --skill openrouter-analytics-query -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/openrouter-analytics-query/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/openrouter-analytics-query/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add OpenRouterTeam/skills --skill openrouter-analytics-query -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/openrouter-analytics-query/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add OpenRouterTeam/skills --skill openrouter-analytics-query -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/openrouter-analytics-query/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install OpenRouterTeam/skills skills/openrouter-analytics-query
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/openrouter-analytics-query/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add OpenRouterTeam/skills --skill openrouter-analytics-query -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/OpenRouterTeam/skills --path skills/openrouter-analytics-query
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/openrouter-analytics-query/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add OpenRouterTeam/skills --skill openrouter-analytics-query -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/OpenRouterTeam/skills/tree/HEAD/skills/openrouter-analytics-query/SKILL.md

## Когда брать
- построить запрос к аналитике OpenRouter с фильтрами и размерностями
- выбрать правильные метрики и сортировку для аналитического отчёта
- разобраться в формате фильтров и требованиях к временным диапазонам
- применить динамическую классификацию в группировке результатов
- отладить ошибку 400 при отправке запроса к `/api/v1/analytics/query`

## Примеры запросов агенту
- Покажи, как построить запрос для получения числа запросов по моделям за последние семь дней
- Помоги составить фильтр: отобрать только запросы модели `anthropic/claude-sonnet-4` с ответами из США
- Объясни, почему запрос отклоняется с ошибкой про временной диапазон и как его исправить

## Похожие
- [openrouter-cost-controls](https://affpapa.org/nevibecode/skills/openrouter-cost-controls.md) — скилл · 1 установка
- [cargo-analytics](https://affpapa.org/nevibecode/skills/cargo-analytics.md) — скилл · 11600 установок
- [analytics](https://affpapa.org/nevibecode/skills/apolloio-analytics.md) — скилл · 636 установок
- [lean-analytics](https://affpapa.org/nevibecode/skills/lean-analytics.md) — скилл · 3500 установок
- [analytics-and-reporting](https://affpapa.org/nevibecode/skills/analytics-and-reporting.md) — скилл · 1500 установок
- [tiktok-shop-analytics](https://affpapa.org/nevibecode/skills/tiktok-shop-analytics.md) — скилл · 1100 установок

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
