К основному содержанию
скилл CX Codex

monologue-notes-api — скилл для Claude Code: читать заметки через API

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

CC0-1.0 221 установок ★ 304 обновлён 2026-04-25

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add intellectronica/agent-skills --skill monologue-notes-api -a claude-code
Открыть на GitHub

Что делает 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 скилл не допустит выполнение запроса и попросит у пользователя токен.

Какие задачи решает

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

Примеры запросов агенту

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

Как установить monologue-notes-api

1Через Skills CLI (Vercel)

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/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о monologue-notes-api

Как установить monologue-notes-api в Claude Code?

Выполни npx skills add intellectronica/agent-skills --skill monologue-notes-api -a claude-code, затем открой ~/.claude/skills/monologue-notes-api/SKILL.md.

Что делает monologue-notes-api?

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

Что нужно, чтобы скилл работал?

Переменная окружения MONOLOGUE_API_KEY с действующим токеном API и скоупом notes:read. Без неё агент откажется делать запросы и попросит ключ у пользователя.

Исходный текст

SKILL.md · CC0-1.0
---
name: monologue-notes-api
description: >
  Use this skill when the user wants to read or search their Monologue notes through the
  Monologue Notes REST API. It covers authentication with the MONOLOGUE_API_KEY environment
  variable, safe token handling, listing notes, fetching a single note, pagination, filters,
  and error handling. The API is read-only and should be accessed with direct HTTP requests
  such as curl or any equivalent REST client.
---

# Monologue Notes API

This skill provides the information needed to call the Monologue Notes REST API directly.
Use it for read-only operations on the authenticated user's notes.

Use whatever HTTP client fits the task: `curl`, a short script, or another REST-capable tool.
Do not invent client libraries unless the user asks for one.

## Authentication

Use the environment variable `MONOLOGUE_API_KEY` as the bearer token.

- Required auth header: `Authorization: Bearer $MONOLOGUE_API_KEY`
- Required scope: `notes:read`
- Never print the token, echo it, log it, or include it in a response to the user
- Only pass it through the `Authorization` header as a shell variable expansion

Check whether the token is available without displaying it:

```bash
if [ -z "${MONOLOGUE_API_KEY:-}" ]; then
  echo "MONOLOGUE_API_KEY is not set"
fi
```

If `MONOLOGUE_API_KEY` is missing:

- Report that the environment variable is not present
- Ask the user whether they want to provide an API key
- Do not attempt authenticated API calls until a token is available

Avoid commands such as these because they would expose secrets:

```bash
echo "$MONOLOGUE_API_KEY"
env | grep MONOLOGUE_API_KEY
set | grep MONOLOGUE_API_KEY
```

## Base URL

- Base URL: `https://api.monologue.to`
- API shape: read-only Notes API
- Data format: JSON
- Timestamps: ISO 8601 date-time strings

## Request Pattern

For all requests:

```bash
curl -sS \
  -H "Authorization: Bearer $MONOLOGUE_API_KEY" \
  "https://api.monologue.to/..."
```

If structured output is useful, pipe the response to `jq`.

## Endpoints

### List notes

`GET /v1/public-api/notes`

Returns a page of notes for the authenticated user.

Supported query parameters:

- `limit`: integer from `1` to `100`, default `20`
- `cursor`: opaque pagination cursor from a previous response
- `created_after`: ISO 8601 timestamp
- `created_before`: ISO 8601 timestamp
- `updated_after`: ISO 8601 timestamp
- `q`: full-text search across titles, summaries, and transcripts

Example:

```bash
curl -sS \
  -H "Authorization: Bearer $MONOLOGUE_API_KEY" \
  "https://api.monologue.to/v1/public-api/notes?limit=20&q=interview"
```

Example with `jq`:

```bash
curl -sS \
  -H "Authorization: Bearer $MONOLOGUE_API_KEY" \
  "https://api.monologue.to/v1/public-api/notes?limit=20" \
  | jq '{next_cursor, items: [.items[] | {note_id, title, summary, created_at, updated_at}]}'
```

Expected response fields:

- `items`: array of note summaries
- `next_cursor`: cursor for the next page, if any

Each list item may include:

- `note_id`
- `title`
- `summary`
- `created_at`
- `updated_at`

Possible errors:

- `400`: invalid filter or cursor
- `401`: missing or invalid token
- `403`: token lacks the required scope
- `422`: validation error

### Get a single note

`GET /v1/public-api/notes/{note_id}`

Returns the full details for one note belonging to the authenticated user.

Path parameters:

- `note_id`: note identifier returned by the list endpoint

Example:

```bash
curl -sS \
  -H "Authorization: Bearer $MONOLOGUE_API_KEY" \
  "https://api.monologue.to/v1/public-api/notes/NOTE_ID"
```

Example with `jq`:

```bash
curl -sS \
  -H "Authorization: Bearer $MONOLOGUE_API_KEY" \
  "https://api.monologue.to/v1/public-api/notes/NOTE_ID" \
  | jq '{note_id, title, summary, transcript, transcript_segments, created_at, updated_at}'
```

In addition to the list fields, the full note response may include:

- `transcript`
- `transcript_segments`

Notes:

- `transcript_segments` is loosely typed structured JSON and may be `null`
- `404` means the note was not found for the authenticated user

Possible errors:

- `401`: missing or invalid token
- `403`: token lacks the required scope
- `404`: note not found
- `422`: validation error

## Common Workflows

### Search notes by keyword

Use the `q` parameter:

```bash
curl -sS \
  -H "Authorization: Bearer $MONOLOGUE_API_KEY" \
  "https://api.monologue.to/v1/public-api/notes?q=meeting"
```

Search covers:

- note titles
- note summaries
- note transcripts

### Page through results

1. Call `GET /v1/public-api/notes`
2. Read `next_cursor` from the response
3. Pass that cursor back as the `cursor` query parameter
4. Stop when `next_cursor` is absent or `null`

Example:

```bash
curl -sS \
  -H "Authorization: Bearer $MONOLOGUE_API_KEY" \
  "https://api.monologue.to/v1/public-api/notes?limit=50&cursor=OPAQUE_CURSOR"
```

### Filter by time

Use ISO 8601 date-time values:

```bash
curl -sS \
  -H "Authorization: Bearer $MONOLOGUE_API_KEY" \
  "https://api.monologue.to/v1/public-api/notes?created_after=2026-01-01T00:00:00Z"
```

## Operating Rules

- Treat this API as read-only
- Do not claim write support; this skill only covers listing and reading notes
- Prefer `https://api.monologue.to` for requests
- When reporting failures, summarise the HTTP status and relevant response body without exposing the token
- If the user asks for a workflow that requires local post-processing, fetch the data first and then transform it separately

## Source Notes

This skill is based on:

- `/Users/eleanor/repos/obsidian/intellectronica/2026-04-21-20-10 Monologue API.md`
- Live OpenAPI checks against `https://api.monologue.to/public-openapi.json` on 2026-04-22

© intellectronica · CC0-1.0 · intellectronica/agent-skills

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
api-rate-limit-policy Samuel Berthe Скилл api-rate-limit-policy для Claude Code, Codex, Cursor и других агентов, который проектирует политику rate limit публичного API: модели измерения трафика, квоты по тирам, заголовки и поведение 429. CX Codex +1 10 400установок api-integration-surface-strategy Samuel Berthe Скилл api-integration-surface-strategy помогает решить, какие поверхности интеграции платформа отдаёт наружу — REST, GraphQL, gRPC, вебхуки, SDK, MCP — и в каком порядке их строить. CX Codex +1 10 400установок recoup-platform-api-access recoupable Скилл recoup-platform-api-access для Claude Code даёт агенту доступ к REST API платформы Recoup и внешним коннекторам. Он выгружает данные артистов, обновляет документы и отправляет письма. CX Codex +1 5 500установок api-design-patterns agent-skills Скилл api-design-patterns для Claude Code с 38 правилами проектирования REST API: ресурсы, ошибки, безопасность, пагинация, версионирование. Помогает агенту писать и проверять эндпоинты по единым стандартам. CX Codex +1 1 000установок api-designer zhaono1 Скилл api-designer для Claude Code и других агентов: проектирует новый API или разбирает существующий — ресурсы, методы, коды ответов, пагинация, версии. Контракт фиксируется в процессе работы. CX Codex +1 707установок api-testing-patterns proffesor-for-testing Скилл api-testing-patterns для Claude Code с готовыми паттернами тестирования REST и GraphQL API: контракты, авторизация, идемпотентность, гонки. Покрывает написание тестов и выбор стратегии. CX Codex +1 618установок

Из того же набора21

Весь набор →
tavily Находит данные в сети, извлекает текст со страниц, строит карту сайта и запускает глубокие исследования через REST API Tavily. CX Codex +1 636установок mgrep-code-search Скилл mgrep-code-search подключает семантический поиск по кодовой базе через утилиту mgrep. Он находит нужные места по смысловому описанию задачи, если в проекте больше 30 файлов. CX Codex +1 631установок gpt-image-1-5 Генерирует и редактирует изображения через модель GPT Image 1.5 от OpenAI. Создаёт графику по описанию, заменяет фон и выполняет точечный инпейнтинг по маске. CX Codex +1 625установок here-be-git Скилл here-be-git разворачивает git в текущей папке, добавляет инструкции для агента о коммитах и настраивает .gitignore. CX Codex +1 535установок ray-so-code-snippet Скилл ray-so-code-snippet для Claude Code делает из фрагмента кода картинку через ray.so и сохраняет её в текущую папку для показа в чате или посте. CX Codex +1 527установок lorem-ipsum Скилл lorem-ipsum генерирует текст-рыбу через готовый Python-скрипт с точным контролем структуры, длины и формата. Помогает наполнить макеты интерфейсов или тестовые документы реалистичным контентом. CX Codex +1 520установок raindrop-api Скилл raindrop-api связывает ИИ-агента с закладками Raindrop.io через REST API. Он нужен для поиска, создания, изменения и сортировки закладок. CX Codex +1 511установок upstash-redis-kv Скилл upstash-redis-kv для Claude Code, Codex, Cursor и ещё трёх агентов, который читает и пишет в Upstash Redis-совместимое key-value хранилище через REST API. CX Codex +1 477установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой