RustXNG: 내 컴퓨터에서 돌리는 AI용 메타검색
외부 검색 API에 검색어를 맡기는 대신, 검색 엔진 자체를 내 컴퓨터에 두는 RustXNG이 등장했다.
이 아티클의 핵심 내용 요약과 글로벌 검색·AI 엔진을 위한 테이크어웨이입니다.
✦ KR 주제: AI 에이전트용 셀프호스팅 메타검색 RustXNG
✦ KR 핵심 요약: RustXNG은 SearXNG을 기반으로 Rust로 작성된 셀프호스팅 메타검색 엔진이다. 외부 검색 제공자의 결과를 JSON API와 MCP로 AI 에이전트에 전달하고 페이지 본문까지 수집할 수 있다. 웹 규모 인덱스는 없으며 rustxng-index와 위키백과 덤프로 보완한다.
🌐 Global Takeaway: RustXNG is a self-hosted metasearch engine written in Rust and based on SearXNG. It aggregates results from external search providers and exposes them to AI agents through a JSON API and MCP, with optional page text for grounding. It keeps no web-scale index; local indexes such as rustxng-index and Wikipedia dumps can be added.
아래 그림은 기존 AI 검색 연동 방식과 RustXNG의 검색 흐름, 내부 구성을 보여줍니다.
- 검색 API 키를 서비스별로 관리
- 응답 형식이 제각각
- 본문은 별도 수집
- 내 컴퓨터에서 실행
- 여러 검색사 결과 통합
- JSON API·MCP로 제공
🔍 1. 공개된 것: Rust로 만든 셀프호스팅 메타검색, RustXNG
RustXNG는 Rust 언어로 작성된 셀프호스팅 메타검색 엔진이다. GitHub 저장소 sahenjp/RustXNG의 공식 설명에 따르면 SearXNG를 기반으로 하며, 여러 외부 검색 제공자의 결과를 하나로 모아 준다. 메타검색이란 자체 검색 인덱스를 직접 운영하는 대신, 기존 검색 서비스들의 결과를 조회해 통합해 주는 방식을 뜻한다.
이 프로젝트가 기존 검색 엔진과 갈라지는 지점은 대상 사용자다. HTML 검색 화면을 주된 산출물로 삼기보다, AI 에이전트가 프로그램적으로 호출할 수 있는 JSON API와 MCP(Model Context Protocol) 인터페이스를 함께 제공한다. 검색 결과 링크 목록에 그치지 않고 옵션에 따라 페이지 본문 텍스트까지 가져올 수 있어, 검색을 'AI의 근거 수집' 용도로 설계한 도구다.
저장소는 수집 시점 기준 151개의 커밋을 기록하고 있으며, src·tests·examples·docs·tools 디렉터리와 Cargo.toml, Dockerfile을 포함한다. README는 영어·한국어·일본어 세 가지로 제공되고 LICENSE·SECURITY.md·CODE_OF_CONDUCT.md·CONTRIBUTING.md 같은 오픈소스 표준 문서도 갖춰져 있다. settings.clean.toml과 settings.full.toml처럼 용도별 설정 파일도 눈에 띈다.
2026년 11월 6일 스레드에 올라온 소개 글은 이 저장소가 공개 18일 만에 GitHub 별 793개를 기록했다고 전했다. 같은 글은 페이지 본문을 한 페이지당 최대 8,000자까지 가져올 수 있고, 구글 연결은 빠져 있으며 사이트마다 자동 검색 허용 여부를 확인해야 한다고 설명했다.
1-1. 공식 문서에서 확인된 사실
| 항목 | 내용 |
|---|---|
| 공식 명칭 | RustXNG |
| 저장소 | github.com/sahenjp/RustXNG |
| 언어·기반 | Rust로 작성, SearXNG 기반 |
| 핵심 기능 | 외부 검색사 결과 통합, JSON API·MCP 제공, 선택적 페이지 본문 수집 |
| 자체 인덱스 | 웹 규모의 검색 인덱스는 유지하지 않음 |
| 커밋 수 | 151개 |
| 문서 | 영어·한국어·일본어 README, SECURITY·CONTRIBUTING 등 표준 문서 |
| 배포 | 릴리스 바이너리(Linux·macOS·Windows)와 Cargo 소스 설치 |
RustXNG does not maintain a web-scale search index — 공식 README가 밝힌 원칙이다. 대신 rustxng-index로 선택한 사이트의 로컬 인덱스를 만들고 위키백과 덤프를 별도로 가져오는 방식으로 검색 범위를 보완한다.
🧠 2. 작동 원리: 거대한 인덱스 없이 검색사를 모은다
검색 엔진은 크게 두 부류로 나뉜다. 구글처럼 웹을 직접 크롤링해 자체 인덱스를 구축하는 방식과, RustXNG처럼 다른 검색 서비스의 결과를 모아 주는 메타검색 방식이다. RustXNG는 후자다. 사용자의 질의가 들어오면 외부 검색 제공자들에게 전달하고, 돌아온 결과들을 합쳐 하나의 응답으로 정리한다.
이 구조가 AI 에이전트에게 유리한 이유는 두 가지다. 첫째, 인덱스 신선도와 유지 비용 부담을 외부 검색사에 넘기므로 최신 결과를 상대적으로 적은 비용으로 얻을 수 있다. 둘째, 반환 형식을 JSON으로 통일할 수 있어 에이전트가 별도의 파싱 없이 바로 사용할 수 있다. 여기에 페이지 본문 텍스트 수집 옵션이 더해지면, 에이전트는 '어떤 페이지가 관련 있는가'를 넘어 '그 페이지가 실제로 무엇을 말하는가'까지 확보한다.
에이전트 관점에서 이 엔진이 제공하는 것은 다음과 같다.
- 여러 외부 검색사의 결과를 하나로 모은 통합 검색 응답
- JSON API와 MCP를 통한 프로그램 호출 인터페이스
- 옵션으로 켤 수 있는 페이지 본문 텍스트 수집
- 선택한 사이트의 로컬 인덱스와 위키백과 덤프를 통한 범위 보강
검색 결과 목록만으로 답하기 어려운 질문에서 LLM은 부족한 부분을 스스로 채우려 하다가 환각을 만들어내기 쉽다. 본문 텍스트를 근거로 함께 넘겨주면 이런 위험을 줄이는 데 도움이 된다. 이것이 RustXNG가 '검색기'이면서 동시에 '그라운딩 엔진'으로 불리는 이유다.
2-1. 로컬 인덱스와 위키백과 덤프로 범위를 보강하다
웹 규모 인덱스가 없다는 한계를 메우는 장치도 마련돼 있다. rustxng-index라는 보조 도구로 사용자가 관심 있는 특정 사이트들의 로컬 인덱스를 만들 수 있고, 위키백과 덤프를 별도로 가져와 검색 대상에 포함시킬 수 있다. 즉 전체 웹을 대상으로 하는 것이 아니라 '외부 검색사 결과 + 내가 지정한 사이트 + 위키백과'의 조합으로 검색 범위를 설계하는 셈이다.
사내 위키나 특정 커뮤니티 사이트처럼 외부 검색사가 잘 수집하지 않는 대상, 또는 최신 문서가 중요해 자체 수집이 필요한 경우에 유용하다. 다만 로컬 인덱스의 구축과 갱신은 사용자가 관리해야 한다는 점에서, 완전한 자체 검색 엔진과는 거리가 있다.
🛠️ 3. 설치: 미리 빌드된 바이너리와 Cargo 소스 설치
설치는 크게 두 갈래다. 첫째, GitHub 릴리스 페이지에서 Linux·macOS·Windows용으로 미리 빌드된 바이너리를 내려받는 방법이다. 빌드 도구 없이 실행 파일만 받으면 되므로 진입 장벽이 낮고, 릴리스 자산에는 각 파일의 SHA-256 사이드카가 함께 제공된다. 둘째, Cargo로 저장소에서 직접 설치하는 방법이다. 소스 설치는 Rust 1.89 이상과 C 빌드 툴체인을 요구하며, 릴리스 태그를 --locked 옵션과 함께 지정해 의존성 버전을 고정한다.
cargo install --git https://github.com/sahenjp/RustXNG.git --tag v0.31.2 --locked
예시로 쓰인 태그는 v0.31.2다. 소개 글은 명령을 실행할 수 있는 AI에게 저장소의 안내문을 붙여 넣으면 설치까지 진행해 준다고 전했는데, 이는 examples와 docs에 에이전트용 설정 가이드가 들어 있어 설치 절차를 자동화하기 쉽게 설계됐다는 뜻이다. 저장소에는 settings.toml 외에 settings.clean.toml·settings.full.toml 같은 설정 파일도 포함돼 있어, 실행 환경에 맞게 구성을 조정할 수 있다.
3-1. 바이너리를 쓸 때의 무결성 확인
공식 문서는 릴리스 바이너리를 실행하기 전에 SHA-256 사이드카 파일로 무결성을 확인하라고 안내한다. 셀프호스팅 도구는 결국 내 컴퓨터에서 상주하는 프로세스가 되므로, 배포 파일이 변조되지 않았는지 확인하는 절차를 설치의 일부로 취급하는 것이 안전하다. 저장소에는 Dockerfile도 포함돼 있어 컨테이너 기반 배포를 검토할 여지도 있다. 어느 방식으로 설치하든 실제 검색은 외부 제공자에서 이루어지므로, 설치 자체보다 어떤 제공자를 연결할지가 운영의 핵심 변수가 된다.
🤖 4. AI 에이전트와의 연결: JSON API와 MCP
RustXNG의 존재 이유는 'AI가 쓸 검색기'라는 점에 있다. 검색 결과를 HTML 화면이 아니라 JSON API로 제공하고, MCP 서버 형태로도 노출할 수 있어 MCP를 지원하는 에이전트가 검색을 하나의 도구처럼 호출할 수 있다. 저장소의 examples 디렉터리에는 연동 예제가, docs 디렉터리에는 에이전트 설정 가이드가 들어 있다.
에이전트가 검색을 호출하면 RustXNG는 외부 제공자들에게 질의를 전달하고 돌아온 결과를 정리해 반환한다. 옵션으로 페이지 본문 텍스트까지 함께 가져올 수 있는데, 소개 글은 이를 '한 페이지당 최대 8,000자' 규모로 설명했다. 검색 결과 목록만으로는 부족한 맥락을 본문에서 채울 수 있다는 뜻이다.
4-1. 왜 본문 텍스트가 중요한가
검색 엔진에 노출되기 위해 만들어진 웹페이지는 사람의 눈이 아니라 크롤러를 기준으로 설계된 경우가 많다. AI 에이전트에게 필요한 것은 '어떤 페이지가 관련 있는가'를 넘어 '그 페이지가 실제로 무엇이라고 말하는가'다. 본문을 텍스트로 넘겨주는 기능은 메타검색 결과를 AI의 근거 자료로 바꿔주는 다리 역할을 한다.
에이전트 입장에서 검색 API가 링크만 제공하면 결국 각 링크를 다시 열어 읽어야 하는 2차 작업이 생긴다. 본문 수집이 내장돼 있으면 이 과정이 한 번의 호출로 줄어든다. 다만 본문을 얼마나 깊게 가져올지는 설정에 따라 달라지며, 모든 페이지에서 동일한 품질의 텍스트가 나오는 것은 아니다.
⚖️ 5. 기존 AI 검색 연동과 무엇이 다른가
기존 방식에서 AI 에이전트는 각자 검색 API 키를 발급받아 외부 검색 서비스에 질의를 하고, 서비스마다 다른 응답 형식을 파싱해 사용했다. 서비스가 늘어날수록 키 관리와 형식 차이를 흡수하는 코드가 늘어나는 구조다. RustXNG는 이 과정을 내 컴퓨터의 단일 엔드포인트로 모은다. 검색어가 외부 검색 사이트로 전송된다는 점은 구조상 동일하지만, 관리 지점과 결과 형식은 하나로 통일된다.
에이전트 입장에서 검색은 부가 기능이 아니라 매번 호출되는 기본 도구다. 이 도구의 호출 인터페이스를 JSON API와 MCP로 표준화해 두면, 에이전트 프레임워크를 바꾸거나 검색 서비스를 교체하더라도 연동 코드를 다시 작성할 필요가 줄어든다. 셀프호스팅이라는 점은 여기에 '데이터가 어디서 처리되는지 내가 안다'는 통제권을 더한다.
5-1. SearXNG과의 관계
RustXNG는 SearXNG의 메타검색 개념을 계승하면서 Rust로 다시 구현한 프로젝트다. 웹 브라우저에서 쓰는 SearXNG와 달리 RustXNG는 처음부터 AI 에이전트 연동을 목표로 설계됐다. JSON API와 MCP 제공, 페이지 본문 수집 옵션, rustxng-index 같은 보조 도구가 그 차이를 보여준다. 언어가 Rust라는 점은 실행 파일 하나로 배포하기 쉽고 메모리 사용량을 낮추는 데 유리하다는 실무적 의미도 있다.
| 항목 | 기존 검색 API 연동 | RustXNG |
|---|---|---|
| 실행 위치 | 외부 검색 서비스 | 내 컴퓨터(셀프호스팅) |
| 결과 형식 | 서비스별로 상이 | JSON API·MCP로 통일 |
| 페이지 본문 | 별도 수집 파이프라인 필요 | 본문 수집 옵션 내장 |
| 관리 포인트 | 서비스별 키·쿼터 관리 | 단일 엔드포인트에서 통합 관리 |
⚠️ 6. 한계와 주의할 점
첫째, 웹 규모 인덱스를 유지하지 않는다는 것은 곧 커버리지의 한계다. 외부 제공자가 수집하지 않는 사이트나 아주 최신 문서는 결과에서 빠질 수 있고, 로컬 인덱스는 사용자가 지정한 범위에만 적용된다. '전체 웹을 다 아는 검색기'를 기대하면 안 된다.
둘째, 셀프호스팅이 프라이버시를 완전히 보장하지는 않는다. 메타검색의 구조상 실제 검색은 외부 제공자에서 수행되므로 검색어는 외부로 전송된다. 검색어에 민감한 정보가 포함될 수 있다면 제공자 선택과 로그 관리 정책을 따져봐야 한다. 소개 글도 사이트마다 자동 검색 허용 여부를 확인해야 한다고 짚었다.
셋째, 검색 품질은 외부 제공자의 상태에 의존한다. 제공자가 차단하거나 결과를 제한하면 메타검색의 커버리지도 함께 줄어든다. 셀프호스팅의 장점인 통제권은 '내 서버에서 돌린다'는 점에 있지, '검색 결과의 질을 보장한다'는 점에 있지 않다.
넷째, 운영 책임이 사용자에게 있다. 셀프호스팅은 서버를 직접 돌린다는 뜻이므로 업데이트, 모니터링, 장애 대응을 직접 챙겨야 한다. 다행히 Dockerfile이 포함돼 있어 컨테이너로 격리 운영할 수 있고, 제공자 연결 설정도 settings 파일로 관리된다. 마지막으로 프로젝트 자체가 공개된 지 얼마 되지 않은 초기 단계다. 수집 시점 기준 커밋 151개 규모로, 인터페이스나 설정 방식이 빠르게 바뀔 수 있다는 점을 감안해야 한다.
✅ 7. 정리
RustXNG는 AI 에이전트에게 검색 능력을 붙여주는 셀프호스팅 메타검색 엔진이다. Rust로 작성됐고 SearXNG를 기반으로 하며, 외부 검색사 결과를 JSON API와 MCP로 통합해 페이지 본문까지 전달한다. 웹 규모 인덱스는 없지만 rustxng-index와 위키백과 덤프로 필요한 범위를 보강할 수 있다. 검색어가 외부 제공자로 전송된다는 구조적 특성과 사이트별 이용 조건은 도입 전에 확인할 부분이다.
이런 개발자에게 맞는다.
- 로컬 또는 자체 호스팅 AI 에이전트를 직접 운영하는 경우
- 여러 검색 API 키와 형식 차이 관리를 하나로 줄이고 싶은 경우
- 검색 결과에 페이지 본문까지 함께 넘겨 근거 기반 답변을 만들고 싶은 경우
반대로 검색 품질이 최우선인 일반 사용자, 검색어 자체가 외부로 나가면 안 되는 환경, 그리고 자체 검색 인덱스 수준의 커버리지가 필요한 경우에는 부적합하다. 프로젝트는 아직 초기 단계이므로 프로덕션 도입 전에는 제공자 설정, 사이트별 이용 조건, LICENSE 유형을 저장소에서 직접 확인하는 절차를 거치는 것이 좋다.
자주 묻는 질문
Q. RustXNG은 무료로 쓸 수 있나?
A. 저장소에 LICENSE 파일과 SECURITY.md, CODE_OF_CONDUCT.md 같은 오픈소스 표준 문서가 포함돼 있다. 정확한 라이선스 유형과 조건은 저장소의 LICENSE 파일에서 확인하면 된다.
Q. SearXNG과 어떻게 다른가?
A. RustXNG은 SearXNG을 기반으로 Rust로 작성된 메타검색 엔진이다. 웹용 검색 화면보다 AI 에이전트 연동에 초점을 맞춰 JSON API와 MCP, 페이지 본문 수집 기능을 제공한다는 점이 특징이다.
Q. 설치에 필요한 것은?
A. Linux·macOS·Windows용 릴리스 바이너리를 받거나 cargo install 명령으로 설치할 수 있다. 소스에서 빌드하려면 Rust 1.89 이상과 C 빌드 툴체인이 필요하다.
Q. 자체 검색 인덱스가 있나?
A. 웹 규모의 자체 인덱스는 유지하지 않는다. 대신 rustxng-index로 선택한 사이트의 로컬 인덱스를 만들고 위키백과 덤프를 별도로 가져올 수 있다.



댓글 0개