Facebook 디버거 링크 생성기

URL을 붙여넣기만 하면 해당 대상이 미리 로드된 상태로 Facebook 공유 디버거를 여는 클릭 가능한 링크가 생성됩니다. og:image, og:title 또는 정규 URL 태그를 막 업데이트한 뒤, 새 공유에서 올바른 미리보기가 표시되도록 Facebook에 페이지를 다시 스크래핑하게 만들 때 유용합니다. 이 디버거는 Facebook 크롤러가 생성한 정확한 경고도 함께 보여 주므로, 깨진 썸네일의 원인을 가장 빠르게 진단할 수 있습니다.

디버거 링크 사용 방법

  1. 1

    URL을 붙여넣으세요

    Facebook이 다시 스크래핑할 페이지를 입력하세요. 중간 리디렉션이 아닌 정규 URL을 사용하십시오.

  2. 2

    링크를 생성하세요

    이 도구는 URL을 Facebook의 `developers.facebook.com/tools/debug/?q=` 형식으로 감쌉니다.

  3. 3

    디버거를 여세요

    Facebook의 디버거 페이지가 열립니다. “Scrape Again(다시 스크래핑)”을 클릭하면 최신 데이터를 강제로 가져옵니다.

  4. 4

    경고를 확인하세요

    Facebook은 크롤러가 발견한 누락 태그, 이미지 크기, 정규 URL 불일치, 모든 HTTP 오류를 표시합니다.

Facebook 크롤러가 실제로 확인하는 항목

크롤러는 사용자의 페이지를 facebookexternalhit/1.1로 가져와 <head>에 있는 Open Graph 태그를 읽습니다. 깔끔한 공유 미리보기를 위해 필요한 최소한의 태그 구성은 다음과 같습니다.

필수 및 권장 태그

태그 필수 참고
og:title 모바일에서는 40~60자가 가장 잘 읽힙니다.
og:type 일반적으로 website 또는 article입니다.
og:url 정규 URL과 일치해야 합니다.
og:image 1200×630 권장, 최소 600×315.
og:description 아니요 80~200자.
og:image:width 아니요 첫 렌더링 미리보기에 도움이 됩니다.
og:image:height 아니요 동일.
og:locale 아니요 en_US, es_ES 등.

자주 나오는 경고와 해결 방법

  • og:image 속성을 명시적으로 지정해야 합니다”, 태그를 빠뜨렸거나 상대 URL을 가리키고 있습니다. 프로토콜을 포함한 절대 URL을 사용하세요.
  • “제공된 og:image URL이 유효하지 않습니다”, 이미지가 404이거나, 인증 뒤에 있거나, robots.txt로 차단되어 있습니다. 시크릿 모드에서 curl로 확인하세요.
  • “추론된 속성”, Facebook이 페이지 본문 스크래핑으로 대체했습니다. 속성을 명시적으로 선언할 때까지 미리보기는 불안정합니다.
  • “이미지가 너무 작습니다”, 리치 미리보기의 최소 크기는 200×200px입니다. 1200×630 미만이면 미리보기가 가로형 대신 정사각형으로 표시될 수 있습니다.

캐시 동작

Facebook은 한 번 스크래핑하면 Open Graph 데이터를 최대 30일간 캐시합니다. 태그를 수정한 뒤에도 새 공유는 캐시된 미리보기를 사용합니다. 기다리지 않고 캐시를 무효화하는 유일한 공식 지원 방법은 디버거의 “Scrape Again(다시 스크래핑)”입니다.

자주 묻는 질문

예. 공유 디버거는 로그인된 Facebook 계정이 필요합니다. 디버거 URL을 팀원과 공유하면, 그 사람은 “Scrape Again” 버튼을 사용하기 전에 로그인하라는 안내를 받습니다.

앱에 해당 페이지가 이미 캐시되어 있는 사용자는 한동안 예전 미리보기를 계속 보게 됩니다. 가장 확실한 테스트 방법은 해당 URL을 다른 계정의 새 게시물에 붙여넣는 것으로, 이렇게 하면 그 공유에 대해 새로운 스크래핑이 이루어집니다.

X는 자체 twitter:card 태그를 사용하며 Open Graph 태그를 대체 수단으로 활용합니다. Facebook 디버거는 X 전용 태그를 검증하지 않으므로, 그 용도에는 Twitter Card Validator를 사용하세요.

링크는 이 도구 내에서 로컬로 생성되며, 입력한 URL의 기록은 당사 측에 저장되지 않습니다. Facebook은 예상대로 모든 디버거 요청을 자사 측에 기록합니다.

관련 도구

이 도구는 다른 언어로도 제공됩니다