Google Ads Library MCP Server

이것은 Google Ads Transparency Center용 Model Context Protocol(MCP) 서버입니다.

이것을 사용하면 Google의 공개 광고 투명성 센터에서 어떤 기업이나 브랜드를 검색하고, 현재 게재 중인 광고를 확인하며, 그들의 광고를 분석할 수 있습니다. 광고 이미지/텍스트를 분석하고, 비디오 광고를 종합적인 인사이트로 분석하고, 기업들의 전략을 비교하며, 캠페인에서 효과가 있는 요소에 대한 인사이트를 얻을 수 있습니다.

Claude에 연결했을 때 할 수 있는 작업의 예시입니다.

https://github.com/user-attachments/assets/a47aa689-e89d-4d4b-9df7-6eb3a81937ee

호스팅 버전 (권장)

Google Ads Library MCP를 사용하는 가장 쉬운 방법은 Proxy (useproxy.dev)의 호스팅 버전입니다. API 키, Gemini 키, Python, 실행할 서버가 필요 없습니다. 연결만 하면 바로 조회를 시작할 수 있습니다.

• ⚡ 설정 불가 — 설치하거나, 구성하거나, 유지 관리할 것이 없습니다.

• 🔑 API 키 불필요 — ScrapeCreators 및 Gemini 키를 완전히 건너뜁니다.

• 🔌 어디서나 작동가능 — ChatGPT, Claude, Cursor, Manus, 그리고 MCP를 지원하는 모든 환경에서 작동합니다.

• 🚀 항상 최신상태 — 새 도구와 기능 수정이 자동으로 반영됩니다.

👉 useproxy.dev에서 무료로 시작하기 →

직접 실행하는 것을 선호하시나요? 전체 자체 호스팅(setup)을 안내는 아래에 설명되어 있습니다.

호스팅 vs 자체 호스팅

대부분의 사용자에게 호스팅 버전이 가장 빠른 경로입니다. 서버를 직접 수정하거나 확장하려는 경우에만 자체 호스팅을 선택하세요.

Related MCP server: google-ads-transparency-mcp

예시 프롬프트

How many ads is 'AnthropicAI' running? What's their split across video and image?

What messaging is 'AnthropicAI' running right now in their ads?

Analyze the video ads from 'Nike' and extract their visual storytelling strategy, pacing, and brand messaging techniques.

Do a deep comparison to the messaging between 'AnthropicAI', 'Perplexity AI' and 'OpenAI'. Give it a nice forwardable summary.

설치

사전 요구 사항

• Python 3.12+

• Anthropic Claude Desktop 앱 (또는 Cursor)

• Pip (Python 패키지 관리자), python -m pip install을 이용해 설치

• 광고 데이터 제공자용 API 키, SCRAPECREATORS_API_KEY로 설정 (아래 설정 참조)

• Google Gemini API 키 (선택 사항, 동영상 광고 분석에만 필요)

API 키를 다루고 싶지 않으신다면? 위의 호스팅 버전을 통해 설정을 완전히 건너뛰세요.

빠른 설치 (권장)

1. 저장소를 클론하고 설치 스크립트 실행하기

   git clone https://github.com/proxy-intell/google-ads-library-mcp.git
   cd google-ads-library-mcp
   
   # For macOS/Linux:
   ./install.sh
   
   # For Windows:
   install.bat

2. API 키를 구성하세요

   생성된 .env 파일을 편집하고 API 키를 추가하세요:

   • 광고 데이터 API 키를 SCRAPECREATORS_API_KEY로 설정하세요.

   • Gemini API 키는 Google AI Studio에서 받으세요 (선택 사항, 영상 분석에만 필요).

3. 표시된 MCP 설정을 따르세요

   설치 스크립트가 Claude Desktop 또는 Cursor에 추가해야 하는 정확한 설정을 보여줍니다.

수동 설치

직접 수동으로 설치를 원한다면:

1. 저장소를 클론하세요

   git clone https://github.com/proxy-intell/google-ads-library-mcp.git
   cd google-ads-library-mcp

2. 의존성 설치하기

   pip install -r requirements.txt

3. API 키를 구성하세요

   템플릿을 복사하고 API 키를 구성하세요:

   cp .env.template .env
   # Then edit .env with your actual API keys

   API 키를 얻는 방법:

   • .env 파일에서 광고 데이터 API 키를 SCRAPECREATORS_API_KEY로 설정하세요.

   • Google Gemini API 키는 여기에서 받으세요 (선택 사항, 영상 분석용).

4. MCP 서버에 연결하기

   Claude Desktop 또는 Cursor 설정에 MCP 서버 구성을 추가하세요:

   {
     "mcpServers": {
       "google_ad_library": {
       "command": "/usr/local/opt/python@3.13/bin/python3",
         "args": [
           "{{PATH_TO_PROJECT}}/google-ads-library-mcp/mcp_server.py"
         ]
       }
     }
   }

   {{PATH_TO_PROJECT}}를 이 저장소를 클론한 전체 경로로 바꾸세요.

   참고: API 키는 .env 파일에서 자동으로 로드됩니다. 명령줄 인자가 여전히 지원되며, 제공된 경우 환경 변수보다 우선합니다.

   Claude Desktop의 경우:

   아래 파일을 Claude Desktop 구성 디렉터리의 claude_desktop_config.json으로 저장하세요:

   ~/Library/Application Support/Claude/claude_desktop_config.json

   Cursor의 경우:

   아래 파일을 Cursor 구성 디렉터리의 mcp.json으로 저장하세요:

   ~/.cursor/mcp.json

5. Claude Desktop / Cursor를 재시작하세요

   Claude Desktop을 열면 이제 Google Ads Library를 사용 가능한 통합 기능으로 볼 수 있습니다.

   또는 Cursor를 재시작하세요.

기술적 세부 사항

1. Claude가 Python MCP 서버에 요청을 보냅니다.

2. MCP 서버는 Google Ads Transparency Center 데이터에 대해 광고 데이터 API를 조회합니다.

3. 데이터는 체인을 통해 Claude로 다시 전달됩니다.

Google Ads

이 서버는 Google Ads Transparency Center에 연결됩니다:

• Google Ads: 회사 도메인(예: "nike.com") 또는 광고주 ID를 사용하여 검색합니다.

• 응답 형식: 텍스트/이미지/비디오 형식과 개별 변형을 포함한 광고를 반환합니다.

• 광고 세부정보: 각 광고는 다른 제목및 설명을 가지는 여러 변형을 가질 수 있습니다.

• 지역 데이터: 지역별 통계와 노출 데이터를 포함합니다.

Tips:

• 검색 시 브랜드 이름보다 기업 도메인(예: "nike.com")을 사용하세요.

• 이제 이미지 및 비디오 광고 외에 텍스트 광고도 지원됩니다.

• 각 광고에는 제목과 설명이 다른 여러 변형이 포함될 수 있습니다.

사용 가능한 MCP 도구

이 MCP 서버는 Google Ads Transparency Center 요소와 상호작용할 수 있는 도구를 제공합니다:

문제 해결

일반적인 이슈

API 키 누락 오류:

• .env 파일이 프로젝트 루트 디렉터리에 있는지 확인하세요.

• .env 파일이 없는 경우 템플릿에서 복사하세요: cp .env.template .env

• API 키가 따옴표 없이 올바르게 서식이 되어 있는지 확인하세요.

• .env 파일에 SCRAPECREATORS_API_KEY=your_api_key_here 가 포인지 확인하세요.

• 비디오 분석에는 GEMINI_API_KEY=your_api_key_here도 추가되었는지 확인하세요.

비디오 분석이 작동하지 않음:

• .env 파일에 유효한 Google Gemini API 키가 있는지 확인하세요.

• 영상 분석에는 GEMINI_API_KEY 환경 변수가 필요합니다.

MCP 서버 연결 문제:

• MCP 구성의 경로가 올바른 위치를 가리키는지 확인 장소.

• pip install -r requirements.txt 명령으로 모든 의존성이 설치되었는지 확인하세요.

• 설정 변경 후 Claude Desktop/Cursor를 재시작하세요.

더 많은 Claude Desktop 연동 통합 문제해결은 MCP 문서를 참조하세요. 문서에는 로그 확인과 자주 발생하는 문제 해결 팁이 포함되어 있습니다.

Google Ads 특정 참고사항:

• 검색할 때 브랜드 이름 대신 기업 도메인(예: "nike.com")을 사용하세요.

• 이미지 및 비디오 광고 외에도 텍스트 광고가 지원됩니다.

• 각 광고는 다른 헤드라인과 설명을 가진 여러 변형이 있을 수 있습니다.

FAQ

Google Ads Library MCP를 사용하는 가장 쉬운 방법은 무엇인가요? 가장 쉬운 방법은 Proxy(useproxy.dev)의 호스팅 버전입니다. API 키도, 구성도, 서버도 필요하지 않습니다. ChatGPT, Claude, Cursor, Manus 등에서 MCP와 호환되는 어떤 클라이언트에서든 연결만 하면 즉시 조회가 가능합니다.

이 MCP를 사용하려면 API 키가 필요한가요? 자체 호스팅할 때만 필요합니다. useproxy.dev의 호스팅 버전이 모든 인증과정을 처리하므로 ScrapeCreators와 Gemini 키가 불필요합니다. 자체 호스팅하려면 SCRAPECREATORS_API_KEY가 필요하며 (영상 분석 시 Gemini 키도 필요).

어떤 MCP 클라이언트와 호환 되나요? 호스팅 버전과 자체 호스팅 버전 모두 ChatGPT, Claude (데스크톱앱 및 웹), Cursor, Manus, 그리고 Model Context Protocol을 지원하는 모든 클라이언트와 호환됩니다.

무료 버전이 있나요? 네 — Proxy의 호스팅 버전에 무료 티어가 있어 설정 없이도 바로 광고 분석을 시작 가능합니다.

자체 호스팅과 호스팅 버전 중 무엇을 선택해야 하나요? 빠르고 안정적인 Google Ads Transparency Center 데이터 접근을 원한다면 호스팅 버전을 사용하세요. 대부분의 사용자에게 권장합니다. 코드를 직접 수정하거나 확장하려는 경우에만 자체 호스팅을 선택하세요.

피드백

여러분의 의견은 크게 감사히 받겠습니다. 다음우선으로 보고 싶은 기능을 알려주시거나 완전한 새로운 기능을 요청해 주세요.

라이선스

이 프로젝트는 MIT 라이선스 하에 라이선스가 부여됩니다.

Proxy 팀이 기술을 담아 만들었습니다. — 적긴 하여
**인가했기에 좋아요?