텍톡랩은 AI로 해보고 싶은 것들을 해보는 100만가지 실험실입니다. 지난번 “자격증 공부 에뮬레이터”에 이어, 이번 실험은 **“나만의 AI 에이전트를 위한 강력한 검색 도구 만들기”**입니다.
URL: https://github.com/sdk-kr/search-api
왜 검색 API를 직접 만들었나?
요즘 n8n이나 랭체인(LangChain)으로 나만의 AI 비서(에이전트)를 만드는 분들이 많습니다. 그런데 AI에게 최신 정보를 주려면 ‘검색’ 기능이 필수입니다.
보통은 이런 문제들이 있죠.
- 비용 문제: SerpApi 같은 상용 툴은 편하지만 비쌉니다.
- 파편화된 정보: 구글 검색 따로, 네이버 블로그/뉴스 따로 연동하려면 노드가 복잡해집니다.
- 한국형 정보 부재: 구글만으로는 한국의 로컬 정보(네이버 블로그, 뉴스 등)를 디테일하게 긁어오기 힘듭니다.
그래서 만들었습니다. 구글(Google) + 네이버(Naver) 블로그/뉴스를 한 번에 긁어오는 통합 검색 API 서버입니다.
이 프로그램의 핵심: ‘통합과 속도’
지난번 퀴즈 앱이 “손이 덜 가야 공부한다”였다면, 이번 검색 API는 **”빨라야 써먹는다”**가 핵심입니다. 그래서 Python 대신 Go(Golang) 언어를 선택했습니다.
- 통합 검색: 키워드 하나만 던지면
네이버 블로그,네이버 뉴스,구글 웹 검색결과를 한 방에 묶어서 줍니다. - 고성능 (Go + Gin): 가볍고 빠릅니다. AI가 대답을 기다리는 시간을 줄여줍니다.
- 보안 (API Key): 아무나 내 API를 쓰지 못하게 헤더(Header) 인증 방식을 넣었습니다.
- 쉬운 배포 (Docker): 복잡한 설치 없이 도커 한 방이면 실행됩니다.
🛠 사용 방법 (3분 컷)
AI 바이브코딩 시대, 메커니즘만 이해하면 누구나 설치할 수 있습니다.
1. 준비물 챙기기 (API 키 발급)
무료로 쓸 수 있는 키들을 발급받아 .env 파일에 넣기만 하면 됩니다.
- 네이버 개발자 센터: 검색 API 신청 (하루 25,000건 무료)
- Google Cloud Console: Custom Search API 키 발급
2. 설치 및 실행 (Docker 추천)
코드를 몰라도 됩니다. 터미널에 아래 명령어만 입력하면 서버가 켜집니다.
Bash
# 1. 프로젝트 다운로드 git clone https://github.com/sdk-kr/search-api cd search-api # 2. 설정 파일 복사 및 키 입력 (.env 파일 수정) cp .env.sample .env # 3. 실행 (도커) docker-compose up -d
3. 사용하기 (AI에게 이렇게 시키세요)
이제 여러분의 AI 에이전트(n8n, GPT 등)가 아래 주소로 요청을 보내면 됩니다.
요청 예시 (POST):
“Go 언어에 대해 네이버랑 구글에서 찾아줘”
JSON
POST http://localhost:8000/search
{
"query": "Go 언어",
"enable_blog": true,
"enable_news": true,
"enable_google": true
}
결과 (Response): 블로그 글, 뉴스 기사, 웹 검색 결과가 예쁘게 정리된 JSON으로 돌아옵니다. AI는 이 내용을 읽고 여러분에게 답변을 해주겠죠.
활용 팁: 어디에 쓰나요?
- 나만의 뉴스 요약 봇: 매일 아침 특정 키워드(예: “AI 트렌드”) 뉴스를 긁어와서 요약시킬 때
- 블로그 마케팅 분석: 경쟁사가 네이버 블로그에 어떤 글을 쓰는지 구글 검색과 함께 분석할 때
- 팩트 체크 에이전트: LLM이 거짓말(할루시네이션)을 하지 않도록, 실제 검색 결과를 근거로 제시하게 만들 때
복잡한 검색 로직은 이 서버에 맡기고, 여러분은 **”어떤 질문을 할까”**에만 집중하세요.
새해에는 여러분만의 똑똑한 AI 비서를 만들어보시길 바랍니다. 아… 검색이야.
👉 GitHub 바로가기: https://github.com/sdk-kr/search-api