# Книга «Агенты и вайб-кодинг» · поиск и MCP — neuraldeep.ru API

> Раздел машиночитаемой справки. Все разделы: https://neuraldeep.ru/llms.txt · всё одним файлом: https://neuraldeep.ru/llms-full.txt

Base URL: `https://neuraldeep.ru/api/v1/books`
Auth: `Authorization: Bearer $YOUR_KEY`

Практический курс о работе с ИИ-агентами — 42 главы — доступен как поиск для агентов. **Нужен твой ключ Hub** — тот же `sk-`, что и для чата. Читалка на сайте открыта всем без ключа — [neuraldeep.ru/learn/books/agenty-vajbkoding](https://neuraldeep.ru/learn/books/agenty-vajbkoding).

Поиск гибридный: полнотекстовый BM25 плюс векторный по эмбеддингам `giga-embeddings` (370 чанков, нарезка по абзацам). Они ошибаются по-разному — полнотекстовый находит точное слово, но бессилен, когда спрашивают другими словами; векторный ловит смысл, но промахивается мимо термина. Слияние закрывает обе дыры, поэтому `mode=hybrid` стоит по умолчанию.

```bash
curl -G "https://neuraldeep.ru/api/v1/books/agenty-vajbkoding/search" \
  -H "Authorization: Bearer $YOUR_KEY" \
  --data-urlencode "q=сколько стоит держать много скиллов" \
  --data-urlencode "mode=hybrid" --data-urlencode "limit=5"
```

```json
{
  "query": "…", "mode": "hybrid", "used_vector": true,
  "hits": [{
    "chapter": "ch12",
    "chapter_title": "Скиллы: механика и жизненный цикл",
    "label": "Глава 12",
    "score": 0.032,
    "text": "Скиллы платные, даже когда не используются…",
    "url": "https://neuraldeep.ru/learn/books/agenty-vajbkoding/ch12"
  }]
}
```

**Эндпоинты**

| метод | что делает |
|---|---|
| `GET /api/v1/books` | список книг |
| `GET /api/v1/books/{slug}/toc` | оглавление: главы, приложения, модули |
| `GET /api/v1/books/{slug}/chapter/{id}` | полный текст главы (`ch12`, `appА`) |
| `GET /api/v1/books/{slug}/search` | поиск: `q`, `mode` = `hybrid`\|`fts`\|`vector`, `limit` 1–20 |

**MCP-сервер** — тот же поиск инструментами для твоего агента:

```json
{
  "mcpServers": {
    "neuraldeep-book": {
      "type": "http",
      "url": "https://neuraldeep.ru/api/mcp/book",
      "headers": { "Authorization": "Bearer $YOUR_KEY" }
    }
  }
}
```

Инструменты: `book_search` (гибридный поиск), `book_chapter` (глава целиком), `book_toc` (оглавление). Транспорт — JSON-RPC поверх HTTP, состояния сервер не держит. Без ключа — 401.

**Ограничения.** 60 запросов в минуту на ключ. Счёт идёт по владельцу ключа, а не по адресу, — доп-ключи считаются вместе с основным. Ответы модели по книге остаются в читалке: за ними GPU, и там действует лимит тарифа (free 10 вопросов в сутки).

Книга собрана из полугода переписки сообщества [t.me/aostrikov_agents_chat](https://t.me/aostrikov_agents_chat).