Naver와 관련된 모든 기능, 특히 Naver Cloud CLOVA Studio를 통해 접근 가능한 HyperCLOVA X 모델을 포함합니다.
Naver는 검색, 커머스, 핀테크, 콘텐츠, 클라우드, AI를 포함한 최첨단 기술과 다양한 비즈니스 포트폴리오를 보유한 글로벌 기술 기업입니다.
Naver Cloud는 Naver의 클라우드 컴퓨팅 부문으로, Naver Cloud Platform (NCP)를 통해 기업에 포괄적인 클라우드 서비스를 제공하는 선도적인 클라우드 서비스 제공업체입니다.
더 자세한 안내는 NCP 사용자 가이드를 참조하세요 (한국어로도 제공됩니다).

​
설치 및 설정

  • CLOVA Studio API Key를 발급받아 환경 변수(CLOVASTUDIO_API_KEY)로 설정하세요.
Naver integration은 두 개의 패키지로 제공됩니다:
  • langchain-naver: Naver 전용 integration 패키지입니다.
  • langchain-naver-community: 커뮤니티에서 유지 관리하는 패키지이며 Naver 또는 LangChain에서 공식적으로 유지 관리하지 않습니다.
pip install -U langchain-naver
# pip install -U langchain-naver-community // Install to use Naver Search tool.
(참고) 서드파티 integration 모음인 langchain-community를 통한 Naver integration은 구버전입니다.
  • 새로운 기능은 이 패키지를 통해서만 구현되므로 langchain-naver를 사용하세요.
  • langchain-community(구버전)를 사용 중이고 레거시 API Key(nv-* 접두사로 시작하지 않는)를 가지고 있다면, NCP_CLOVASTUDIO_API_KEY로 설정해야 하며, 앱 생성을 통해 추가 API Gateway API Key를 발급받아 NCP_APIGW_API_KEY로 설정해야 할 수 있습니다.

​
Chat models

​
ChatClovaX

사용 예제를 참조하세요. 
from langchain_naver import ChatClovaX

​
Embedding models

​
ClovaXEmbeddings

사용 예제를 참조하세요. 
from langchain_naver import ClovaXEmbeddings

​
Tools

Naver Search integration을 사용하면 LangChain 애플리케이션이 Naver 검색 엔진에서 정보를 검색할 수 있습니다. 이는 한국어 쿼리와 한국 관련 주제에 대한 최신 정보를 얻는 데 특히 유용합니다. Naver Search tool을 사용하려면 다음이 필요합니다:
  1. Naver Developers 포털에 로그인
  2. 새 애플리케이션을 생성하고 Search API를 활성화
  3. “애플리케이션 목록” 섹션에서 NAVER_CLIENT_ID와 NAVER_CLIENT_SECRET을 발급
  4. 애플리케이션에서 이를 환경 변수로 설정
from langchain_naver_community.tool import NaverSearchResults
from langchain_naver_community.utils import NaverSearchAPIWrapper

# Set up the search wrapper
search = NaverSearchAPIWrapper()

# Create a tool
tool = NaverSearchResults(api_wrapper=search)
자세한 내용은 사용 예제를 참조하세요.

​
특화된 검색 도구

패키지는 다양한 유형의 콘텐츠에 대한 특화된 검색 도구도 제공합니다: 
from langchain_naver_community.tool import NaverNewsSearch  # For news articles
from langchain_naver_community.tool import NaverBlogSearch  # For blog posts
from langchain_naver_community.tool import NaverImageSearch  # For images
이러한 각 도구는 LangChain agent 내에서 사용되어 보다 타겟팅된 검색 기능을 제공할 수 있습니다. CRITICAL: Provide ONLY the translated MDX content without any additional explanation, comments, or questions. If the content is empty or contains only frontmatter, return it exactly as provided.
Edit the source of this page on GitHub.
Connect these docs programmatically to Claude, VSCode, and more via MCP for real-time answers.
⌘I