"A no-key web search API for AI agents, and the MCP server that wraps it"

개요

scouts-ai.com의 공개 웹 검색 API는 AI 에이전트가 별도의 API 키, 계정, 결제 없이 웹 검색 기능을 사용할 수 있도록 지원하며, 이를 MCP 서버와 통합하여 다양한 AI 에이전트 환경에서 활용할 수 있다.

주요 내용

* scouts-ai.com 검색 API:
* https://scouts-ai.com/api/search 엔드포인트는 인증 헤더나 API 키 없이 GET 요청으로 접근 가능하다.
* q(쿼리), lang(BCP-47 언어 코드, 기본값 'en'), limit(결과 수, 기본값 10, 최대 50)의 세 가지 쿼리 매개변수를 사용한다.
* 응답은 query, lang, page, pageSize, cached, tookMs, results를 포함하는 JSON 형식이며, 각 result 객체는 title, url, content, publishedAt, engine을 포함한다.
* IP당 분당 60회 요청의 제한이 있으며, 1시간 동안 캐싱이 적용된다.
* Python MCP 서버 (scouts-ai-mcp):
* MIT 라이선스로 제공되는 scouts-ai-mcp PyPI 패키지를 통해 설치 및 사용 가능하다.
* Python 3.10 이상, fastmcp v2, httpx를 의존한다.
* web_search(query: str, lang: str = "en", limit: int = 10) 시그니처를 가진 단일 MCP 도구를 제공한다.
* Claude Desktop, Cursor 등 MCP 호스트와 통합하여 web_search 도구로 활용할 수 있다.
* API 직접 사용:
* MCP 서버 없이 Python에서 httpx 라이브러리를 사용하거나, 쉘 환경에서는 curl을 통해 API를 직접 호출하여 검색 결과를 얻을 수 있다.
* 주요 주의사항 (Gotchas):
* lang 매개변수는 결과 필터링이 아닌 힌트 역할만 하며, 실제 결과는 영어로 반환될 수 있다.
* 캐시 작동 방식으로 인해 동일한 쿼리의 재실행 시 성능 측정 시 주의가 필요하다.
* 가장 최신 결과가 항상 포함되는 것은 아니며, 인덱싱 주기 및 엔진별 랭킹에 따라 결과의 신선도가 달라질 수 있다.
* API는 GET 요청만 지원하며, POST 요청 시 405 오류가 발생한다.
* SLA, 상태 페이지, 지원 계층이 제공되지 않는 무료 공개 엔드포인트이므로 프로덕션 환경에서는 안정성을 위한 백업 방안을 고려해야 한다.
* MCP 서버의 web_search 도구는 제한된 기능(recency\_days, site:, boolean operators, filetype: 등 미지원)을 가지므로, 더 풍부한 쿼리 언어가 필요한 경우 다른 솔루션을 고려해야 한다.

시사점

scouts-ai.com 검색 API와 이를 활용한 MCP 서버는 API 키 관리, 결제, 속도 제한 협상 등의 복잡성 없이 AI 에이전트에 웹 검색 기능을 쉽게 통합할 수 있는 간편한 솔루션을 제공하며, 개인 에이전트, 데모, 해커톤 프로젝트 등 저트래픽 서비스에 적합하다.