Avito 광고 MCP

A1 Avito 광고 MCP는 AI 애플리케이션을 Avito 광고 계정에 연결합니다. 자연어로 캠페인과 통계를 확인하고, 그룹 예산과 입찰가를 관리하며, 에이전시 잔액, 액세스 권한 및 ORD 문서를 처리하는 데 도움을 줍니다.

이것은 Avito 판매자 API가 아닙니다: 서버는 상품, 메시지, 주문 또는 판매자 광고 홍보를 처리하지 않습니다. Avito 광고 계정의 미디어 및 퍼포먼스 캠페인만 처리합니다.

• 25가지 도구. 캠페인, 그룹, 크리에이티브, 통계, 잔액, 하위 계정, 사용자 및 ORD 문서.

• 좁은 캠페인 변경. API는 그룹 예산과 입찰가만 변경할 수 있습니다. 캠페인, 그룹 및 크리에이티브를 생성, 편집, 일시 중지 또는 삭제할 수 없습니다.

• 되돌릴 수 없는 작업이 표시됩니다. 돈 또는 보너스 이체, 사용자 삭제 및 기술적 API 요청은 destructive로 표시됩니다.

• 주간 API 예산. 각 호출은 포인트를 소비합니다. 서버는 결과와 함께 잔여 apiPointBalance를 반환합니다.

데이터만 읽는 요청으로 시작하세요:

내 Avito 계정의 캠페인과 지난주 광고 그룹별 지출을 보여줘.

서버 연결 · 시나리오 보기 · 기술 문서 열기

1분 만에 작동 확인

사용자: 내 Avito 계정의 캠페인과 지난주 광고 그룹별 지출을 보여줘.

어시스턴트: 캠페인, 그룹, 지출, 클릭 및 노출을 표시합니다. 아무것도 변경되지 않습니다.

사용자: 그룹 101의 입찰가를 350루블로 변경하는 것을 준비해줘.

어시스턴트: 계정, 그룹, 현재 및 새 입찰가를 표시한 다음 확인을 요청합니다.

사용자: 확인합니다.

어시스턴트: 해당 그룹의 입찰가만 변경합니다. 캠페인, 크리에이티브 및 다른 그룹은 변경되지 않습니다.

Related MCP server: VK Ads MCP

목차

• 빠른 시작

• 무엇을 맡길 수 있나요

• 무엇이 변경될 수 있나요

• 액세스 권한 얻기

• 설정

• 데이터, 제한 및 백그라운드 작업

• 기술 문서

• 지원

빠른 시작

Node.js 20+, Client Key, Client Secret 및 Avito 광고 계정 ID가 필요합니다. 액세스 권한을 부여하려면 계정 관리자 역할이 필요합니다.

1. 액세스 권한을 얻으세요.

2. AI 애플리케이션에 서버를 추가하세요.

3. 위의 안전한 첫 번째 요청을 보내세요.

Settings → Plugins → MCP servers에서 Add server를 클릭한 다음 AVITO_ADS_CLIENT_ID, AVITO_ADS_CLIENT_SECRET 및 AVITO_ADS_ACCOUNT_ID와 함께 npx -y mcp-avito-ads@latest를 추가하세요.

codex mcp add avito-ads \
  --env AVITO_ADS_CLIENT_ID=your_client_key \
  --env AVITO_ADS_CLIENT_SECRET=your_client_secret \
  --env AVITO_ADS_ACCOUNT_ID=your_account_id \
  -- npx -y mcp-avito-ads@latest
codex mcp list

Codex MCP 문서

claude mcp add \
  --env AVITO_ADS_CLIENT_ID=your_client_key \
  --env AVITO_ADS_CLIENT_SECRET=your_client_secret \
  --env AVITO_ADS_ACCOUNT_ID=your_account_id \
  --transport stdio --scope user avito-ads \
  -- npx -y mcp-avito-ads@latest
claude mcp list

Claude Code MCP 문서

Settings → Developer → Edit Config를 열고 다음을 추가하세요:

{"mcpServers":{"avito-ads":{"command":"npx","args":["-y","mcp-avito-ads@latest"],"env":{"AVITO_ADS_CLIENT_ID":"your_client_key","AVITO_ADS_CLIENT_SECRET":"your_client_secret","AVITO_ADS_ACCOUNT_ID":"your_account_id"}}}}

Edit Config를 사용할 수 없으면 macOS에서는 ~/Library/Application Support/Claude/claude_desktop_config.json을, Windows에서는 %APPDATA%\Claude\claude_desktop_config.json을 편집하세요. Claude Desktop MCP 문서

macOS/Linux에서는 ~/.cursor/mcp.json에, Windows에서는 %USERPROFILE%\.cursor\mcp.json에 {"mcpServers":{"avito-ads":{"type":"stdio","command":"npx","args":["-y","mcp-avito-ads@latest"],"env":{"AVITO_ADS_CLIENT_ID":"your_client_key","AVITO_ADS_CLIENT_SECRET":"your_client_secret","AVITO_ADS_ACCOUNT_ID":"your_account_id"}}}}를 추가하세요. Cursor MCP 문서

MCP: Open User Configuration을 실행하고 다음을 추가하세요:

{"servers":{"avito-ads":{"type":"stdio","command":"npx","args":["-y","mcp-avito-ads@latest"],"env":{"AVITO_ADS_CLIENT_ID":"${input:avito_client_id}","AVITO_ADS_CLIENT_SECRET":"${input:avito_client_secret}","AVITO_ADS_ACCOUNT_ID":"${input:avito_account_id}"}}},"inputs":[{"type":"promptString","id":"avito_client_id","description":"Avito Ads Client Key"},{"type":"promptString","id":"avito_client_secret","description":"Avito Ads Client Secret","password":true},{"type":"promptString","id":"avito_account_id","description":"ID рекламного аккаунта"}]}

MCP: List Servers 명령으로 서버를 확인하세요. VS Code MCP 문서

무엇을 맡길 수 있나요

• 기간별 캠페인, 그룹, 크리에이티브, 상태 및 통계를 보여줍니다.

• 그룹 및 크리에이티브별 지출, CTR, CPM, CPC 또는 VTR을 비교합니다.

• 에이전시 잔액 및 하위 계정을 확인합니다.

• 한 그룹의 예산 또는 입찰가 변경을 준비합니다.

• 전송할 세부 정보를 먼저 표시한 후 광고주 및 ORD 계약을 생성합니다.

• 확인 후 사용자를 추가하고, 역할을 변경하거나 액세스 권한을 철회합니다.

무엇이 변경될 수 있나요

이 API를 통해 캠페인, 그룹 및 크리에이티브를 생성, 편집, 일시 중지, 보관 또는 삭제할 수 없습니다. 크리에이티브 및 타겟팅도 쓰기 불가능합니다.

액세스 권한 얻기

1. 관리자 역할의 사용자로 Avito 광고 계정을 엽니다.

2. API 애플리케이션을 만들고 Client Key 및 Client Secret을 복사합니다.

3. 광고 계정 ID를 복사합니다.

4. 이를 AVITO_ADS_CLIENT_ID, AVITO_ADS_CLIENT_SECRET, AVITO_ADS_ACCOUNT_ID로 전달합니다.

서버는 OAuth2 client_credentials를 통해 Bearer token을 얻습니다. Client Secret을 비밀번호처럼 보관하세요. 계정 ID는 구성으로 설정됩니다: 도구가 실수로 다른 계정으로 전환할 수 없습니다.

쓰기 연습을 위해 AVITO_ADS_ENVIRONMENT=sandbox를 설정할 수 있습니다. 샌드박스는 production의 완전한 복사본이 아닙니다: 예를 들어 잔액을 사용할 수 없습니다.

설정

데이터, 제한 및 백그라운드 작업

• 주간 포인트 예산. 포인트는 월요일 00:00 UTC에 충전됩니다. 최대 100일의 긴 보고서 하나가 일반적으로 일련의 짧은 보고서보다 경제적입니다. 서버는 각 결과와 함께 apiPointBalance를 표시합니다.

• 일시적인 오류. 429의 경우 오류에 Retry-After 및 잔여 포인트가 반환됩니다. 네트워크 또는 5xx 오류 후에는 돈을 두 번 이체하지 않도록 쓰기가 반복되지 않습니다.

• 상시 모니터링 없음. 서버는 호출 시에만 작동합니다. AI 애플리케이션이 예약 작업을 지원하는 경우 주기적으로 통계와 포인트 잔액을 수집할 수 있습니다.

• 익명 텔레메트리. 비밀, 계정 데이터, 인수 및 프롬프트는 포함되지 않습니다. 비활성화: ASKADS_TELEMETRY=0.

기술 문서

• MCP 기능 카탈로그 — 각 도구에 대한 사용자 작업별 페이지.

• 모든 도구 및 매개변수

• 개발 문서

• 게시 문서

• 공식 Avito Ads SDK

지원

오류를 찾았거나 시나리오가 부족한가요? issue를 생성하거나 Telegram으로 문의하세요.