네이버 뉴스 검색 API를 텔레그램 봇에 연결하는 방법

안녕하세요 케이입니다.

지난 글에서는 네이버 검색 API가 뉴스 데이터를 어떤 방식으로 가져오는지 기본적인 원리를 알아봤습니다.

이번에는 한 단계 더 진행해서 네이버 뉴스 검색 API에서 가져온 결과를 텔레그램 봇으로 전달하는 전체 연결 과정을 정리해보겠습니다.

지금까지 텔레그램 봇을 만들고 Bot Token과 Chat ID를 확인했습니다.

또한 뉴스 데이터를 가져오기 위해 API가 왜 필요한지와 네이버 뉴스 검색 API가 어떤 역할을 하는지도 알아봤습니다.

이제 각각 따로 준비한 기능을 하나로 연결할 차례입니다.

전체 구조는 간단합니다.

네이버에서 뉴스를 검색하고, Google Apps Script가 검색 결과를 받아 정리한 뒤, 텔레그램 봇으로 전달하는 방식입니다.

네이버 뉴스 검색 API와 텔레그램을 연결하는 구조

먼저 전체 흐름부터 다시 확인해보겠습니다.

사용자가 검색할 뉴스 키워드를 정합니다.

Google Apps Script가 네이버 뉴스 검색 API에 검색 요청을 보냅니다.

네이버에서 해당 키워드와 관련된 뉴스 결과를 반환합니다.

Google Apps Script가 뉴스 제목과 설명 등 필요한 정보만 정리합니다.

정리된 내용을 텔레그램 봇으로 전송합니다.

마지막으로 사용자는 텔레그램에서 뉴스 결과를 확인합니다.

전체 구조를 간단하게 표현하면 다음과 같습니다.

검색 키워드

네이버 뉴스 검색 API

Google Apps Script

텔레그램 봇

사용자

이 구조에서 Google Apps Script가 중간 연결 역할을 담당합니다.

연결하기 전에 준비해야 할 정보

실제 연결 작업을 시작하기 전에 몇 가지 정보를 미리 준비해야 합니다.

먼저 네이버 뉴스 검색 API를 사용하기 위한 인증정보가 필요합니다.

NAVER API HUB에서 Application을 등록하면 Client ID와 Client Secret을 확인할 수 있습니다.

그리고 텔레그램에서 앞서 만든 봇의 Bot Token이 필요합니다.

메시지를 받을 채팅방의 Chat ID도 준비해야 합니다.

결국 필요한 정보는 다음 네 가지입니다.

네이버 Client ID

네이버 Client Secret

텔레그램 Bot Token

텔레그램 Chat ID

이 네 가지 정보가 준비되어 있다면 기본적인 연결 작업을 시작할 수 있습니다.

Google Apps Script가 필요한 이유

네이버 뉴스 검색 API와 텔레그램 봇이 직접 서로 연결되는 것은 아닙니다.

중간에서 검색 요청을 보내고, 결과를 받아 정리하고, 다시 텔레그램으로 전달해주는 프로그램이 필요합니다.

이 역할을 Google Apps Script가 담당합니다.

Google Apps Script에서는 네이버 API에 요청을 보낼 수 있습니다.

API에서 받은 데이터를 읽고 필요한 내용만 선택할 수도 있습니다.

그리고 정리한 내용을 텔레그램 봇으로 전송할 수 있습니다.

별도의 프로그램을 컴퓨터에 설치하지 않아도 구글 계정을 이용해 사용할 수 있기 때문에 개인용 자동화를 테스트하기에 편리합니다.

먼저 검색 키워드를 정한다

뉴스 자동수집을 시작하려면 가장 먼저 검색어를 정해야 합니다.

예를 들어 저는 다음과 같은 검색어를 사용할 수 있습니다.

AI 자동화

이 검색어를 Google Apps Script에서 네이버 뉴스 검색 API에 전달합니다.

뉴스 API에서는 query라는 값을 이용해서 검색어를 전달합니다.

쉽게 생각하면 네이버 검색창에 직접 입력하던 내용을 프로그램이 대신 전달하는 것입니다.

처음 테스트할 때는 검색어 하나만 사용하는 것이 좋습니다.

여러 검색어를 한꺼번에 사용하면 문제가 발생했을 때 어느 부분에서 오류가 생겼는지 확인하기 어려울 수 있습니다.

먼저 하나의 검색어가 정상적으로 작동하는지 확인한 뒤 여러 키워드로 확장하는 방식이 좋습니다.

뉴스 검색 결과 개수도 설정할 수 있다

네이버 뉴스 검색 API에서는 한 번에 가져올 검색 결과의 개수를 지정할 수 있습니다.

이때 사용하는 값이 display입니다.

예를 들어 결과를 5개만 가져오도록 설정하면 검색 결과 가운데 지정한 개수만 반환됩니다.

처음에는 3개에서 5개 정도로 테스트하는 것이 편합니다.

결과가 너무 많으면 텔레그램 메시지가 길어지고 정상적으로 작동하는지 확인하기도 어렵기 때문입니다.

기본 기능이 안정적으로 작동한 뒤 필요에 따라 결과 개수를 늘리는 것이 좋습니다.

최신 뉴스 순으로 가져오려면 정렬 방식도 중요하다

뉴스 자동수집의 목적이 최신 정보를 확인하는 것이라면 검색 결과 정렬 방식도 중요합니다.

뉴스 검색 API에서는 관련도가 높은 결과를 우선하는 방식과 날짜를 기준으로 정렬하는 방식을 사용할 수 있습니다.

개인용 뉴스 자동수집에서는 최신 기사를 확인하는 것이 목적이라면 날짜순 정렬이 더 적합할 수 있습니다.

예를 들어 매일 아침 새로운 뉴스를 확인하고 싶다면 오래된 기사보다 최근 등록된 기사를 먼저 가져오는 방식이 편리합니다.

다만 어떤 정렬 방식이 좋은지는 자동수집 목적에 따라 달라질 수 있습니다.

특정 주제의 대표적인 기사를 확인하려면 관련도 순이 유용할 수 있고, 새로운 소식을 빠르게 확인하려면 날짜순이 더 적합할 수 있습니다.

네이버 API 인증정보를 프로그램에 넣는다

네이버 뉴스 검색 API에 요청을 보내려면 발급받은 Client ID와 Client Secret을 함께 전달해야 합니다.

현재 NAVER API HUB에서는 각각 정해진 인증 헤더를 이용합니다.

처음 코드를 작성할 때는 실제 인증정보 대신 다음과 같은 이름으로 구분해두면 이해하기 쉽습니다.

NAVER_CLIENT_ID

NAVER_CLIENT_SECRET

그리고 실제 사용할 때 발급받은 값을 입력합니다.

이 인증정보는 외부에 공개하지 않는 것이 중요합니다.

특히 블로그에 코드를 공개할 경우 실제 Client ID와 Client Secret을 그대로 작성하지 않는 것이 좋습니다.

화면 캡처를 사용할 때도 인증정보가 노출되지 않았는지 확인하는 것이 중요합니다.

Google Apps Script에서 뉴스 API를 호출하는 과정

Google Apps Script에서는 외부 서비스에 요청을 보낼 수 있는 기능을 사용할 수 있습니다.

이를 이용해서 네이버 뉴스 검색 API에 검색어와 인증정보를 전달합니다.

전체 과정은 다음과 같습니다.

검색어를 준비합니다.

뉴스 검색 API에 요청할 주소와 검색 조건을 설정합니다.

Client ID와 Client Secret을 인증정보로 전달합니다.

API 요청을 실행합니다.

네이버에서 검색 결과를 반환합니다.

Google Apps Script가 반환된 데이터를 읽습니다.

이 단계에서는 아직 텔레그램으로 메시