Repolode
nlweb-ai

nlweb-ai/NLWeb

웹사이트에 자연어 대화형 인터페이스를 추가하고 MCP 클라이언트도 지원하는 프로토콜 및 툴킷 NLWeb의 Python 레퍼런스 구현입니다.

스타
6,258
포크
695
열린 이슈
65
마지막 커밋
2개월 전

어떤 프로젝트인가요?

NLWeb은 웹사이트에 대화형 인터페이스를 구축하기 위한 개방형 프로토콜과 샘플 코드 모음입니다. 사이트가 이미 게시하는 Schema.org 및 RSS 마크업을 활용해, 페이지의 구조화된 데이터를 바탕으로 자연어 질문에 답할 수 있습니다. NLWeb 인스턴스는 MCP 서버로도 동작하며 ask 메서드를 제공하므로, 하나의 엔드포인트로 사용자와 AI 에이전트를 모두 지원합니다.

이 저장소는 Python 레퍼런스 구현입니다. AskAgent 모듈은 OpenAI, DeepSeek, Gemini, Anthropic 등 여러 LLM 제공업체와 Qdrant, Milvus, Elasticsearch, Postgres 같은 벡터 스토어를 연결해 자연어 질의를 처리합니다. 그 밖에 에이전트 검색, HubSpot·Dynamics 365·Jira 같은 엔터프라이즈 데이터 소스에 대한 자연어-SQL 변환, LLM 모델 라우팅, 검색 결과의 신경망 기반 점수화 모듈도 포함되어 있습니다. Windows, macOS, Linux에서 실행되며 샘플 웹 UI도 제공합니다.

이 코드는 완성된 제품이 아니라 개념 증명을 목적으로 합니다. 프로덕션 환경에 배포할 때는 자체 프런트엔드를 사용하고 NLWeb을 실제 데이터베이스에 연결하는 것이 전제입니다.

핵심 기능

  • 01각 사이트를 자연어 질문용 ask 메서드를 제공하는 MCP 서버로 노출합니다.
  • 02사이트에 이미 있는 Schema.org 구조화 데이터를 사용해 질의에 답합니다.
  • 03YAML 설정으로 여러 LLM 제공업체와 벡터 스토어를 연결합니다.
  • 04HubSpot, Dynamics 365, Jira의 데이터를 대상으로 자연어-SQL 변환을 지원하는 DataFinder가 포함되어 있습니다.
  • 05로컬 테스트용 샘플 웹 UI와 데모 데이터 소스를 제공합니다.

활용 사례

  • 제품 카탈로그나 레시피 사이트처럼 콘텐츠가 많은 웹사이트에 대화형 검색창을 추가합니다.
  • 표준 MCP 엔드포인트를 통해 AI 에이전트가 웹사이트에 질의하도록 합니다.
  • 엔터프라이즈 CRM 또는 이슈 트래킹 데이터에 대한 자연어 접근을 프로토타이핑합니다.

빠른 시작

  1. 1

    노트북에서 실행하려면 hello-world 가이드(docs/nlweb-hello-world.md)를 따르세요

사용 전 알아둘 점

  • 이 프로젝트는 개념 증명용 참조 구현이며, README에는 커뮤니티가 더 나은 대안을 만들 것으로 기대한다고 나와 있습니다.
  • 실행하려면 LLM 제공자와 벡터 저장소를 구성해야 하므로 직접 호스팅에 수고가 듭니다.
  • README에 따르면 CI/CD 파이프라인은 아직 포함되어 있지 않습니다.

토픽

자주 묻는 질문

NLWeb은(는) 무엇인가요?
웹사이트에 자연어 대화형 인터페이스를 추가하고 MCP 클라이언트도 지원하는 프로토콜 및 툴킷 NLWeb의 Python 레퍼런스 구현입니다. NLWeb은 웹사이트에 대화형 인터페이스를 구축하기 위한 개방형 프로토콜과 샘플 코드 모음입니다. 사이트가 이미 게시하는 Schema.org 및 RSS 마크업을 활용해, 페이지의 구조화된 데이터를 바탕으로 자연어 질문에 답할 수 있습니다. NLWeb 인스턴스는 MCP 서버로도 동작하며 ask 메서드를 제공하므로, 하나의 엔드포인트로 사용자와 AI 에이전트를 모두 지원합니다.
NLWeb은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
NLWeb은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
NLWeb은(는) 아직 유지보수되고 있나요?
6개월 이내 업데이트. NLWeb의 마지막 커밋은 2026년 8월 11일입니다.
NLWeb은(는) 어디에 사용할 수 있나요?
제품 카탈로그나 레시피 사이트처럼 콘텐츠가 많은 웹사이트에 대화형 검색창을 추가합니다. 표준 MCP 엔드포인트를 통해 AI 에이전트가 웹사이트에 질의하도록 합니다. 엔터프라이즈 CRM 또는 이슈 트래킹 데이터에 대한 자연어 접근을 프로토타이핑합니다.
NLWeb는 어떻게 설치하나요?
노트북에서 실행하려면 hello-world 가이드(docs/nlweb-hello-world.md)를 따르세요
NLWeb은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/nlweb-ai/NLWeb

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트