카카오톡 scrap(url 미리보기), 카카오 링크 스크랩, 카카오 스토리 스크랩에서 미리보기 사용에 어려움을 겪으시는 분들이 많아서 체크리스트를 준비했습니다.
사전 필수 확인 사항
- og 태그가 있어야 미리보기가 됩니다.
- 스크랩할 페이지는 200 정상 응답 페이지여야 하고, 리다이렉트 되는 경우에도 최초 도착 페이지를 스크랩합니다.
- 정확한 상태를 확인하기 위해 curl 명령이나 postman 같은 API 호출 도구를 사용하면 정확히 판단 가능합니다.
- 보안상의 이유로 80,443 포트만 스크랩을 허용하고 있습니다.
curl -v -X GET "https://developers.kakao.com/"
- 스크랩할 주소와 og:url 설정이 다른 경우, og:url 주소의 메타 정보를 조회합니다.
- 이러한 처리는 ogp 표준 처리방식입니다. https://ogp.me/
- ✭ og:url 주소에 og 태그가 설정되어 있지 않으면 스크랩되지 않습니다.
아무것도 스크랩 안될 때, 체크 리스트
✓ Content-Type 이 없거나 text/html 이 아닐때
✓ 스크랩할 페이지에 웹브라우저로 접근하여 페이지 리다이렉트가 되는지 확인합니다.
- 리다이렉트 된다면, 최초 접근한 페이지에서 다음을 확인합니다.
✓ 페이지 소스보기로 og 태그가 있는지 확인합니다.
- og 태그가 없다면 추가해주세요.
✓ og:url 태그가 있다면 스크랩할 주소와 동일한지 확인합니다.
- 주소를 동일하게 변경하거나 og:url 태그를 제거해주세요.
✓ 스크랩 가능한 이미지는 JPG/JPEG/PNG 입니다.
그래도 아무것도 스크랩 안될 때, 체크 리스트
✓ og 태그를 front스크립트로 로딩하거나 응답결과가 변경될 수 있으므로 curl 로 주소를 호출하여 og 태그를 다시 확인합니다.
✓ 방화벽에서 카카오 스크랩 봇을 차단하는지 확인합니다.
* 스크랩봇은 facebookexternalhit/1.1;kakaotalk-scrap/1.0 user-agent 를 사용합니다.
* 카카오스토리 스크랩봇은 facebookexternalhit/1.1;kakaostory-og-reader/1.0 user-agent 를 사용합니다.
* 카카오 스크랩 서버 IP를 차단하고 있는지 확인합니다.
원하는 스크랩 결과가 아닐 때, 체크 리스트
✓ 캐시를 초기화 하고, 다시 시도해봅니다.
✓ og:url 태그가 다른 주소로 설정되었는지 확인합니다.
✓ og 태그가 중복되어 사용되었는지 확인합니다.
✓ og:image 태그가 접근 되는지 브라우저로 확인합니다.
* 방화벽에서 IP를 차단하는지 user-agent를 차단하는지 확인합니다.
✓ Netlify와 같은 정적사이트 배포환경에서 프리랜더 옵션이 있는 경우 스크랩이 안될 수 있습니다.
원하는 스크랩 이미지가 아닐때, 체크 리스트
✓ 이미지는 800X400 사이즈에 최적화 되었습니다. 가로:세로 = 2:1
- 스크랩 시, 스마트 크롭이라는 내부 API가 800X400사이즈로 변환합니다.
- 인물이 포함된 경우, 스마트 크롭이 크롭 위치를 따로 선정하는 경우도 있습니다. (해당 기능을 조절하는 별도 옵션은 없습니다.)