# Spoken

Отдаёт агенту готовые транскрипты вышедших подкастов в Markdown с настоящими именами спикеров. Пригодится, когда нужен текст выпуска без возни с аудио.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5
- Автор: spokenmd
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/spokenmd/spoken
- Обновлён: 2026-10-06
- HTML: https://affpapa.org/nevibecode/mcp/spoken

## Что делает

Spoken — это API для получения транскриптов уже опубликованных подкастов. Аудио никуда загружать не надо, диаризацию запускать тоже: сервис сам подставляет имена говорящих вместо безликих «Speaker 1», расставляет таймкоды и возвращает Markdown, удобный для контекста LLM и нарезки на чанки для RAG.

Локальный вариант ставится как `spoken-mcp` через `npx`, хостед — по адресу `https://spoken.md/mcp`. Оба дают восемь инструментов: поиск выпусков по тексту или ссылке на Spotify и YouTube, список эпизодов шоу, получение транскрипта, проверка баланса, подписки на шоу и новые выпуски по ним. Для работы нужен ключ `SPOKEN_API_KEY`; без него берётся демо-ключ `pt_demo`, и тогда поиск работает полностью, а транскрипты доступны только для демо-выпуска.

Оплата поштучная, кредитами, без подписки. Повторное получение того же транскрипта кредитов не списывает, за неудачные вызовы тоже не берут. Если планируете держать базу знаний в актуальном состоянии, схема такая: по расписанию вызывать `list_new_episodes`, а затем `get_transcript` по тому, что он вернул.

## Требования
- Нужно: Node.js (команды через npx)
- Удалённый сервер: `https://spoken.md/mcp`
- Переменные окружения: `SPOKEN_API_KEY` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

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

1. **Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http spoken https://spoken.md/mcp
```

2. **Командой платформы**
```bash
claude mcp add --env SPOKEN_API_KEY=<SPOKEN_API_KEY> --transport stdio spoken -- npx -y spoken-mcp
```
Вместо <…> подставьте свои значения

### Codex

1. **Командой платформы: удалённый сервер**
```bash
codex mcp add spoken --url https://spoken.md/mcp
```

2. **Командой платформы**
```bash
codex mcp add spoken --env SPOKEN_API_KEY=<SPOKEN_API_KEY> -- npx -y spoken-mcp
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "spoken": {
            "url": "https://spoken.md/mcp"
        }
    }
}
```
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "spoken": {
            "command": "npx",
            "args": [
                "-y",
                "spoken-mcp"
            ],
            "env": {
                "SPOKEN_API_KEY": "<SPOKEN_API_KEY>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "spoken": {
            "type": "http",
            "url": "https://spoken.md/mcp"
        }
    }
}
```
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "spoken": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "spoken-mcp"
            ],
            "env": {
                "SPOKEN_API_KEY": "<SPOKEN_API_KEY>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

1. **Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http spoken https://spoken.md/mcp
```

2. **Командой платформы**
```bash
gemini mcp add -e SPOKEN_API_KEY=<SPOKEN_API_KEY> spoken npx -y spoken-mcp
```
Вместо <…> подставьте свои значения

## Когда брать
- получить текст выпуска подкаста без загрузки аудио
- подставить настоящие имена спикеров вместо анонимных меток
- нарезать транскрипт на чанки для векторного хранилища
- следить за новыми эпизодами любимых шоу
- найти выпуск по ссылке на Spotify или YouTube

## Примеры запросов агенту
- Найди выпуск подкаста про сон по запросу и покажи его транскрипт
- Собери Markdown-транскрипт этого эпизода с именами спикеров
- Покажи новые выпуски шоу, которые я ещё не забирал

## Похожие
- [MCP Toolbox for Databases](https://affpapa.org/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP-сервер · ★ 16717
- [labelhead-artist-momentum](https://affpapa.org/nevibecode/mcp/labelhead-artist-momentum.md) — MCP-сервер · ★ 107423
- [Agent Skills Search Server](https://affpapa.org/nevibecode/mcp/agent-skills-search-server.md) — MCP-сервер · ★ 26559
- [Skyvern](https://affpapa.org/nevibecode/mcp/skyvern.md) — MCP-сервер · ★ 23263
- [Nhost](https://affpapa.org/nevibecode/mcp/nhost.md) — MCP-сервер · ★ 9366
- [PraisonAI](https://affpapa.org/nevibecode/mcp/praisonai.md) — MCP-сервер · ★ 9289

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