🗄 저장소가 보관됨

개발은 theYahia/YaAll 로 이전되었습니다 — Yandex 계층 전체가 한곳에 모여 있는 빌드: Yandex 공식 MCP 서버, Direct 및 Metrika용 MCP, YaGEO 스킬 및 Wordstat 게이트.

여기에 있던 내용의 최신 버전: mcp/yandex-direct-mcp/

여기서는 더 이상 업데이트되지 않습니다. 이슈 및 pull request는 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

Yandex.Direct API용 MCP 서버 — 모든 MCP 클라이언트(Claude, Cursor 등)에서 컨텍스트 광고 관리: 캠페인, 그룹, 광고, 키워드, 입찰가, 마이너스 키워드, 통계, 잔액. 20개 도구.

금액은 루블 단위입니다 (예산, 입출력 시 입찰가); 서버가 API 마이크로 단위로 자동 변환합니다. 안전한 테스트를 위한 샌드박스 및 에이전시 모드 (Client-Login)가 지원됩니다.

Related MCP server: yandex-direct-mcp

설치

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

구성 (환경 변수)

토큰 얻는 방법

OAuth 토큰은 Yandex OAuth에 등록된 앱에 대해 발급되며, Direct API 접근 권한이 필요합니다. 자세한 내용 — 앱 등록 및 토큰 발급. API 접근은 Direct 인터페이스에서 요청해야 합니다.

⚠️ 주의: 실제 비용 발생

create_campaign, create_text_ad, add_keywords, set_keyword_bids 등의 도구는 실제 광고 계정을 변경하며 비용이 발생할 수 있습니다. 시나리오 디버깅 시 샌드박스를 활성화하세요 (YANDEX_DIRECT_SANDBOX=1).

도구 (20개)

캠페인

광고 그룹

광고

키워드 및 입찰가

통계, 계정, 참조 데이터

요청 예시

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

개발

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

라이선스

MIT