Meta 광고

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

사용 시기

• 키워드 검색으로 경쟁사가 제품 카테고리를 어떻게 광고하는지 조사할 때.
• 광고주나 Facebook 페이지로 특정 브랜드의 최신 크리에이티브를 따라갈 때.
• 실제 광고 문구와 비주얼로 크리에이티브 워크플로를 시작하고 변형할 때.
• 일정 트리거로 새 광고 요약을 정기적으로 받을 때.

빠른 시작

검색 기준

키워드와 Facebook 페이지 URL 필드에는 {}를 쓸 수 있습니다. 키워드/페이지 URL 입력에 연결된 노드의 텍스트가 {}를 대신하므로, 텍스트 노드나 목록 노드로 검색을 바꿀 수 있습니다.

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

설정

입력

출력

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

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 광고 노드에 공급자 키에서 설명하는 웹 스크래핑 키나 Nodaro Cloud 연결이 필요합니다.

팁

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

문제 해결

API에서 사용

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

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