Naver Search MCP Server
ネイバー検索MCPサーバー
このMCP(マルチプラットフォーム通信プロトコル)サーバーは、Naver検索APIへのアクセスを提供し、AIエージェントがNaver上のさまざまなタイプのコンテンツを検索できるようにします。
概要
ブログ、ニュース、書籍、画像、ショッピングアイテムなどを検索
ページネーションをサポートする複数の検索カテゴリ
LLM の利用に最適化された構造化テキスト応答
アダルトコンテンツを確認する
キーボード入力エラーの変換(エラッタ)
Related MCP server: KiMCP
目次
設定
前提条件
Python 3.12以上
Naver 開発者 API 認証情報
これらの資格情報は、Naver Developersポータルにサインアップすることで取得できます。
私のブログ「Naver Search API MCP Server」もご覧ください。
インストール
リポジトリをクローンします。
git clone https://github.com/jikime/py-mcp-naver-search.git
cd py-mcp-naver-searchUV設置
curl -LsSf https://astral.sh/uv/install.sh | sh仮想環境を作成し、依存関係をインストールします。
uv venv -p 3.12
source .venv/bin/activate
pip install -r requirements.txtNaver API 資格情報を使用して
.envファイルを作成します。
cp env.example .env
vi .env
NAVER_CLIENT_ID=your_client_id_here
NAVER_CLIENT_SECRET=your_client_secret_hereDockerの使用
Docker イメージをビルドします。
docker build -t py-mcp-naver-search .コンテナを実行します。
docker run py-mcp-naver-searchローカルの使用
サーバーを実行します。
mcp run server.pyMCP設定を構成する
MCP 設定ファイルにサーバー構成を追加します。
クロードデスクトップアプリ
Smithery経由で自動的にインストールするには:
npx -y @smithery/cli install @jikime/py-mcp-naver-search --client claude手動でインストールするには
~/Library/Application Support/Claude/claude_desktop_config.jsonを開きます。
これをmcpServersオブジェクトに追加します。
{
"mcpServers": {
"Google Toolbox": {
"command": "/path/to/bin/uv",
"args": [
"--directory",
"/path/to/py-mcp-naver-search",
"run",
"server.py"
]
}
}
}カーソルIDE
~/.cursor/mcp.jsonを開く
これをmcpServersオブジェクトに追加します。
{
"mcpServers": {
"Google Toolbox": {
"command": "/path/to/bin/uv",
"args": [
"--directory",
"/path/to/py-mcp-naver-search",
"run",
"server.py"
]
}
}
}Docker用
{
"mcpServers": {
"Google Toolbox": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"py-mcp-naver-search"
]
}
}
}クライアントの使用
リポジトリにはテスト用のクライアント スクリプトが含まれています。
# Basic search
uv run client.py blog "Python programming" display=5 page=1
# News search with sorting
uv run client.py news "AI" display=10 page=1 sort=date
# Image search with filtering
uv run client.py image "cat" display=10 filter=large
# Check for adult content
uv run client.py adult "your query"
# Errata correction
uv run client.py errata "spdlqj"利用可能な検索カテゴリ
サーバーは次の検索カテゴリをサポートしています。
blog- ブログ投稿news- ニュース記事book- 本adult- アダルトコンテンツチェックencyc- 百科事典のエントリcafe_article- カフェの記事kin- 知識iN Q&Alocal- 地元のビジネス情報errata- キーボード入力エラーの修正shop- ショッピングアイテムdoc- 学術論文と文書image- 画像webkr- ウェブドキュメント
APIリファレンス
ツール
ブログを検索
search_blog(query: str, display: int = 10, page: int = 1, sort: str = "sim") -> str指定されたキーワードを使用してNaver上のブログを検索します。
ニュースを検索
search_news(query: str, display: int = 10, page: int = 1, sort: str = "sim") -> str指定されたキーワードを使用してNaver上のニュースを検索します。
本を検索
search_book(query: str, display: int = 10, page: int = 1, sort: str = "sim") -> str指定されたキーワードを使用してNaver上の書籍情報を検索します。
アダルトクエリを確認する
check_adult_query(query: str) -> str入力クエリがアダルト検索用語かどうかを判断します。
百科事典を検索
search_encyclopedia(query: str, display: int = 10, page: int = 1, sort: str = "sim") -> str指定されたキーワードを使用してNaver上の百科事典情報を検索します。
カフェ記事を検索
search_cafe_article(query: str, display: int = 10, page: int = 1, sort: str = "sim") -> str指定されたキーワードを使用してNaver上のカフェ記事を検索します。
KnowledgeiNを検索
search_kin(query: str, display: int = 10, page: int = 1, sort: str = "sim") -> str指定されたキーワードを使用して、Naver 上の Knowledge iN Q&A を検索します。
ローカル検索
search_local(query: str, display: int = 5, page: int = 1, sort: str = "random") -> str指定されたキーワードを使用して、ローカルビジネス情報を検索します。
訂正訂正
correct_errata(query: str) -> str韓国語/英語のキーボード入力エラーを変換します。
ショップを検索
search_shop(query: str, display: int = 10, page: int = 1, sort: str = "sim") -> str指定されたキーワードを使用してNaver上のショッピング商品情報を検索します。
ドキュメントを検索
search_doc(query: str, display: int = 10, page: int = 1) -> str指定したキーワードを使用して学術論文、レポートなどを検索します。
画像を検索
search_image(query: str, display: int = 10, page: int = 1, sort: str = "sim", filter: str = "all") -> str指定されたキーワードを使用して画像を検索します。
ウェブドキュメントを検索
search_webkr(query: str, display: int = 10, page: int = 1) -> str指定されたキーワードを使用して Web ドキュメントを検索します。
リソース
利用可能な検索カテゴリ
GET http://localhost:8000/available-search-categoriesこの MCP サーバーで利用可能な Naver 検索カテゴリのリストを返します。
応答フォーマット
すべてのツールは、LLM 処理に最適化された構造化テキスト形式で応答を返します。
Naver Blog search results (total 12,345 of 1~10):
### Result 1
Title(title): Sample Blog Post
Link(link): https://blog.example.com/post1
Description(description): This is a sample blog post about...
Blogger name(bloggername): John Doe
Blogger link(bloggerlink): https://blog.example.com
Post date(postdate): 20250429
### Result 2
...謝辞
ライセンス
このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細については LICENSE ファイルを参照してください。
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- FlicenseAqualityDmaintenanceProvides AI tools with access to real-time web search, automated code reviews, and detailed Korean business information through the AgentSkills API. It enables users to perform structured searches, analyze code for security and performance, and retrieve Korean company financial data.3
- AlicenseNot gradedqualityDmaintenanceIntegrates Korean APIs (Naver, Kakao, TMAP) into LLM applications for search, maps, and directions.10MIT
- AlicenseNot gradedqualityCmaintenanceKorean-aware Google search and place discovery server using Serper API. Features include web search, Naver blog/cafe search, and a unique discover_places tool that generates queries from Korean area and category to extract place names.MIT
- FlicenseNot gradedqualityDmaintenanceEnables searching and retrieving Korean laws, precedents, and administrative rules through the National Law Information Center Open API, optimized for AI agents.
Related MCP Connectors
The best web search for your AI Agent
Web search, page extraction and structured commerce, social and business data for AI agents
LLM-ready web search + instant answers + URL-to-clean-text fetch for agents and RAG.
Appeared in Searches
- Naver - Korean Search Engine and Web Portal
- A platform for analyzing crypto narratives based on macroeconomic events and cultural trends
- A tool for analyzing Indian stock data for investment decisions using LLMs and news insights
- A server for finding academic papers, reading summaries, and tracking latest publications
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/jikime/py-mcp-naver-search'
If you have feedback or need assistance with the MCP directory API, please join our Discord server