# Meta 광고

> Meta의 공개 광고 라이브러리를 키워드, 광고주, Facebook 페이지로 검색하고, 각 광고의 문구, CTA, 이미지, 동영상을 JSON으로 AI 노드에 전달하세요.

Source: https://nodaro.ai/ko/docs/nodes/automate/meta-ads

**Meta 광고** 노드는 Meta의 공개 광고 라이브러리를 검색해 조건에 맞는 Facebook과 Instagram 광고를 JSON 목록으로 반환합니다. 각 광고에는 광고주의 페이지, 광고 문구, 헤드라인, CTA, 랜딩 링크, 이미지와 동영상 링크, 게재 기간, 현재 게재 중인지 여부가 들어 있습니다. 목록을 [텍스트 생성 - 모든 LLM](https://nodaro.ai/docs/nodes/automate/prompt) 노드에 연결하면 경쟁 분석을 할 수 있고, [필드 추출](https://nodaro.ai/docs/nodes/automate/extract-field)에 연결하면 광고마다 한 번씩 생성을 실행할 수 있습니다.

- Found in: Automate › Get Content
- API type: `meta-ads-scrape`

## 사용 시기
- 키워드 검색으로 경쟁사가 제품 카테고리를 어떻게 광고하는지 조사할 때.
- 광고주나 Facebook 페이지로 특정 브랜드의 최신 크리에이티브를 따라갈 때.
- 실제 광고 문구와 비주얼로 크리에이티브 워크플로를 시작하고 변형할 때.
- [일정 트리거](https://nodaro.ai/docs/nodes/automate/schedule-trigger)로 새 광고 요약을 정기적으로 받을 때.

## 빠른 시작
### 노드 추가
캔버스에서 Tab을 누르고 **자동화 › 콘텐츠 가져오기 › Meta 광고**를 선택하세요.

### 검색 대상 선택
설정 패널을 열고 **검색 기준**에서 **키워드**, **광고주**, **Facebook 페이지** 중 하나를 선택하세요. 키워드를 입력하거나, 광고주를 고르거나, 페이지 주소를 붙여 넣으세요.

### 필터 설정
**소스당 광고 수**, **기간**, **광고 상태**를 설정하세요. **실행** 버튼에 요청의 가격이 표시됩니다.

### 실행하고 광고 사용
**실행**을 클릭하세요. 노드 카드에는 광고가 하나씩 표시되고, **결과** 탭에는 모든 광고가 나열됩니다. **JSON** 출력을 [텍스트 생성 - 모든 LLM](https://nodaro.ai/docs/nodes/automate/prompt) 노드나 [필드 추출](https://nodaro.ai/docs/nodes/automate/extract-field)에 연결하세요.

Workflow: 매주 월요일 일정 트리거가 워크플로를 실행합니다. Meta 광고가 경쟁사 세 곳의 새 광고를 가져오고, 텍스트 생성 - 모든 LLM 노드가 요약하고, Telegram 게시물이 그 요약을 보냅니다.

- Meta 광고 → 텍스트 생성 - 모든 LLM (프롬프트)
- 텍스트 생성 - 모든 LLM → Telegram 게시물

## 검색 기준
| 방식 | 입력할 것 | 동작 |
| --- | --- | --- |
| **키워드** | **키워드**, 100자까지 | 광고 안의 단어를 검색합니다. 광고주 이름은 검색하지 않습니다. |
| **광고주** | **광고주** 5개까지 | 광고주 이름을 입력하고 **찾기**를 클릭한 뒤 검색 결과에서 맞는 Facebook 페이지를 고르세요. 대개 인증된 페이지가 맞는 페이지입니다. 실행은 고른 광고주의 광고만 가져옵니다. 이 검색에는 크레딧이 들지 않습니다. |
| **Facebook 페이지** | **Facebook 페이지 URL** 5개까지 | 페이지 주소를 한 줄에 하나씩 입력하세요. 예: `https://www.facebook.com/nike`. `https://`는 생략할 수 있습니다. 광고주의 광고 라이브러리 링크도 사용할 수 있습니다. |

**키워드**와 **Facebook 페이지 URL** 필드에는 `{}`를 쓸 수 있습니다. **키워드/페이지 URL** 입력에 연결된 노드의 텍스트가 `{}`를 대신하므로, [텍스트](https://nodaro.ai/docs/nodes/automate/text) 노드나 [목록](https://nodaro.ai/docs/nodes/automate/list) 노드로 검색을 바꿀 수 있습니다.

**광고주** 모드에서는 광고주를 고르는 대신 텍스트 노드나 목록 노드를 입력에 연결할 수도 있습니다. 그러면 노드가 실행될 때 각 줄이 Facebook 페이지와 연결됩니다. 인증된 검색 결과가 있으면 그것을, 없으면 첫 번째 결과를 씁니다. 찾은 페이지는 결과의 `resolvedAdvertisers`에 기록됩니다.

## 설정
| 설정 | 기본값 | 기능 |
| --- | --- | --- |
| **소스당 광고 수** | 20 | 키워드 또는 페이지마다 반환할 광고 수입니다. 1~100. |
| **기간** | **최근 30일** | **최근 24시간**, **최근 7일**, **최근 30일**, **전체 기간**. 광고의 시작일을 기준으로 합니다. |
| **광고 상태** | **활성** | **활성**, **비활성**, **전체**. |
| **국가** | **모든 국가** | 국가 하나를 고르면 그 국가에 게재된 광고만 남깁니다. |
| **플랫폼** | 필터 없음 | 선택한 플랫폼에 게재된 광고만 남깁니다: Facebook, Instagram, Audience Network, Messenger, WhatsApp, Threads. 아무것도 선택하지 않거나 여섯 개를 모두 선택하면 필터가 없습니다. |
| **크리에이티브 형식** | 필터 없음 | 크리에이티브가 **세로형 · 휴대폰**, **정사각형**, **가로형 · 웹**인 광고만 남깁니다. 형식은 크리에이티브의 실제 픽셀로 판단합니다. 요청한 것보다 광고가 적게 올 수 있습니다. |
| **AI 분석** | 꺼짐 | 반환된 광고를 하나씩 광고 분석 전문가처럼 읽습니다: 소재 유형, 형식, 시각적 훅, 타깃 고객, 그래픽 아이덴티티, 카피 훅, 셀링 포인트, CTA, 요약. **분석 모델**과 선택 항목인 **분석 관점(선택 사항)**을 정하세요. 예를 들어 판매하는 제품을 적을 수 있습니다. |
| **모든 동영상을 내 라이브러리에 복사** | 꺼짐 | 대표 광고의 동영상만이 아니라, 반환된 모든 광고의 동영상을 내 라이브러리에 복사합니다. |

## 입력
| 입력 | 필수 | 연결할 것 |
| --- | --- | --- |
| **키워드/페이지 URL** | 아니요 | 텍스트: **키워드** 모드에서는 키워드, **Facebook 페이지** 모드에서는 한 줄에 하나씩 페이지 주소, **광고주** 모드에서는 한 줄에 하나씩 광고주 이름. |

## 출력
| 출력 | 전달하는 것 |
| --- | --- |
| **JSON** | 광고 목록 전체입니다. [목록](https://nodaro.ai/docs/nodes/automate/list) 노드나 [필드 추출](https://nodaro.ai/docs/nodes/automate/extract-field)로 광고마다 한 번씩 노드를 실행할 수 있습니다. |
| **광고 문구** | 대표 광고의 헤드라인과 본문 문구. |
| **크리에이티브 이미지** | 대표 광고의 첫 이미지, 또는 그 동영상의 포스터. |
| **크리에이티브 동영상** | 대표 광고의 첫 동영상. |

대표 광고는 노드 카드에 표시된 광고입니다. 썸네일 줄, ‹ › 화살표, 또는 **결과** 탭의 행을 클릭해 고르세요. 워크플로 실행에서는 처음 반환된 광고가 대표 광고가 됩니다.

**JSON** 출력의 각 광고에는 다음 필드가 있습니다.

```json
{
"adArchiveId": "866569929827744",
"adLibraryUrl": "https://www.facebook.com/ads/library/?id=866569929827744",
"pageName": "Nike",
"pageId": "15087023444",
"startDate": "2026-09-01T07:00:00.000Z",
"endDate": null,
"isActive": true,
"platforms": ["FACEBOOK", "INSTAGRAM"],
"text": "Just do it.",
"title": "Air Max",
"caption": "nike.com",
"ctaText": "Shop now",
"linkUrl": "https://nike.com/airmax",
"images": ["https://…/creative.jpg"],
"videos": ["https://…/creative.mp4"],
"videoPreviews": ["https://…/poster.jpg"],
"collationCount": 3
}
```

각 광고에는 `format`과 `creatives` 목록도 있으며, 각 크리에이티브의 종류, 링크, 크기, 형식이 들어 있습니다. AI 분석이 켜져 있으면 분석된 각 광고에 분석 결과를 담은 `analysis` 객체가 붙습니다.

## 결과
노드 카드에는 광고 하나가 표시됩니다: 크리에이티브, 광고주, 헤드라인, 문구, 형식, 플랫폼, 게재 기간, CTA. 설정 패널의 **결과** 탭에는 모든 광고가 **목록**, **그리드**, **원본 JSON** 보기로 나열되며, 형식으로 거를 수도 있습니다. 각 행은 광고 라이브러리에 있는 그 광고의 페이지로 연결됩니다.

아무것도 반환하지 않거나 실패한 실행은 이전의 정상 결과를 노드에 그대로 둡니다. 입력을 바꾸면 그 결과는 다음 실행 전까지 오래된 결과로 표시됩니다.

## 내 라이브러리의 크리에이티브
Meta의 이미지와 동영상 링크는 며칠 안에 만료됩니다. 노드는 실행할 때마다 반환된 각 광고의 이미지와 동영상 포스터를 내 라이브러리에 복사합니다. 이 파일은 저장 용량에 포함되며, 광고에서 **라이브러리에 저장**을 클릭하기 전까지는 미디어 선택기에 나타나지 않습니다.

동영상은 크기가 크기 때문에, 대표 광고의 동영상은 **크리에이티브 동영상** 출력이 연결되어 있을 때만 복사됩니다. 반환된 모든 광고의 동영상을 복사하려면 **모든 동영상을 내 라이브러리에 복사**를 켜세요. 저장 용량이 가득 차면 광고에는 만료되는 원래 Meta 링크가 남지만, 실행은 성공합니다. 이 경우 링크를 보관하지 말고 같은 워크플로 안에서 크리에이티브를 사용하세요.

## 크레딧
가격은 요청하는 광고 수로 정해집니다: **소스당 광고 수**에 소스 수를 곱하고 다음 구간으로 올림한 값입니다. 키워드 검색은 소스 하나이고, 페이지나 고른 광고주는 각각 소스 하나입니다. 정확한 가격은 실행 전에 노드의 **실행** 버튼에 표시됩니다.

- **요청한 수량에 요금이 청구됩니다.** 기간이 짧거나 키워드에 맞는 광고가 적으면 요청한 것보다 광고가 적게 올 수 있습니다.
- **AI 분석은 광고마다 요금을 추가합니다.** 요금은 분석 모델의 등급(이코노미, 스탠더드, 프리미엄)으로 정해집니다. 요청한 수량 전체에 대해 크레딧이 예약되고, 실제로 분석된 광고만큼 정산됩니다. 모델이 분석에 실패한 광고나 긴 실행에서 시간이 모자라 분석하지 못한 광고는 환불됩니다.
- **입력에서 광고주를 받는 경우.** 텍스트 노드나 목록 노드가 광고주 이름을 넘기면, 소스 수는 노드가 실행될 때만 알 수 있습니다. 그전까지 노드의 예상 가격은 소스 하나로 계산합니다.
- **광고주 검색은 무료입니다.**

셀프 호스팅 설치에서는 Meta 광고 노드에 [공급자 키](https://nodaro.ai/docs/self-hosting/provider-keys)에서 설명하는 웹 스크래핑 키나 [Nodaro Cloud 연결](https://nodaro.ai/docs/self-hosting/cloud-connect)이 필요합니다.

## 팁
- **종료된 크리에이티브 연구.** **광고 상태**를 **비활성**으로 하고 기간을 길게 잡으면, 광고주가 이미 중단한 광고를 볼 수 있습니다.
- **광고마다 펼치기.** 목록 노드 앞에서 필드 추출로 `images`나 `text`를 꺼내면 광고마다 한 번씩 생성을 실행할 수 있습니다.
- **동영상 포스터 활용.** 브랜드 동영상 광고의 `videoPreviews`는 새 콘셉트의 레퍼런스 프레임으로 쓰기 좋습니다.

## 문제 해결
| 문제 | 원인과 해결 |
| --- | --- |
| 키워드로 엉뚱한 브랜드의 광고가 옵니다. | **키워드**는 광고 안의 단어를 검색하고 광고주는 검색하지 않습니다. 한 브랜드를 따라가려면 **광고주**나 **Facebook 페이지**를 쓰세요. |
| **찾기**에서 광고주가 나오지 않습니다. | 브랜드 Facebook 페이지의 정확한 이름으로 다시 시도하세요. |
| 요청한 것보다 광고가 적게 왔습니다. | 기간, 상태, 또는 **크리에이티브 형식** 필터 때문에 조건에 맞는 광고가 줄었습니다. 기간을 넓히거나 필터를 없애세요. |
| 크리에이티브 링크가 더 이상 작동하지 않습니다. | 저장 용량이 가득 차는 등의 이유로 크리에이티브를 내 라이브러리에 복사하지 못해, 만료되는 Meta 링크가 남아 있었습니다. 노드를 다시 실행하세요. |

## API에서 사용
`POST /v1/meta-ads-scrape`는 코드에서 노드를 실행합니다. API에는 키워드 검색과 페이지, 두 가지 모드가 있습니다. 고른 광고주는 그 Facebook 페이지 주소로 보내세요. 모든 동영상을 복사하고 모든 광고를 분석하는 실행은 HTTP 요청 하나의 제한 시간인 약 100초보다 오래 걸리는 경우가 많으므로, `"respondAsync": true`를 보내세요. 그러면 호출이 바로 `jobId`로 응답하고, 완료된 작업의 광고는 `GET /v1/jobs/:id`로 읽습니다.

이 플래그가 없으면 요청은 실행이 끝날 때까지 열려 있습니다. 요청 제한 시간을 넘긴 실행은 작업이 완료되고 청구되더라도 응답 도중에 끊깁니다. [단일 노드 실행](https://nodaro.ai/docs/developers/api/nodes)과 [작업](https://nodaro.ai/docs/developers/api/jobs)을 참고하세요.

## 자주 묻는 질문

### Meta 광고 노드는 무엇을 반환하나요?

Meta의 공개 광고 라이브러리에서 가져온 광고의 JSON 목록을 반환합니다. 각 광고에는 광고주의 페이지, 광고 문구, 헤드라인, CTA(행동 유도 버튼), 랜딩 링크, 이미지와 동영상 링크, 게재 기간, 현재 게재 중인지 여부가 들어 있습니다.

### 특정 브랜드의 광고만 볼 수 있나요?

네. 검색 기준을 광고주로 설정하고 브랜드 이름을 입력한 뒤 찾기를 클릭해 그 Facebook 페이지를 고르세요. 광고주는 5개까지 고를 수 있습니다. 또는 검색 기준을 Facebook 페이지로 설정하고 페이지 주소를 한 줄에 하나씩 5개까지 붙여 넣으세요.

### Meta 광고 노드의 가격은 얼마인가요?

가격은 요청하는 광고 수, 즉 소스당 광고 수에 소스 수를 곱한 값으로 정해지며, 구간 단위로 올림됩니다. AI 분석을 켜면 분석 모델의 등급에 따라 광고마다 요금이 추가됩니다. 정확한 가격은 실행 버튼에 표시됩니다.

### 요청한 것보다 광고가 적게 오는 이유는 무엇인가요?

기간이 짧거나, 키워드에 맞는 광고가 적거나, 크리에이티브 형식으로 거르면 요청한 것보다 광고가 적게 찾아질 수 있습니다. 실행 요금은 요청한 수량에 대해 청구됩니다.

### 이미지와 동영상 링크는 만료되나요?

Meta의 링크는 며칠 안에 만료됩니다. 노드는 실행할 때마다 각 광고의 이미지와 동영상 포스터를 내 라이브러리에 복사하므로, 결과의 링크는 계속 작동합니다. 동영상은 동영상 출력이 연결되어 있으면 대표 광고의 것이, 설정을 켜면 모든 광고의 것이 복사됩니다.