🗄 Repositorio archivado

El desarrollo se ha trasladado a theYahia/YaAll — un repositorio donde toda la capa de Yandex está en un solo lugar: los servidores MCP oficiales de Yandex, MCP para Direct y Metrika, la skill YaGEO y la puerta de Wordstat.

La versión actual de lo que había aquí: mcp/yandex-direct-mcp/

Aquí ya no se actualiza nada. Las tareas y pull requests — en YaAll.

Archived — development moved to theYahia/YaAll, a single repository bundling the whole Yandex stack. The current version of this package now lives at mcp/yandex-direct-mcp/. Please open issues and pull requests there.

@theyahia/yandex-direct-mcp

Servidor MCP para la API de Yandex.Direct: gestión de publicidad contextual desde cualquier cliente MCP (Claude, Cursor, etc.): campañas, grupos, anuncios, palabras clave, pujas, frases negativas, estadísticas, saldo. 20 herramientas.

El dinero — en rublos (presupuestos, pujas de entrada y salida); el servidor convierte automáticamente a microunidades de la API. Se admiten sandbox para pruebas seguras y modo agencia (Client-Login).

Related MCP server: yandex-direct-mcp

Instalación

Claude Desktop

{
  "mcpServers": {
    "yandex-direct": {
      "command": "npx",
      "args": ["-y", "@theyahia/yandex-direct-mcp"],
      "env": {
        "YANDEX_DIRECT_TOKEN": "ваш_токен"
      }
    }
  }
}

Claude Code

claude mcp add yandex-direct -e YANDEX_DIRECT_TOKEN=ваш_токен -- npx -y @theyahia/yandex-direct-mcp

Configuración (variables de entorno)

Cómo obtener el token

El token OAuth se emite para una aplicación registrada en Yandex OAuth, con acceso a la API de Direct. Detalles — registro de la aplicación y obtención del token. El acceso a la API debe solicitarse en la interfaz de Direct.

⚠️ Atención: gastos reales

Las herramientas create_campaign, create_text_ad, add_keywords, set_keyword_bids, etc. modifican la cuenta publicitaria real y pueden gastar dinero. Para depurar escenarios, active el sandbox (YANDEX_DIRECT_SANDBOX=1).

Herramientas (20)

Campañas

Grupos de anuncios

Anuncios

Palabras clave y pujas

Estadísticas, cuenta, directorios

Ejemplos de consultas

Покажи все активные рекламные кампании
Создай кампанию "Летняя распродажа" с бюджетом 5000 ₽/день, старт 2026-05-01
Установи ставку 25 ₽ на ключевые фразы 111 и 222
Добавь минус-фразы "бесплатно", "скачать" в кампанию 12345
Какая статистика у кампаний 12345 и 67890 за последнюю неделю?
Найди код региона для Новосибирска
Покажи баланс аккаунта

Desarrollo

npm install
npm run build      # tsc → dist/
npm test           # vitest (моки fetch)
npm run dev        # tsx src/index.ts

Licencia

MIT