svechapvl/yandex-mcp

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

58 stars 22 forks 품질 76 트렌드 17MIT

Repository Install

svechapvl/yandex-mcp는 MCP 서버 후보가 https://github.com/svechapvl/yandex-mcp.에서 수입되었습니다

개요

svechapvl/yandex-mcp는 MCP 서버 후보가 https://github.com/svechapvl/yandex-mcp.에서 수입되었습니다

개요(AI 번역)

̈ Русская версия

Yandex Direct, Yandex Metrika, Yandex Wordstat 및 Yandex Webmaster APIs에 대한 MCP (모델 컨텍스트 프로토콜) 서버. **132 도구 ** 광고 캠페인 관리, 분석, 키워드 연구, 유기 검색 및 MCP 호환 클라이언트를 통해보고.

AI를 통한 Yandex 광고 및 분석 관리

특징

Yandex 직접 API v5 (80 도구)

-Campaigns — 생성, 업데이트, 일시 중지, 재시작, 아카이브, 삭제

Ad Groups — 설정으로 생성, 업데이트
Ads — text, image, 역동적이고 쇼핑 광고
Keywords - 키워드 및 입찰 관리
Statistics - async retry의 상세한 성능 보고서 -Bid Modifiers - 모바일, 데스크탑, 인구 통계, 지역 조정 -Retargeting - 목록 및 청중 대상 목록
Smart Ad Targets - 필터 기반 -Sitelinks, VCards, Callouts - 광고 확장 -Images - 업로드, 관리, 삭제 광고 이미지 -Feeds - 제품 피드 관리 -Videos & Creatives - 비디오 광고 제작 -Dictionaries - 지역, 관심사, 범주
Negative Keywords - 공유된 부정적인 키워드 세트

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

README

원문 README의 일부입니다. 원문 보기.

Yandex MCP Server

🇷🇺 Русская версия

MCP (Model Context Protocol) server for Yandex Direct, Yandex Metrika, Yandex Wordstat, and Yandex Webmaster APIs. Provides 132 tools for managing advertising campaigns, analytics, keyword research, organic search, and reporting through any MCP-compatible client.

Manage Yandex advertising and analytics through AI

Features

Yandex Direct API v5 (80 tools)

Campaigns — create, update, pause, resume, archive, delete
Ad Groups — create, update with targeting settings
Ads — text, image, dynamic, shopping ads with moderation
Keywords — manage keywords and bids
Statistics — detailed performance reports with async retry
Bid Modifiers — mobile, desktop, demographics, regional adjustments
Retargeting — retargeting lists and audience targets
Smart Ad Targets — feed-based targeting filters
Sitelinks, VCards, Callouts — ad extensions
Images — upload, manage, and delete ad images
Feeds — product feed management
Videos & Creatives — video ad creation
Dictionaries — regions, interests, categories
Negative Keywords — shared negative keyword sets

Yandex Wordstat API (5 tools)

Top Requests — popular search queries and associations
Dynamics — query frequency trends over time
Regions — regional distribution of search queries
Regions Tree — hierarchical region structure
User Info — API quota and usage limits

Yandex Webmaster API v4 (4 tools)

User ID — resolve the token owner’s Webmaster UserID
Hosts — list verified sites and their IDs
Host Summary — SQI, searchable and excluded page counts
Popular Queries — organic search queries with shows, clicks, and positions

Yandex Metrika API (43 tools)

Counters — create, configure, delete tracking counters
Goals — conversion goal management
Reports — analytics with custom metrics, time series, comparisons, drill-down
Segments — audience segmentation
Filters — traffic filtering rules
Grants — access permission management
Offline Data — upload conversions, calls, expenses, user parameters
Labels & Annotations — organize counters and mark chart events
Delegates — account delegation

Quick Start

1. Install

git clone https://github.com/SvechaPVL/yandex-mcp.git
cd yandex-mcp
python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
pip install -e .

2. Set up your Yandex API token

Create a .env file:

YANDEX_TOKEN=your_oauth_token_here

GitHub에서 전체 README 보기

설치

npx @modelcontextprotocol/inspector python -m yandex_mcp

MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{
  "mcpServers": {
    "yandex": {
      "command": "python",
      "args": ["-m", "yandex_mcp"],
      "cwd": "/path/to/yandex-mcp",
      "env": {
        "YANDEX_TOKEN": "your_token"
      }
    }
  }
}