본문 바로가기

WebSite SearchAction JSON-LD 생성기

브라우저 처리

사이트 이름·첫 화면 주소와 검색 결과 주소 형식으로 WebSite·SearchAction 구조화 데이터를 만들고 {search_term_string} 포함 여부를 검사합니다. Google이 2024년 11월 사이트링크 검색창 표시를 중단했다는 점도 알려 줍니다.

도구 실행입력 후 결과 확인
WebSite SearchAction JSON-LD 생성기 샘플 실행

WebSite 구조화 데이터는 사이트의 공식 이름과 첫 화면 주소를 검색엔진에 알립니다. 검색결과에 'shop.example.com' 대신 '예시상점' 같은 사이트 이름이 표시되도록 돕는 신호 중 하나입니다.

브라우저 처리
샘플 결과
"@type": "WebSite",
"name": "예시상점",
"url": "https://shop.example.com/",
"potentialAction": {
  "@type": "SearchAction",
  "target": { "@type": "EntryPoint", "urlTemplate": "https://shop.example.com/search?q={search_term_string}" },
  "query-input": "required name=search_term_string"
}
자바스크립트가 활성화되면 이 영역이 실제 입력, 실행, 결과 패널로 바뀝니다.

WebSite SearchAction JSON-LD 생성기 사용 가이드

WebSite 구조화 데이터는 사이트의 공식 이름과 첫 화면 주소를 검색엔진에 알립니다. 검색결과에 'shop.example.com' 대신 '예시상점' 같은 사이트 이름이 표시되도록 돕는 신호 중 하나입니다.

이 생성기는 사이트 이름과 주소에 더해 검색=에 사이트 내부 검색 결과 주소 형식을 넣으면 SearchAction까지 만듭니다. 주소 형식에는 검색어 자리를 뜻하는 {search_term_string}이 반드시 들어가야 하며, 없으면 예시와 함께 알려 줍니다.

Google은 2024년 11월부터 검색결과의 사이트링크 검색창을 더 이상 보여 주지 않습니다. 그래서 SearchAction은 표시 효과가 줄었지만, WebSite의 name은 사이트 이름 표시에 계속 쓰인다는 안내를 주석에 담습니다.

사용 방법

  1. '사이트 이름'에 검색결과에 보이길 원하는 공식 이름을 적습니다.
  2. '사이트 첫 화면 주소'에 첫 화면의 전체 주소를 넣습니다.
  3. '검색=검색 결과 주소 ({search_term_string} 포함)' 칸에 검색 주소 형식을 적고 '실행'을 누릅니다.
  4. 결과를 사이트 첫 화면에만 붙여 넣습니다.

예시: 쇼핑몰 첫 화면

입력
사이트 이름: 예시상점
주소: https://shop.example.com/
검색=https://shop.example.com/search?q={search_term_string}
결과
"@type": "WebSite",
"name": "예시상점",
"url": "https://shop.example.com/",
"potentialAction": {
  "@type": "SearchAction",
  "target": { "@type": "EntryPoint", "urlTemplate": "https://shop.example.com/search?q={search_term_string}" },
  "query-input": "required name=search_term_string"
}

검색 주소 형식은 사이트에서 실제로 검색했을 때 주소창에 보이는 주소를 보고 검색어 자리를 바꿔 만듭니다.

이럴 때 쓰면 좋아요

  • 검색결과에 도메인 대신 사이트 이름이 보이길 원할 때
  • 사이트 공식 이름을 바꾼 뒤 구조화 데이터를 갱신할 때
  • 내부 검색 주소 형식을 문서로 남겨 둘 때
  • 첫 화면에 넣을 기본 구조화 데이터를 정리할 때

문제가 생겼을 때

검색 주소에 실제 검색어 '원피스'를 그대로 넣었습니다.

검색어 자리는 {search_term_string}으로 바꿔야 합니다. 예: https://shop.example.com/search?q={search_term_string}

모든 페이지에 WebSite 데이터를 넣었습니다.

WebSite 구조화 데이터는 첫 화면 한 곳에만 넣으면 됩니다.

사이트 이름을 페이지마다 다르게 썼습니다.

title 태그, og:site_name, WebSite의 name에 같은 이름을 쓰면 검색엔진이 사이트 이름을 정하기 쉽습니다.

활용 팁

  • 사이트 이름을 영어와 한국어로 함께 알리고 싶으면 결과에 "alternateName": "Example Shop"을 추가하세요.
  • name은 짧고 일관된 공식 이름이 좋습니다. 홍보 문구를 붙이지 마세요.
  • 회사 정보와 로고는 Organization JSON-LD로 따로 알립니다.

자주 묻는 질문

사이트링크 검색창이 없어졌는데 SearchAction이 필요한가요?

Google 검색결과에는 더 이상 표시되지 않지만 넣어도 문제는 없습니다. 다른 검색엔진이나 서비스가 참고할 수 있고, WebSite의 이름 정보는 계속 쓰입니다.

{search_term_string}은 무엇인가요?

사용자가 입력한 검색어가 들어갈 자리를 표시하는 약속된 이름입니다. query-input의 name과 같아야 합니다.

검색 기능이 없는 사이트도 넣을 수 있나요?

검색=을 비워 두면 검색 주소 오류가 납니다. 검색 기능이 없다면 이 도구 대신 Organization JSON-LD로 사이트 정보를 알리세요.