# monologue-notes-api

Скилл monologue-notes-api для чтения и поиска заметок Monologue через REST API. Работает с аутентификацией по MONOLOGUE_API_KEY, поддерживает пагинацию, фильтры по времени и полнотекстовый поиск.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 221 установка · ★ 304 у репозитория
- Автор: intellectronica
- Лицензия: CC0-1.0 · policy=mirror · лицензия открытая, файл — в исходнике
- Исходник: https://github.com/intellectronica/agent-skills/tree/HEAD/skills/monologue-notes-api/SKILL.md
- Обновлён: 2026-04-25
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/monologue-notes-api

## Что делает

Скилл даёт всё необходимое для работы с read-only API Monologue Notes. Под капотом — прямые HTTP-запросы через `curl` или любой другой REST-клиент. Два основных эндпоинта: `GET /v1/public-api/notes` для списка заметок с поддержкой лимитов, курсоров, поиска по `q` и фильтров по датам создания и обновления; `GET /v1/public-api/notes/{note_id}` для полного содержимого одной заметки с транскриптом и его сегментами.

Аутентификация работает через переменную окружения `MONOLOGUE_API_KEY` в заголовке `Authorization: Bearer`. Скилл учит безопасно проверять наличие токена без логирования и обрабатывать ошибки вроде 401 (токен не валиден), 403 (не хватает скоупа `notes:read`) и 404 (заметка не найдена). API возвращает JSON с ISO 8601 датами; можно пайпить ответы в `jq` для нужной структуры.

Поиск охватывает названия, сводки и полные транскрипты заметок. Для больших наборов работает пагинация через `cursor` из предыдущего ответа — передаёшь его обратно в параметре и идёшь к следующей странице, пока `next_cursor` есть. Без `MONOLOGUE_API_KEY` скилл не допустит выполнение запроса и попросит у пользователя токен.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add intellectronica/agent-skills --skill monologue-notes-api -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add intellectronica/agent-skills --skill monologue-notes-api -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add intellectronica/agent-skills --skill monologue-notes-api -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install intellectronica/agent-skills skills/monologue-notes-api
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add intellectronica/agent-skills --skill monologue-notes-api -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/intellectronica/agent-skills --path skills/monologue-notes-api
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add intellectronica/agent-skills --skill monologue-notes-api -a opencode
```

### Claude.ai

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

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

## Когда брать
- найти заметку по ключевому слову в названии, сводке или транскрипте
- вытащить полный текст и структурированные сегменты из одной заметки
- листать большие списки заметок по 20–100 за раз
- отфильтровать заметки по датам создания или изменения
- безопасно работать с API-ключом, не выводя его в логи

## Примеры запросов агенту
- Найди все заметки со словом «встреча» в содержимом
- Получи полный текст заметки с ID `NOTE_ID`
- Покажи 50 последних заметок, созданных после 1 января 2026

## Похожие
- [api-rate-limit-policy](https://affpapa.org/nevibecode/skills/api-rate-limit-policy.md) — скилл · 10400 установок
- [api-integration-surface-strategy](https://affpapa.org/nevibecode/skills/api-integration-surface-strategy.md) — скилл · 10400 установок
- [recoup-platform-api-access](https://affpapa.org/nevibecode/skills/recoup-platform-api-access.md) — скилл · 5500 установок
- [api-design-patterns](https://affpapa.org/nevibecode/skills/api-design-patterns.md) — скилл · 1000 установок
- [api-designer](https://affpapa.org/nevibecode/skills/zhaono1-api-designer.md) — скилл · 707 установок
- [api-testing-patterns](https://affpapa.org/nevibecode/skills/api-testing-patterns.md) — скилл · 618 установок

Из того же набора: [intellectronica/agent-skills](https://affpapa.org/nevibecode/by/intellectronica/agent-skills.md) — 21 карточка

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