spokenmd/spoken

spokenmd/spoken

от spokenmd
Spoken - MCP сервер для поиска и получения расшифровок подкастов в Markdown с реальными именами спикеров. Идеален для LLM, RAG и AI-агентов. Автоматически разрешает имена, не требует загрузки аудио. Оплата за использование.

Spoken — podcast transcript API and MCP server, clean Markdown with real speaker names

Spoken is a transcript API that turns any published podcast into clean Markdown with real speaker names — not "Speaker 1." One API call returns named, timestamped text, ready for LLMs, RAG pipelines, summarizers, and search. This repo also ships spoken-mcp, an MCP server that gives Claude Desktop, Claude Code, Cursor and Cline the same transcripts as tools — see Use as an MCP server.

It's a transcript retrieval API, not a speech-to-text service: it works on already-published podcasts, so you skip uploading audio, running diarization, and mapping anonymous speaker labels by hand. For published shows that's typically 5–10× cheaper than running the audio through a transcription service.

  • 🎙️ Real speaker names, resolved automatically
  • 📄 Clean Markdown with timestamps, tuned for LLM context windows and RAG chunking
  • 🔎 Search by text query or paste a Spotify/YouTube URL
  • 💳 Pay-per-use credits — no subscription, failed calls never charged, repeat fetches free
  • 🤖 Agent-native — ships with an Agent Skill, agents.md, llms.txt, and an OpenAPI spec
Инструменты были проиндексированы:
follow_podcastидемпотентный

Оформляет подписку на шоу или снимает mute. Принимает podcast_id из search_podcasts. Оформленная подписка сохраняется до unfollow_podcast, независимо от активности загрузки, и не занимает один из пяти автоматических слотов. Для шоу, которое ещё ни разу не загружали, новым считается всё начиная с его самого свежего эпизода на текущий момент. Не расходует кредиты.

Следить за шоу

Параметры
  • podcast_idstringобязательный

    Показывает id (поле podcast_id из результата search_podcasts).

get_balanceтолько чтениеидемпотентный

Проверить текущий баланс кредитов Spoken, email аккаунта и недавнее использование для настроенного ключа API. Не расходует кредиты.

Получить баланс кредитов

Параметры

Без параметров.

get_transcriptтолько чтениеидемпотентныйвнешний мир

Загрузи стенограмму эпизода подкаста в виде чистого Markdown с реальными именами говорящих и временными метками. Передай идентификатор эпизода из search_podcasts. Стоит 1 кредит при первой загрузке эпизода; повторные загрузки бесплатны, а ошибки никогда не списываются.

Получить расшифровку

Параметры
  • episode_idstringобязательный

    Идентификатор эпизода, возвращаемый search_podcasts.

list_episodesтолько чтениеидемпотентныйвнешний мир

Выводит полный архив подкаста (все выпуски, от новых к старым). Принимает podcast_id из результата search_podcasts. Возвращает id, название и дату каждого выпуска — любой из них можно получить через get_transcript. Используйте эту команду, чтобы расшифровать целое шоу. Сама команда не тратит кредиты; расшифровка каждого возвращённого выпуска стоит 1 кредит (повторные запросы бесплатны), поэтому перед запуском цикла убедитесь, что у ключа достаточно кредитов.

Вывести список эпизодов шоу

Параметры
  • podcast_idstringобязательный

    Показывает id (поле podcast_id из результата search_podcasts).

list_followingтолько чтениеидемпотентный

Шоу, для которых этот ключ поддерживает актуальные данные. Каждая платная загрузка добавляет своё шоу в подписки: пять шоу с наибольшим числом загрузок за последние 180 дней подписываются автоматически (source 'fetch'), а ещё до 25 можно указать через follow_podcast (source 'explicit'). Заглушённые шоу перечисляются отдельно. Вызовите list_new_episodes, чтобы увидеть, что нового в них. Кредиты не расходует; у демо-ключа нет ничего для отслеживания.

Список отслеживаемых шоу

Параметры

Без параметров.

list_new_episodesтолько чтениеидемпотентный

Показывает, что нового в шоу, за которыми следит этот ключ: для каждого шоу: эпизоды, вышедшие за последние 90 дней, которые новее самого свежего уже полученного из него (до 10 на шоу), каждый с transcript_url. Эпизоды без транскрипта пропускаются. Получает любые через get_transcript (1 кредит за первое получение); получение поднимает нижнюю границу для этого шоу, так что следующий вызов перечисляет только то, что вышло после. Обновляется каждый час, поэтому шоу, на которое подписались только что, может быть пустым до первого опроса. Не расходует кредиты.

Перечисли новые эпизоды в отслеживаемых шоу.

Параметры

Без параметров.

search_podcastsтолько чтениеидемпотентныйвнешний мир

Ищет опубликованные выпуски подкастов по текстовому запросу или по ссылке на выпуск (Spotify, YouTube и т.д.). Возвращает подходящие выпуски с их id, названием, подкастом, podcast_id и датой. Используйте id с get_transcript или podcast_id с list_episodes, чтобы получить весь архив выпусков шоу. Не расходует кредиты.

Поиск подкастов

Параметры
  • querystringобязательный

    Произвольный текст (например, 'huberman sleep') или вставленный URL эпизода.

unfollow_podcastидемпотентный

Отключает шоу: оно пропадает из списка отслеживаемых, и последующие выборки не добавляют его обратно. follow_podcast отменяет это. Передаёт podcast_id из list_following. Не расходует кредиты.

Перестать следить за шоу.

Параметры
  • podcast_idstringобязательный

    Показывает id из list_following или search_podcasts.

0.4.3основная
0.4.2
0.4.1
0.4.0
0.3.1
0.3.0
0.2.2
0.2.1
0.2.0
0.1.2
0.1.1
0.1.0

Выберите клиент, чтобы установить spokenmd/spoken:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "spokenmd-spoken-zjkknxhbab": {
      "command": "npx",
      "args": [
        "-y",
        "spoken-mcp"
      ],
      "env": {
        "SPOKEN_API_KEY": "pt_your_key"
      }
    }
  }
}
CursorCursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "spokenmd-spoken-zjkknxhbab": {
      "command": "npx",
      "args": [
        "-y",
        "spoken-mcp"
      ],
      "env": {
        "SPOKEN_API_KEY": "pt_your_key"
      }
    }
  }
}
VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "spokenmd-spoken-zjkknxhbab": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "spoken-mcp"
      ],
      "env": {
        "SPOKEN_API_KEY": "pt_your_key"
      }
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"spokenmd-spoken-zjkknxhbab\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"spoken-mcp\"],\"env\":{\"SPOKEN_API_KEY\":\"pt_your_key\"}}"
ClaudeClaude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "spokenmd-spoken-zjkknxhbab": {
      "command": "npx",
      "args": [
        "-y",
        "spoken-mcp"
      ],
      "env": {
        "SPOKEN_API_KEY": "pt_your_key"
      }
    }
  }
}
Claude CodeClaude Code

Добавьте сервер одной командой в терминале:

claude mcp add spokenmd-spoken-zjkknxhbab --env SPOKEN_API_KEY=pt_your_key -- npx -y spoken-mcp

Либо через JSON-конфиг:

claude mcp add-json spokenmd-spoken-zjkknxhbab "{\"command\":\"npx\",\"args\":[\"-y\",\"spoken-mcp\"],\"env\":{\"SPOKEN_API_KEY\":\"pt_your_key\"}}"
CodexCodex

Добавьте сервер командой в терминале:

codex mcp add spokenmd-spoken-zjkknxhbab --env SPOKEN_API_KEY=pt_your_key -- npx -y spoken-mcp

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.spokenmd-spoken-zjkknxhbab]
command = "npx"
args = ["-y", "spoken-mcp"]

[mcp_servers.spokenmd-spoken-zjkknxhbab.env]
SPOKEN_API_KEY = "pt_your_key"
PerplexityPerplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

  1. Откройте Настройки аккаунта → Connectors.
  2. Установите вспомогательное приложение PerplexityXPC (один раз).
  3. Нажмите Add Connector → вкладка Simple.
  4. В поле Server Name укажите spokenmd/spoken, а в поле команды запуска — строку ниже:
npx -y spoken-mcp

Нажмите Save и дождитесь статуса Running.

WindsurfWindsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "spokenmd-spoken-zjkknxhbab": {
      "command": "npx",
      "args": [
        "-y",
        "spoken-mcp"
      ],
      "env": {
        "SPOKEN_API_KEY": "pt_your_key"
      }
    }
  }
}
ClineCline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "spokenmd-spoken-zjkknxhbab": {
      "command": "npx",
      "args": [
        "-y",
        "spoken-mcp"
      ],
      "env": {
        "SPOKEN_API_KEY": "pt_your_key"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}
Continue

Создайте файл в .continue/mcpServers/ (например spokenmd-spoken-zjkknxhbab.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: spokenmd-spoken-zjkknxhbab
    command: npx
    args:
      - "-y"
      - "spoken-mcp"
    env:
      SPOKEN_API_KEY: pt_your_key
Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "spokenmd-spoken-zjkknxhbab": {
      "command": "npx",
      "args": [
        "-y",
        "spoken-mcp"
      ],
      "env": {
        "SPOKEN_API_KEY": "pt_your_key"
      }
    }
  }
}

Похожие MCP-сервера

Alisammour/storyflo-mcp

Alisammour/storyflo-mcp

от alisammour

MCP сервер Storyflo даёт LLM-агентам доступ к аудио-новостям: поиск статей по темам, получение текста и аудио, подписка на ленты. Полезен разработчикам для интеграции озвученного контента в ИИ-ассистенты.

JavaScript⭐ 2
SubDownload/subdownload-mcp

SubDownload/subdownload-mcp

от subdownload

MCP сервер SubDownload интегрирует YouTube в ваш AI инструмент. Поиск видео, получение транскриптов (включая AI ASR), сохранение в базу знаний для повторного использования. Полезен разработчикам и ...

JavaScript⭐ 4
joelio/stocky

joelio/stocky

от joelio

MCP сервер Stocky объединяет Pexels и Unsplash для поиска и скачивания стоковых изображений в один инструмент. Идеален для разработчиков и контент-мейкеров, которые хотят быстро получать визуалы че...

Python⭐ 28
eyloni/pythia-oracle

eyloni/pythia-oracle

от eyloni

Сервер Pythia Oracle — творческий оракул для машин. Не даёт решений, а называет структуру ловушки, в которой вы застряли. Идеален для поиска неочевидных инсайтов и смены рамок мышления разработчикам и исследователям.

Python⭐ 1
CKBrennan/overtone-news-mcp

CKBrennan/overtone-news-mcp

от ckbrennan

Новостной MCP инструмент с анализом тональности и контекста. Отслеживает emerging stories, нарративные сдвиги и спайки эмоций. Идеален для ИИ-агентов, которым нужны смысл и тренды, а не просто заго...

Python⭐ 1
astroway/astroway-mcp

astroway/astroway-mcp

от astroway

MCP-сервер, превращающий все эндпоинты AstroWay Calculation API в готовые инструменты для Claude Desktop, Cursor и других AI-агентов. Включает натальные карты, синастрию, ведические даши, Таро, нумерологию, Human Design и AI гороскопы. Более 600 инструментов автоматически синхронизируются с API, ...

TypeScript⭐ 4
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин