Direct Manager — Яндекс 다이렉트용 MCP

Claude 또는 ChatGPT를 Яндекс 다이렉트에 연결하고 대화를 통해 광고를 관리하세요: "어디서 돈이 낭비되고 있나요?" → 어시스턴트가 ROAS < 1인 캠페인을 찾아 중지할 항목을 제안합니다.

Connect Claude or ChatGPT to Yandex Direct and manage ad campaigns in chat — analytics, wasted-spend detection, bids, budgets, negative keywords.

7일 무료 체험 — '프로' 요금제 →

웹사이트 / Website: https://app.marketscore.ru

개요

marketscore-direct-mcp는 호스트 MCP 서버 Direct Manager에 연결하는 가벼운 커넥터입니다. 서버 자체, Direct API 접근 및 모든 로직은 서비스 측에서 실행됩니다. 이 패키지는 AI 어시스턴트를 서비스에 연결하기만 하면 됩니다.

이 서비스에는 두 개의 독립적인 MCP 서버가 있습니다: 광고 서버(다이렉트, VK, Avito, Wordstat)와 SEO 서버(Webmaster, Search Console, Metrika, Topvisor) — 아래 SEO 섹션 참조.

작동 방식은 다음과 같습니다:

사용자: 지난 14일 동안 어디서 돈이 낭비되고 있나요?

Claude: 12,400₽ 상당의 문제 3개를 찾았습니다: '아파트 수리 — YAN' 캠페인이 단 한 건의 전환 없이 4,210₽을 지출했습니다. dsp.example 사이트는 ROAS 0.2를 기록했습니다. 지출은 발생했지만 신청이 전혀 없는 키워드 6개가 있습니다. 사이트를 중지하고 키워드를 제외 키워드에 추가할까요?

Related MCP server: meta-ads-mcp-server

기능

Direct API v5 및 Reports API 기반 최대 116개 도구 ('어시스턴트' 및 '프로' 요금제에서는 111개, '에이전시' 요금제에서는 포트폴리오 accounts_overview를 포함하여 116개):

• 분석 및 통계 — 기간 및 세그먼트별 캠페인 지표: 기기, 성별, 연령, YAN 사이트, 지역; 검색어; 노출 점유율.

• 비효율적 지출 검색 — ROAS < 1인 캠페인, 전환 없는 지출, 불필요한 사이트 및 키워드.

• 관리 — 일시 중지/재개, 일일 및 주간 예산, 전략(목표 및 타겟 CPA/ROAS를 포함한 전환 전략 포함), 제외 키워드, 키워드, 입찰가 및 조정.

• 처음부터 캠페인 구축 — 캠페인 → 그룹 → 빠른 링크 및 UTM이 포함된 광고.

• AI 인사이트 — 30일 지출 및 전환 예측, 하락 진단(트래픽/CR/CPC), 기간 간 변화 설명 및 동인, 루블 단위 순위별 상위 발견 사항, 한 번의 호출로 준비된 주간 브리핑.

• Wordstat — 빈도별 키워드 제안.

• 에이전시용 — 모든 계정의 포트폴리오 개요: 각 클라이언트의 지출, 수익, 불필요한 지출 및 잔여 예산을 한 번에 확인.

쓰기 작업은 별도의 주석으로 표시됩니다. 어시스턴트와 클라이언트는 수정 사항이 적용되기 전에 무엇이 변경되는지 확인할 수 있습니다. Direct API 오류는 '무음' 오류(API가 200을 반환하지만 수정 사항이 적용되지 않은 경우)를 포함하여 올바르게 처리됩니다.

MarketScore SEO — 검색 엔진 최적화를 위한 두 번째 MCP

동일한 계정에는 별도의 SEO용 MCP 서버가 있습니다. 광고가 아닌 유기적 검색에 관한 것입니다. 하나의 어시스턴트에 Яндекс Webmaster, Google Search Console, Яндекс Metrika, Topvisor 및 Wordstat가 통합되어 있습니다.

https://app.marketscore.ru/api/mcp/seo

이는 다른 주소와 다른 구독입니다. SEO 요금제는 다이렉트 요금제에 포함되지 않으며 그 반대도 마찬가지입니다. 다이렉트 도구는 SEO 주소에 나타나지 않으며 그 반대도 마찬가지입니다.

사용자: 지난 28일 동안 검색 트래픽이 왜 감소했나요?

Claude: 클릭이 940에서 610으로 감소했습니다. 두 기간을 모두 측정한 소스에 대해서만 비교를 계산합니다: Search Console — 예, Webmaster — 예, Topvisor가 연결되지 않아 순위는 독립적으로 확인되지 않았습니다. 주요 하락은 /catalog 섹션입니다. 18개 페이지가 '중복' 이유로 Яндекс 검색에서 제외되었으며, Webmaster가 8월 3일부터 이를 감지했습니다. 주소 목록을 표시할까요?

21개 도구 중 세 개만 무언가를 변경합니다(seo_add_keywords, seo_add_competitors, seo_request_recrawl) — 나머지는 읽기 전용입니다:

• 검색 데이터 — seo_overview (클릭, 노출, CTR, 평균 순위, 상위 3/상위 10 및 기간 비교), seo_search_queries (기기 및 지역별 Webmaster 및 Search Console의 쿼리 및 페이지), seo_positions (마지막 Topvisor 확인), seo_indexation (Yandex 검색에 있는 페이지 수, 제외된 페이지 및 그 이유), seo_metrika (검색 방문자의 행동 및 목표 달성), seo_landing_pages (진입 페이지별 방문 및 신청).

• 사이트 작업 — seo_audit (각 결론의 출처와 함께 색인 생성, 기술, on-page 및 경쟁 페이지 분석), seo_page_analysis (페이지 속도, Core Web Vitals 및 on-page 신호), seo_opportunities (상위권 근처 쿼리, CTR이 낮은 페이지, 클릭 없는 노출, 자기 잠식), seo_sitemaps (Yandex 및 Google이 사이트맵을 보는지 여부), seo_url_inspection (특정 URL에 대한 Google의 판결), seo_request_recrawl (Yandex에 URL 재크롤링 요청), seo_text_check (준비된 러시아어 텍스트의 AI 패턴, 관료적 표현 및 과도한 키워드 사용).

• 수요 — seo_keyword_demand: Wordstat의 빈도, 유사 구문, 노이즈 마킹 및 계절성.

• 키워드 및 확인 — seo_keywords (순위 확인 중인 항목), seo_add_keywords (확인할 구문 추가), seo_positions_plan (확인 일정, 시작 비용 및 Topvisor 잔액).

• 경쟁사 — seo_competitors (경쟁사 순위 옆의 당사 순위), seo_add_competitors (프로젝트에 경쟁사 사이트 추가).

• 프로젝트 — seo_projects (계정 사이트) 및 seo_sources (연결된 항목, 만료된 항목, 소스가 작동하지 않는 동안 정확히 알 수 없게 되는 항목).

동일한 API에 대한 래퍼와 다른 점:

• 응답에는 출처가 포함됩니다. 모든 숫자에는 출처와 수집 날짜가 있습니다. Webmaster에 대한 액세스가 취소되면 트래픽이 0으로 표시되는 것이 아니라 소스 거부로 표시됩니다. '데이터 없음'과 '문제 없음'은 다른 응답이며 모델이 이를 혼동해서는 안 됩니다.

• 수행되지 않은 확인 사항이 나열됩니다. 침묵하는 소스 또는 사이트에 대한 확인된 권한 없이 감사를 수행하면 '정확히 확인되지 않은 항목과 그 이유' 목록이 반환되고 평가가 상한선으로 제한되며 '모든 것이 정상'으로 낮춰지지 않습니다.

• 쓰기 경계는 비용을 기준으로 설정됩니다. 순위 확인의 유료 시작, 일정 변경, 채팅 내 키워드 및 경쟁사 삭제는 의도적으로 포함되지 않았습니다. 이는 Topvisor 잔액에서 비용을 차감하며, 비용은 차감 전에 화면에 표시되어야 합니다. 두 개의 쓰기 도구는 다음 순위 확인 비용을 증가시키며, 어시스턴트는 호출 전에 이 결과를 명시해야 합니다.

• 약속하지 않는 것: 전체 사이트 크롤링은 없습니다. 호출당 한 페이지만 확인됩니다. 텍스트 고유성은 확인되지 않습니다(출처가 없음). Topvisor가 연결되지 않은 순위는 생성되지 않습니다.

SEO 요금제 (별도 구독, 7일 무료): '스타트' — 590₽/월 (사이트 1개, 감사 2회, Wordstat 쿼리 20개), '프로' — 1,490₽/월 (사이트 5개, 감사 10회, Wordstat 200개), '에이전시' — 9,900₽/월 (사이트 20개, 감사 60회, Wordstat 2,000개). 모든 21개 도구는 활성 SEO 요금제에서 사용할 수 있습니다. 순위 확인은 귀하의 Topvisor 계정 잔액을 사용하여 작동합니다. 이에 대한 자체 마크업은 없습니다.

자세히 보기: https://app.marketscore.ru/seo

설치

Claude (데스크톱, 웹, Code) 및 ChatGPT — 링크를 통해

원격 MCP 커넥터 추가:

https://app.marketscore.ru/api/mcp        реклама: Яндекс Директ, VK, Авито, Wordstat
https://app.marketscore.ru/api/mcp/seo    органика: Вебмастер, Search Console, Метрика, Topvisor

어시스턴트가 로그인 페이지를 엽니다 — OAuth를 통해 인증합니다. Yandex 토큰은 어시스턴트에 전송되지 않습니다. 두 주소를 동시에 추가할 수 있습니다. 이는 독립적인 구독이 있는 독립적인 커넥터입니다.

로컬 MCP 클라이언트 (Cursor, VS Code, Cline, Zed) — 브리지를 통해

npx -y marketscore-direct-mcp

MCP 클라이언트 구성 예시:

{
  "mcpServers": {
    "direct-manager": {
      "command": "npx",
      "args": ["-y", "marketscore-direct-mcp"]
    }
  }
}

요금제 및 액세스

커넥터에는 Direct Manager 계정이 필요합니다. 가입 시 — '프로' 요금제 7일 무료 (Claude/ChatGPT의 AI 어시스턴트 포함). 이후:

• '어시스턴트' — 990₽/월: AI 채팅 작업을 위한 전체 MCP 세트 (111개 도구), 최대 3개의 다이렉트 계정. 웹 대시보드 없음 — 어시스턴트만.

• '프로' — 1,990₽/월: 동일한 111개 도구 에 분석 및 자동 조종 장치가 포함된 웹 대시보드 추가, 최대 5개의 다이렉트 계정.

• '에이전시' — 9,900₽/월: 116개 도구 (포트폴리오 accounts_overview 추가), 최대 20개 계정.

• SEO — 별도 요금제 축 (590 / 1,490 / 9,900₽/월) 및 별도 커넥터 주소. 다이렉트 요금제는 SEO 도구에 대한 액세스를 제공하지 않으며 그 반대도 마찬가지입니다.

활성 요금제가 없으면 서버는 0개의 도구를 반환합니다. 가입: https://app.marketscore.ru/register · 요금제: https://app.marketscore.ru/pricing · SEO: https://app.marketscore.ru/seo

Direct API용 오픈 소스 래퍼와의 차이점

Direct API용 자체 호스팅 MCP 래퍼(예: mcp-yandex-direct)가 있습니다. 정직한 비교:

보안

• 인증 — OAuth 2.1: Yandex 토큰은 어시스턴트에 전송되지 않으며 클라이언트 구성에 저장되지 않습니다. 서비스 측에 저장됩니다.

• Direct Manager 계정 비밀번호를 변경하면 발급된 모든 MCP 액세스가 취소됩니다.

• 쓰기 작업은 주석으로 표시되며 MCP 클라이언트 측에서 확인됩니다.

• 개인 데이터는 러시아 연방 서버에 저장됩니다 (152-FZ).

FAQ

무료인가요? 처음 7일은 무료입니다 (가입 시 '프로' 요금제 평가판). 이후에는 '어시스턴트' 요금제 (990₽/월, MCP 전용) 이상이 필요합니다.

Direct 토큰은 어디로 전송되나요? OAuth 연결 시 Direct Manager 서비스에 발급되어 해당 서버에 저장됩니다. 어시스턴트와 MCP 클라이언트는 토큰을 볼 수 없습니다.

어시스턴트가 계정을 망가뜨릴 수 있나요? 쓰기 도구는 별도로 표시되며 MCP 클라이언트는 호출 전에 확인을 요청합니다. 자동 조종 장치는 캠페인 일시 중지 및 예산을 직접 건드리지 않습니다. 사용자의 명령에 따라서만 작동합니다.

ChatGPT, Cursor, VS Code에서 작동하나요? 예: Claude 및 ChatGPT는 URL을 통해 직접 연결됩니다. Cursor/VS Code/Cline/Zed는 이 패키지(npx -y marketscore-direct-mcp)를 통해 연결됩니다.

무료 MCP 래퍼와 어떻게 다른가요? API 액세스 외에도 AI 인사이트 레이어, 감사, 대시보드, Telegram 봇 및 포트폴리오 개요가 포함됩니다. Yandex 토큰이 구성에 저장되지 않습니다. 자세한 내용은 위 표를 참조하세요.

구독 없이 작동하나요? 아니요. 활성 요금제가 없으면 서버는 0개의 도구를 반환합니다.

SEO도 지원하나요? 예, 별도의 MCP 서버로 지원합니다: https://app.marketscore.ru/api/mcp/seo — Яндекс Webmaster, Google Search Console, Metrika, Topvisor 및 Wordstat 기반 21개 도구. 구독은 Direct 요금제와 별개이며 7일 평가판이 있습니다.

Docker

docker build -t marketscore-direct-mcp .
docker run -i --rm -v ~/.mcp-auth:/root/.mcp-auth marketscore-direct-mcp

OAuth URL이 stdout에 인쇄됩니다. 컨테이너에서 브라우저가 열리지 않으므로 링크를 수동으로 방문하십시오. mcp-remote 토큰은 ~/.mcp-auth에 저장됩니다. 볼륨을 마운트하여 실행할 때마다 재인증하지 않도록 하십시오.

유용한 링크

• Яндекс Директ용 MCP 서버란 무엇인가: https://app.marketscore.ru/blog/mcp-server-yandex-direct

• Яндекс Директ용 AI — 2026년 도구: https://app.marketscore.ru/blog/ii-dlya-yandex-direkta-instrumenty-2026

• Claude 및 ChatGPT를 통한 Директ 관리: https://app.marketscore.ru/blog/upravlenie-yandex-direct-cherez-claude-chatgpt

• Яндекс 웹마스터용 MCP 서버: https://app.marketscore.ru/blog/mcp-server-yandex-webmaster

• SEO용 신경망 — 실제로 자동화되는 것: https://app.marketscore.ru/blog/nejroset-dlya-seo-avtomatizaciya

• Search Console에서 클릭이 일치하지 않는 이유: https://app.marketscore.ru/blog/search-console-kliki-ne-shodyatsya

한국어

Direct Manager는 Yandex Direct(러시아 검색 광고)용 AI/MCP 서비스입니다. 이 패키지는 호스팅된 Direct Manager MCP 서버에 대한 얇은 커넥터입니다. Claude, ChatGPT 또는 모든 MCP 클라이언트가 채팅에서 Yandex Direct 계정의 캠페인 분석을 읽고 작업(일시 중지, 입찰가, 예산, 마이너스 키워드)을 실행할 수 있게 해줍니다.

설치(원격, Claude/ChatGPT): 커넥터 URL https://app.marketscore.ru/api/mcp을 추가하고 OAuth로 로그인합니다.

설치(로컬 MCP 클라이언트 — Cursor, VS Code, Cline, Zed):

{
  "mcpServers": {
    "direct-manager": {
      "command": "npx",
      "args": ["-y", "marketscore-direct-mcp"]
    }
  }
}

도구: Direct API v5 및 Reports API 기반 최대 116개 도구 — 기기/성별/연령/게재위치/지리별 캠페인 분석, 검색어, 노출 점유율, 낭비 지출 감지(ROAS < 1), 캠페인 관리(일시 중지, 예산, 전략, 마이너스 키워드, 입찰가), 처음부터 캠페인 구축, AI 인사이트(지출 예측, 하락 진단, 변경 설명, 주간 브리핑), Wordstat 키워드 조사, 에이전시용 계정 간 포트폴리오 개요.

SEO MCP(별도 서버): https://app.marketscore.ru/api/mcp/seo — Yandex Webmaster, Google Search Console, Yandex Metrica, Topvisor 및 Wordstat 기반 유기적 검색용 21개 도구: 검색 실적 및 기간 비교, 검색어 및 페이지, 제외 사유가 포함된 Yandex 색인 상태, 성장 기회(상위 근접 검색어, 낮은 CTR 페이지, 클릭 없는 노출, 카니발리제이션), 모든 발견 사항 뒤에 출처와 날짜가 있는 전체 SEO 감사, 단일 페이지 기술 분석(PageSpeed, Core Web Vitals, on-page 신호), 두 엔진의 사이트맵 상태, Google URL 검사, Yandex 재크롤 요청, 경쟁업체 순위, Topvisor 키워드 관리, Metrica의 랜딩 페이지 전환, 결정적 러시아어 텍스트 검사. 쓰기 전용 도구는 3개뿐입니다. 유료 순위 확인은 의도적으로 채팅에서 제외됩니다. 모든 답변에는 출처가 포함됩니다. — 해지된 출처는 트래픽 0이 아닌 출처 오류로 표시됩니다. 별도 구독(590 / 1,490 / 9,900 ₽/월, 7일 무료 평가판): https://app.marketscore.ru/seo

가격: Direct Manager 계정이 필요합니다. 가입 시 7일 무료 Pro 평가판이 포함됩니다. Assistant — 990 ₽/월(111개 도구, 채팅 전용, Direct 계정 3개); Pro — 1,990 ₽/월(111개 도구 + 웹 대시보드, 계정 5개); Agency — 9,900 ₽/월(포트폴리오 개요 포함 116개 도구, 계정 20개). SEO는 별도 커넥터 URL의 별도 요금제 축입니다. 활성 요금제가 없으면 서버는 도구를 0개 노출합니다.

FAQ:

무료인가요? 처음 7일은 무료입니다(가입 시 Pro 평가판). 이후에는 구독이 필요합니다.

제 Yandex 토큰은 어디로 가나요? Direct Manager 서비스에 유지됩니다. — 어시스턴트와 MCP 클라이언트는 이를 볼 수 없으며 로컬 구성에 저장되지 않습니다.

어시스턴트가 제 광고 계정을 망가뜨릴 수 있나요? 쓰기 도구는 별도로 주석 처리되며 MCP 클라이언트는 실행 전에 확인을 요청합니다.

키워드: Yandex Direct, Яндекс Директ, MCP, Model Context Protocol, MCP server, PPC, ads management, campaign analytics, ROAS, negative keywords, Wordstat, Claude, ChatGPT, Cursor, AI marketing, SEO MCP, Yandex Webmaster, Яндекс Вебмастер, Google Search Console, Yandex Metrica, Topvisor, SEO audit, ИИ-менеджер для Яндекс Директа, ИИ для рекламы.

라이선스

MIT — LICENSE 참조. 커넥터는 공개되어 있습니다. Direct Manager 서비스는 유료 SaaS입니다. / The connector is open; the Direct Manager service is a paid SaaS.