신디케이션 API

신디케이션 API(Syndication API)는 콘텐츠를 보유하고 있는 웹사이트와 네이버와 같은 검색 서비스 사이에 동기화 규약을 정의하는 API로 웹 개방성을 위한 핵심 기술의 하나이다. 네이버 신디케이션, 네이버 신디케이션 API, 신디케이션 등 다양한 이름으로 불린다.

개요

2010년 3월 엔에이치엔 사용자 인터페이스(NHN UI) 기술 고영수 랩장이 개발한 기술이다. 엑스프레스엔진(XpressEngine, XE)을 사용할 사이트가 자동으로 선택하도록 되어 있는 오픈 API로 현재는 네이버 개발자 센터에서 신디케이션 API를 다운로드받아 사용할 수 있다. 웹 사이트 또는 모바일 앱이 보유하고 있는 콘텐츠를 다른 웹 사이트가 이용할 수 있게 하는 방식의 하나로 콘텐츠를 보유하고 있는 웹 사이트와 앱은 정해진 형식에 따라 문서를 구성하여 해당 문서의 링크를 다른 웹사이트에 전송하고, 이를 전송 받은 웹 사이트는 해당 문서의 내용을 분석하여 사용한다.

특징

검색 콘텐츠 수집에 사용하는 기존 방식의 단점을 해결하여 웹 사이트의 부담을 줄이고 검색 서비스의 품질을 높일 수 있다. 기존에는 웹 사이트에 콘텐츠가 올라가면 각 검색엔진의 크롤링 로봇이 무작위 접근 방식을 통해 홈페이지의 콘텐츠를 읽어 웹문서로 노출시키는 형태였다. 그런데 검색 로봇을 이용하여 웹 사이트의 콘텐츠를 수집하는 네이버와 같은 검색 서비스에 무작위 크롤링 기법을 사용하면 웹 사이트에 부하를 줄 수 있고, 문서 내용을 정확하게 분석하기 어렵다. 이때 신디케이션 API를 사용하면 부하를 최소화하고, 원하는 부분만 검색 서비스에 노출시킬 수 있다.

장점

검색 서비스의 무작위 크롤링으로 인한 웹 사이트의 서버 부하가 줄어든다. 신규 콘텐츠 생성, 기존 콘텐츠 수정, 삭제 등의 결과가 즉시 검색 서비스에 반영되어 검색 엔진 로봇이 해당 웹사이트에 방문할 때가지 기다리지 않고 신속하게 콘텐츠 변경 현황을 검색 엔진 로봇이 해당 웹사이트에 방문할 때까지 기다리지 않고 신속하게 콘텐츠 변경 현황을 검색 포털사이트에 반영할 수 있다. 제목, 내용, 태그 등 콘텐츠의 구조가 검색 결과에 정확히 반영된다. 핑(Ping)을 보낸 콘텐츠만 수집하므로 콘텐츠 제공자가 원하는 부분만 검색에 노출시킬 수 있다. 독립 사이트 콘텐츠의 업데이트가 실시간으로 이루어지고 정형화된 웹 문서가 수집되어 검색 정확도가 높아진다. 외부 사이트로의 트래픽 유입량이 증가해 온라인 생태계 전반의 발전에도 도움이 될 것으로 보인다.

단점

의도치 않더라도 과도한 인용이나 홍보성 글로 오인되거나 불확실성이 짙은 정책 위반이 있을 때는 일반 웹사이트 블로그 문서보다 철저한 감시의 대상이 되고 노출 제한으로 이어질 수 있다. 블로그나 사이트로부터의 불법 업로드나 인용이 제한되지 않는다. 또한, 네이버에서 개발된 기술인만큼 웹 사이트의 내용이 네이버에 문제를 일으킬 수 있다고 판단되는 경우 노출이 제한된다. 핑 방식을 사용하기 때문에 검색 서비스가 해킹당할 수도 있다. 해커에게 API KEY를 탈취당할 경우 어뷰징으로 스탠바이(Stanby) 혹은 심하면 블락(Block)을 당할 수 있다,

관련 용어

• 엔트리(entry): 웹 사이트의 한 페이지
• 피드(feed): 여러 개의 엔트리를 담고 있는 채널(예: 게시판, 카테고리) 정보
• 신디케이션 문서: 네이버에서 웹 사이트의 콘텐츠를 전달할수 있도록 하는 엑스엠엘(XML) 문서
• 핑 URL: 네이버 신디케이션 문서의 위치를 지정한 URL

프로토콜

1. 요청 웹사이트는 검색 서비스 사이트로 핑을 보낸다. 이때 핑 요청 속에는 “신디케이션 문서 URL”을 함께 전달한다.
2. 검색 서비스는 핑 요청 시 전달된 신디케이션 문서 URL로 접속한다.
3. 신디케이션 문서를 읽어본다.

사용

조건

신디케이션 API를 연동시킬 웹 사이트는 네이버 검색에서 판단하는 유해 또는 스팸/ 어뷰징 문서를 생산하지 않고, 사이트 생성 이후 6개월 이상 정상적으로 운영되고 있어야 한다. 기계적인 자동생성이 아닌 자체 콘텐츠 또는 이용자 콘텐츠로 운영되고 있어야 하고, 네이버에서 인식한 웹 문서 기준 3만 건 이상, 정상적인 자체 제작 콘텐츠 또는 이용자 콘텐츠 페이지가 일일 5천 개 수준 이상 생성 또는 수정되는 일정 수준 이상의 콘텐츠량을 가지고 있어야 한다.

시나리오

웹 사이트가 네이버 신디케이션을 사용하는 시나리오는 다음과 같다.

• 각 변경 사항에 대해 네이버 신디케이션 문서를 실시간으로 생성하는 경우, 콘텐츠가 생성되거나 수정, 삭제될 때마다 실시간으로 네이버 신디케이션 문서를 작성하고 문서의 위치를 네이버 신디케이션 서버에 핑 URL로 전송한다.
• 일정 시간 동안의 변경 사항에 대해 네이버 신디케이션 문서를 주기적으로 생성하는 경우, 일정 시간 동안 생성되거나 수정, 삭제된 콘텐츠를 내부 저장소(DB)에 저장하고, 이를 모두 포함하는 네이버 신디케이션 문서를 주기적으로 생성하여 문서의 위치를 네이버 신디케이션 서버에 핑 URL로 전송한다.
• 네이버 신디케이션 문서를 생성하는 내부 API를 호출하는 주소를 주기적으로 전송하는 경우, 생성되거나 수정, 삭제된 콘텐츠를 내부 저장소(DB)에 저장하고, 이를 입력받아 네이버 신디케이션 문서로 반환하는 내부 API를 작성한다. 이 API를 호출하는 주소를 주기적으로 네이버 신디케이션 서버에 핑 URL로 전송한다.

불가능한 경우

검색 노출을 위한 의도적인 행위, 홍보성, 어뷰징, 스팸 관련 문서의 노출에 악용되는 경우에 한하여 승인 보류 또는 승인 후 지속적인 모니터링을 통해 발견 시 차단되어 신디케이션 연동이 불가능하다. 타 사이트의 문서, 기사 등을 퍼와서 게시, 의도적인 검색노출을 위해 이슈/홍보성 글을 반복하여 게시하는 경우 또는 다수의 불특정 업체를 홍보, 광고하는 행위일 경우 역시 마찬가지이다. 불법성(도박/ 성인 음란성) 홍보를 위한 스팸 문서를 의도적으로 유포하거나 방치하는 경우, 또는 삭제 정보를 즉시 전달하지 않은 경우 또한 차단되며, 사이트 내에서 확인 가능한 제목과 본문 이외의 다른 정보를 포함하는 경우, 게시글을 확인하기 위해서 로그인을 해야 하거나 인증이 필요한 문서가 연동 정보에 포함된 경우 모두 신디케이션 연동을 할 수 없다.

준비 사항

• 사이트 소유 확인

네이버 웹 마스터 도구에서 콘텐츠를 보유하고 있는 웹 사이트의 소유자임을 확인받아야 한다. 해당 웹사이트에 위치한 콘텐츠에 대해서만 네이버 신디케이션을 사용할 수 있으며, 네이버 신디케이션 문서 또는 네이버 신디케이션 API의 호출 주소도 해당 웹사이트에 위치해야 한다. 인증키는 웹마스터도구의 설정 메뉴에 있는 신디케이션 인증키에서 확인할 수 있으며, 웹 마스터 로그인 계정 당 1개만 발급된다.

• 로봇 배제 표준에 대한 이해

사용자가 수집요청을 하더라도 robots.txt의 설정에 따라 네이버 검색 서비스가 수집요청 문서에 접근하지 못할 수 있다. 웹 사이트의 문서에 네이버 검색 로봇(서비스)의 접근이 가능하게 하려면, 홈페이지에서 설정을 해주어야 한다.

연동하는 방법

• 네이버 웹마스터도구에 로그인한다.
• 연동 사이트 목록의 “사이트 추가”를 클릭하여 사이트를 추가한다.
• 네이버 웹 마스터 도구의 연동할 사이트 도메인을 입력한다.

대표 도메인을 연결한 후 신디케이션에 연동해야하고, 도메인 등록 시 www.를 도메인 앞에 반드시 입력해야 한다,

• 웹 사이트 확인 절차

사이트의 소유정보를 확인하기 위한 확인 절차를 선택한다. 메타태그 사용 방법 , 에이치티엠엘(HTML)파일업로드 방법 중 하나를 택하면 된다.

• 메타태그 적용 시

웹 마스터 도구에서 메타태그를 복사하여 메인페이지의 헤더&메타&js의 메타태그 사이에 태그를 붙여준다.

• HTML 파일 업로드 적용 시

웹 마스터 도구에서 HTML 확인 파일을 눌러 다운받고, 받은 파일은 FTP 접속기 등을 이용하여 “www” 상위 폴더 안에 업로드 한다. HTML 확인 파일이 업로드 되었는지 확인한다.

• 발행된 토큰키(tokenkey) 확인

사이트 정보 확인이 완료된 이후 연동키를 받을 수 있다.

• 게시판 신디케이션 연동

신디케이션을 연동할 게시판 신디케이션 연동을 체크한다. 관리자> 설정변경> 게시판 관리> 연동할 게시판 선택> 전체 보기> 신디케이션 API를 찾아 체크해주면 된다.

• 웹 마스터 도구 신디케이션 연동

모든 설정이 완료되면 웹마스터 도구에서 신디케이션 연동을 선택하여 사이트를 연동할 수 있게 준비한다.

• 핑 신호 전달확인

모든 설정을 마치고 게시판 글쓰기를 할 경우 웹 마스터 도구에서 핑 사용 개수가 증가하는 것을 확인할 수 있다. 핑 사용 개수는 글을 등록, 수정, 삭제할 경우 증가한다.

참고자료

• 〈신디케이션 API 소개〉, 《네이버 서치어드바이저》
• naverdev, 〈Syndication API를 소개합니다.〉, 《네이버 개발자센터》, 2010-08-09
• 정미나 기자, 〈“신디케이션 API로 콘텐츠 검색 품질 높일 것”〉, 《전자신문》, 2010-05-14
• ADMIN_SHOP, 〈워드프레스 네이버 신디케이션의 개념과 기술적 내용〉, 《심포니소프트》, 2014-06-20
• 〈(웹드로우) 네이버 신디케이션 API (V1) 종료 안내〉, 《웹드로우》, 2014-09-03
• 뮤즈웍스, 〈네이버 웹문서 / 네이버신디케이션 V2 api연동방법〉, 《뮤즈웍스》, 2014-12-11
• 이민형 기자, 〈네이버 개발자 센터, 신디케이션 API 서비스 정식 오픈〉, 《디지털데일리》, 2020-04-01
• 〈신디케이션 연동 – 네이버 제휴 API?〉, 《옴니스로그》, 2020-09-20

같이보기

• API
• 엑스프레스엔진
• 검색 로봇
• 크롤링

개발 : 프로그래밍 □■⊕, 소프트웨어, 데이터, 솔루션, 보안, 하드웨어, 컴퓨터, 사무자동화, 인터넷, 모바일, 사물인터넷, 게임, 메타버스, 디자인 프로그래밍 언어 ASP • C 언어 • C++ • C# • CSS • D 언어 • HTML • HTML5 • JSP • PHP • R • XHTML • XML • XSLT • 고(Go) • 고급언어 • 기계어 • 델파이 • 러스트 • 루비 • 루아 • 리액트 • 리퀴디티 • 무브 • 미켈슨 • 베이직 • 브이비스크립트 • 비주얼 C++ • 비주얼베이직(VB) • 비주얼베이직닷넷(VB.NET) • 솔리디티 • 스몰토크 • 스위프트 언어 • 스칼라 • 스크립트 언어 • 알골 • 어셈블리 • 언리얼스크립트 • 얼랭 • 에이잭스(Ajax) • 엠에프씨(MFC) • 오브젝티브-C • 오브젝트 파스칼 • 오카멜 • 웹어셈블리(WASM) • 이와즘(eWASM) • 자바 • 자바스크립트 • 저급언어 • 제이슨(JSON) • 제이쿼리(jQuery) • 카멜 • 코볼 • 코틀린 • 콜드퓨전 • 타입스크립트 • 파스칼 • 파워스크립트 • 파이썬 • 펄(Perl) • 포트란 • 프로씨(Pro-C) • 피엘에스큐엘(PL/SQL) • 피엘원(PL/I) • 하스켈 개발방법론 CBD 개발방법론 • EA • 구조적 개발방법론 • 객체지향 개발방법론 • 라이브러리 • 람다 아키텍처 • 모듈 • 모듈화 • 벤치마킹 • 소프트웨어 개발방법론 • 스크럼 • 스프린트 • 아키텍처 • 아키텍트 • 애자일 • 웹개발방법론 • 정보공학 개발방법론 • 컴포넌트 • 테일러링 • 템플릿 • 폭포수 모델 • 프로젝트 • 프로토타입 • 피드백 코딩 EUC-KR • UTF-8 • 값 • 글루웨어 • 노팔로우 링크 • 두팔로우 링크 • 디버깅 • 디코딩 • 마크업 • 버그 • 부트스트랩 • 세이브포인트 • 소스코드 • 시큐어코딩 • 아스키 • 액티브엑스 • 오픈소스 • 유니코드 • 인코딩 • 재컴파일 • 주석 • 컴파일 • 컴퓨터 프로그램 • 코드 • 코딩 • 태그 • 테스트 • 테이블 • 텍스트 • 파싱 • 퍼블리싱 • 퓨니코드 • 하드코딩 • 하이퍼링크 • 하이퍼텍스트 프로그래밍 C 명령어 • 객체 • 객체지향 • 객체지향 프로그래밍 • 거짓 • 관계연산자 • 기본형 변수 • 널 • 논리 • 논리연산 • 논리연산자 • 다중상속 • 다형성 • 대입 • 대입문 • 대입연산자 • 더블 • 도스 명령어 • 디폴트 • 레지스터변수 • 루프 • 리눅스 명령어 • 리턴 • 메모리 주소 • 메소드 • 멤버 • 명령문 • 명령어 • 무한루프 • 문자 • 문자열 • 바이트 • 반복문 • 배열 • 변수 • 분기 • 분기문 • 불린 • 브레이크 • 비교연산자 • 비트연산자 • 산술연산자 • 상속 • 상수 • 생성자 • 선언 • 선언문 • 설정자 • 속성 • 스위치 • 스태틱 • 시프트연산자 • 실행 • 실행문 • 어노테이션 • 에코 • 역참조 • 연산 • 연산문 • 연산자 • 오버로딩 • 오버라이딩 • 외부변수 • 윈도우 명령어 • 유닉스 명령어 • 인스턴스 • 인스트럭션 • 인클루드 • 인터페이스 • 임포트 • 입력 • 입력문 • 입출력 • 입출력문 • 자료형(데이터 타입) • 자바 명령어 • 자바 예약어 • 자바 컬렉션 • 전역변수 • 접근자 • 접근제어자 • 정보은닉 • 정수형 • 정적변수 • 제어 • 제어문 • 제어자 • 조건 • 조건문 • 조건연산자 • 주소 • 증감연산자 • 지역변수 • 참 • 참조 • 참조변수 • 초기화 • 추상메소드 • 추상클래스 • 추상화 • 출력 • 출력문 • 캡슐화 • 케이스 • 클래스 • 파라미터(매개변수) • 파이널 • 패키지 • 퍼블릭 • 포인터 • 프라이빗 • 프로텍티드 • 필드(멤버변수) • 함수 • 환경변수 명령어 abstract • array • boolean • break • byte • case • char • continue • default • double • do while • echo • elif • else • else if • false • final • float • for • gosub • goto • if • if else • import • include • int • join • long • long long • null • print • printf • println • private • protected • public • return • scanf • short • stdio.h • static • string • switch • temp • then • true • unsigned • void • while 디자인패턴 구조패턴 • 동시성패턴 • 동시실행패턴 • 모델-뷰-컨트롤러 패턴 • 상태패턴 • 생성패턴 • 싱글톤패턴 • 아키텍처패턴 • 전략패턴 • 커맨드패턴 • 행동패턴 프로그래밍 인물 귀도 반 로썸 • 그레이스 머레이 호퍼 • 니클라우스 비르트 • 댄 브릭클린 • 더그 커팅 • 데니스 리치 • 리누스 토르발스 • 리처드 그린블라트 • 마거릿 해밀턴 • 마크 앤드리슨 • 빈트 서프 • 빌 게이츠 • 빌 조이 • 스티브 잡스 • 에이다 러브레이스 • 제임스 고슬링 • 척 벤턴 • 켄 톰슨 • 팀 패터슨 위키 : 자동차, 교통, 지역, 지도, 산업, 기업, 단체, 업무, 생활, 쇼핑, 블록체인, 암호화폐, 인공지능, 개발, 인물, 행사, 일반