안녕하세요 케이입니다.

개인용 뉴스 자동수집 시스템을 만들다 보면 가장 먼저 접하게 되는 용어 중 하나가 API입니다.

텔레그램 봇을 만들고 Bot Token과 Chat ID까지 확인했다면, 이제 실제로 뉴스 데이터를 어디에서 가져올지 생각해야 합니다.

이때 중요한 역할을 하는 것이 바로 API입니다.

처음에는 API라는 단어 자체가 개발자만 사용하는 어려운 기술처럼 느껴질 수 있습니다.

하지만 뉴스 자동수집이라는 목적에 맞춰서 생각하면 개념은 의외로 단순합니다.

이번 글에서는 API가 무엇인지, 뉴스 자동수집에서 왜 필요한지, 실제로 어떤 방식으로 동작하는지 초보자 기준에서 쉽게 정리해보겠습니다.

API란 무엇인가

API는 프로그램과 프로그램이 서로 정보를 주고받을 수 있도록 만든 연결 방식입니다.

조금 더 쉽게 설명하면 한 프로그램이 다른 서비스에 필요한 정보를 요청하고, 그 결과를 일정한 형식으로 받아오는 통로라고 생각하면 됩니다.

예를 들어 사람이 직접 포털 사이트에 들어가서 검색창에 특정 단어를 입력하면 화면에 뉴스 검색 결과가 나타납니다.

사람은 그 화면을 보고 원하는 기사를 찾을 수 있습니다.

하지만 프로그램은 사람처럼 웹사이트 화면을 보고 판단하는 방식보다 일정한 형식으로 데이터를 받아오는 방식이 더 적합합니다.

이때 사용할 수 있는 방법 중 하나가 API입니다.

프로그램이 검색어를 전달하면 API가 해당 검색어와 관련된 결과를 데이터 형태로 반환합니다.

뉴스 자동수집에서는 이 구조를 이용해서 기사 제목이나 설명, 링크, 작성 시간 같은 정보를 가져올 수 있습니다.

뉴스 자동수집에서 API가 필요한 이유

뉴스 자동수집 시스템의 핵심은 사람이 직접 검색하지 않아도 프로그램이 필요한 정보를 가져오는 것입니다.

예를 들어 매일 아침 “생성형 AI”와 관련된 최신 뉴스를 확인한다고 생각해보겠습니다.

사람이 직접 한다면 다음과 같은 과정이 필요합니다.

포털 사이트에 접속합니다.

검색창에 생성형 AI를 입력합니다.

뉴스 검색 결과를 확인합니다.

새로운 기사가 있는지 확인합니다.

필요한 기사 제목과 내용을 확인합니다.

이 과정을 매일 반복해야 합니다.

뉴스 API를 이용하면 이런 반복 작업을 프로그램이 대신할 수 있습니다.

프로그램이 검색어를 API에 전달하고, API가 뉴스 검색 결과를 반환하면 필요한 정보를 텔레그램으로 보내는 방식입니다.

결국 API는 뉴스 검색 서비스와 자동화 프로그램을 연결하는 역할을 합니다.

뉴스 API는 어떤 정보를 가져올 수 있을까

뉴스 검색 API에서 제공하는 정보는 서비스마다 다를 수 있습니다.

일반적으로는 다음과 같은 정보를 사용할 수 있습니다.

기사 제목

기사 설명

기사 주소

게시 시간

원문 정보

검색 결과 개수

이 가운데 어떤 정보를 실제로 사용할지는 사용자가 결정할 수 있습니다.

뉴스 자동수집 시스템을 처음 만들 때는 기사 제목과 간단한 설명 정도만 사용해도 충분합니다.

예를 들어 텔레그램에는 다음과 같은 형태로 정리해서 보낼 수 있습니다.

오늘의 AI 뉴스

기사 제목

기사 요약 또는 설명

이 정도만 있어도 어떤 내용의 뉴스인지 빠르게 확인할 수 있습니다.

나중에 기능을 확장하면 게시 시간이나 카테고리 같은 정보를 추가할 수도 있습니다.

사람이 검색하는 방식과 API 검색의 차이

사람이 웹사이트에서 직접 검색하는 방식과 API를 이용하는 방식은 목적은 비슷하지만 처리 방식에는 차이가 있습니다.

사람은 화면을 보고 정보를 확인합니다.

검색 결과가 여러 개 나오면 제목과 내용을 읽고 원하는 기사를 선택합니다.

API는 화면 대신 구조화된 데이터를 제공합니다.

프로그램은 그 데이터를 읽고 필요한 항목만 선택해서 사용할 수 있습니다.

예를 들어 사람에게는 뉴스 검색 결과가 카드나 목록 형태로 보일 수 있습니다.

하지만 프로그램에서는 제목, 설명, 날짜 같은 정보가 각각 구분된 데이터로 전달됩니다.

이렇게 구조화된 데이터는 자동화에 사용하기 좋습니다.

그래서 뉴스 자동수집에서는 일반적인 웹 검색보다 API를 이용하는 방식이 더 효율적일 수 있습니다.

API 요청과 응답은 어떻게 이루어질까

API를 이해할 때 가장 중요한 개념은 요청과 응답입니다.

프로그램이 API에 원하는 정보를 요청합니다.

API는 요청 내용을 확인한 뒤 결과를 응답합니다.

뉴스 검색을 예로 들면 다음과 같습니다.

프로그램이 “AI 자동화”라는 검색어를 전달합니다.

뉴스 검색 API가 해당 검색어와 관련된 뉴스를 찾습니다.

API가 검색 결과를 프로그램에 반환합니다.

프로그램이 뉴스 제목과 설명을 정리합니다.

정리된 내용을 텔레그램 봇이 사용자에게 전송합니다.

이 구조를 이해하면 API라는 개념이 훨씬 단순해집니다.

API는 프로그램이 다른 서비스에 질문을 보내고, 그 결과를 받아오는 연결 방식이라고 생각하면 됩니다.

API 인증 정보가 필요한 이유

모든 API를 아무 제한 없이 사용할 수 있는 것은 아닙니다.

일부 서비스에서는 사용자가 누구인지 확인하기 위한 인증 정보가 필요합니다.

이 인증 정보는 서비스에 따라 이름이 다를 수 있습니다.

예를 들어 Client ID, Client Secret, API Key 같은 이름을 사용할 수 있습니다.

이 정보는 해당 API를 사용할 권한이 있는지를 확인하기 위한 용도입니다.

텔레그램에서 Bot Token을 이용해서 어떤 봇인지 확인하는 것과 비슷한 개념으로 이해할 수 있습니다.

뉴스 API를 사용할 때도 발급받은 인증 정보를 프로그램에 입력해서 정상적인 사용자인지 확인하는 과정이 필요할 수 있습니다.

API Key와 Bot Token은 같은 것일까

처음 자동화를 시작하면 API Key와 Bot Token을 혼동하기 쉽습니다.

두 정보는 비슷한 역할을 하는 것처럼 보일 수 있지만 사용되는 서비스가 다릅니다.

Bot Token은 텔레그램 봇을 사용할 때 필요한 인증 정보입니다.

API Key나 Client ID 같은 정보는 뉴스 검색 API를 사용할 때 필요한 인증 정보입니다.

즉 하나의 뉴스 자동수집 시스템 안에서도 서로 다른 인증 정보가 사용될 수 있습니다.

뉴스 데이터를 가져오기 위해서는 뉴스 API 인증 정보가 필요하고, 그 결과를 텔레그램으로 보내기 위해서는 텔레그램 Bot Token이 필요합니다.

역할을 구분해서 생각하면 훨씬 이해하기 쉽습니다.

API를 사용하면 자동화하기 쉬운 이유

API의 가장 큰 장점은 프로그램이 사용할 수 있도록 데이터가 일정한 형태로 제공된다는 점입니다.

뉴스 사이트의 화면 디자인이 바뀌더라도 API에서 제공하는 데이터 형식이 유지된다면 프로그램을 계속 사용할 수 있습니다.

또한 필요한 데이터만 선택해서 가져올 수 있기 때문에 자동화하기 좋습니다.

예를 들어 검색 결과에서 제목과 설명만 필요하다면 해당 정보만 가져와서 텔레그램 메시지로 만들 수 있습니다.

검색 결과가 여러 개라면 원하는 개수만 선택하는 기능도 추가할 수 있습니다.

이처럼 API는 반복적인 데이터 수집 작업을 프로그램으로 처리하기에 적합합니다.

뉴스 API를 사용할 때 확인할 점

뉴스 API를 사용할 때는 몇 가지 확인해야 할 부분이 있습니다.

첫 번째는 사용량 제한입니다.

서비스에 따라 하루 또는 일정 시간 동안 요청할 수 있는 횟수가 정해져 있을 수 있습니다.

두 번째는 검색 결과 범위입니다.

모든 뉴스 사이트의 내용을 제공하는지, 특정 범위의 검색 결과만 제공하는지 확인해야 합니다.

세 번째는 사용할 수 있는 데이터 종류입니다.

기사 제목, 설명, 작성 시간 등 어떤 정보를 제공하는지 확인하는 것이 좋습니다.

네 번째는 이용 조건입니다.

개인적으로 사용하는 경우와 상업적으로 사용하는 경우에 조건이 다를 수 있기 때문에 실제 운영 전에 확인하는 것이 좋습니다.

처음 개인용 뉴스 자동수집을 테스트하는 단계에서는 복잡한 기능보다 기본적인 검색 결과를 안정적으로 가져오는 것이 더 중요합니다.

API 없이도 뉴스 자동수집이 가능할까

API가 뉴스 자동수집의 유일한 방법은 아닙니다.

RSS를 이용해서 새로운 콘텐츠를 받아오는 방법도 있습니다.

RSS를 제공하는 사이트라면 새로 등록된 글이나 뉴스 정보를 자동으로 확인할 수 있습니다.

API와 RSS는 서로 다른 장단점이 있습니다.

API는 원하는 검색어를 기준으로 데이터를 요청하기 좋고, RSS는 특정 사이트에서 새롭게 등록된 콘텐츠를 확인하는 데 유용합니다.

앞으로 이 시리즈에서는 API 방식뿐 아니라 RSS를 이용한 뉴스 자동수집 방법도 함께 알아볼 예정입니다.

뉴스 API와 텔레그램 봇은 어떻게 연결될까

지금까지 만든 텔레그램 봇과 뉴스 API는 역할이 다릅니다.

뉴스 API는 데이터를 가져오는 역할을 합니다.

텔레그램 봇은 가져온 데이터를 사용자에게 전달하는 역할을 합니다.

그리고 두 기능을 중간에서 연결하는 프로그램이 필요합니다.

이 시리즈에서는 Google Apps Script를 이용해서 이 연결 과정을 만들어볼 예정입니다.

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

뉴스 API에서 데이터 검색

Google Apps Script에서 결과 처리

텔레그램 봇으로 메시지 전송

사용자는 텔레그램에서 뉴스 확인

이 구조가 완성되면 사람이 직접 검색하지 않아도 자동으로 원하는 뉴스를 받아볼 수 있게 됩니다.

뉴스 자동수집 시스템을 처음 만들 때 중요한 점

처음 API를 사용할 때 가장 어려운 부분은 코드 자체보다 용어가 많다는 점입니다.

API

요청

응답

인증

API Key

Client ID

데이터

이런 단어가 한꺼번에 나오면 복잡하게 느껴질 수 있습니다.

하지만 뉴스 자동수집이라는 하나의 목적을 기준으로 생각하면 역할은 단순합니다.

API는 뉴스를 가져옵니다.

Google Apps Script는 가져온 데이터를 정리합니다.

텔레그램 봇은 정리된 뉴스를 사용자에게 전달합니다.

처음에는 이 세 가지 역할만 정확하게 구분해도 충분합니다.

정리

뉴스 자동수집에서 API는 원하는 뉴스 데이터를 프로그램으로 가져오기 위한 중요한 연결 방식입니다.

사람이 직접 웹사이트에 접속해서 검색하는 대신 프로그램이 검색어를 API에 전달하고, 그 결과를 데이터 형태로 받아올 수 있습니다.

뉴스 API를 이용하면 기사 제목, 설명, 작성 시간 같은 정보를 자동으로 가져올 수 있고, 이 데이터를 Google Apps Script에서 처리한 뒤 텔레그램으로 전송할 수 있습니다.

API를 처음 접하면 어렵게 느껴질 수 있지만 기본 원리는 요청과 응답입니다.

프로그램이 필요한 정보를 요청하고 서비스가 결과를 반환하는 구조입니다.

앞에서 만든 텔레그램 봇이 뉴스를 전달하는 역할이라면 이제부터 알아볼 뉴스 API는 실제 뉴스 데이터를 가져오는 역할을 담당합니다.

다음 글에서는 뉴스 검색 API가 실제로 어떤 방식으로 뉴스 데이터를 반환하는지 알아보고, 뉴스 자동수집 시스템에서 사용할 수 있는 데이터 구조를 조금 더 구체적으로 정리해보겠습니다.

답글 남기기

이메일 주소는 공개되지 않습니다. 필수 필드는 *로 표시됩니다

글쓴이

bluekei9@keinote.com

관련 게시물

API와 RSS를 둘 다 써보니 초보자에게 어떤 방식이 더 쉬웠을까

안녕하세요 케이입니다. 앞에서는 네이버 뉴스 API 말고 RSS를 이용해서 같은 뉴스봇을 한번 만들어봤습니다. 둘 다 결국 뉴스 제목이나 링크를 텔레그램으로 보내준다는 점은...

모두 읽어보기

네이버 뉴스 API 말고 RSS로 같은 뉴스봇을 다시 만들어봤습니다

안녕하세요 케이입니다. 지금까지 제가 만든 뉴스봇은 주로 네이버 검색 API를 이용했습니다. 검색어를 입력하면 관련 뉴스를 찾아서 텔레그램으로 보내주는 방식이었습니다. 그런데 뉴스 자동수집...

모두 읽어보기

RSS와 뉴스 API의 차이, 자동수집에는 무엇이 좋을까

안녕하세요 케이입니다. 지난 글에서는 RSS를 이용해서 특정 사이트의 새로운 콘텐츠를 자동으로 확인하고 텔레그램으로 받아보는 방법을 알아봤습니다. 지금까지 뉴스 자동수집 방법으로 뉴스 API와...

모두 읽어보기

RSS를 이용해 뉴스를 텔레그램으로 자동 수집하는 방법

안녕하세요 케이입니다. 지난 글에서는 Google Apps Script의 시간 기반 트리거를 이용해서 매일 정해진 시간에 뉴스를 자동으로 받아보는 방법을 알아봤습니다. 지금까지는 주로 뉴스...

모두 읽어보기

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

안녕하세요 케이입니다. 지난 글에서는 네이버 검색 API가 뉴스 데이터를 어떤 방식으로 가져오는지 기본적인 원리를 알아봤습니다. 이번에는 한 단계 더 진행해서 네이버 뉴스...

모두 읽어보기

네이버 검색 API로 뉴스 데이터를 가져오는 원리

안녕하세요 케이입니다. 지난 글에서는 뉴스 자동수집 시스템에서 API가 무엇이고 왜 필요한지 알아봤습니다. 이번에는 조금 더 구체적으로 네이버 검색 API를 이용하면 뉴스 데이터를...

모두 읽어보기