Skip to main content
Glama
jikime

Naver Search MCP Server

by jikime

ネイバー検索MCPサーバー

鍛冶屋のバッジ バージョンライセンス

このMCP(マルチプラットフォーム通信プロトコル)サーバーは、Naver検索APIへのアクセスを提供し、AIエージェントがNaver上のさまざまなタイプのコンテンツを検索できるようにします。

概要

  • ブログ、ニュース、書籍、画像、ショッピングアイテムなどを検索

  • ページネーションをサポートする複数の検索カテゴリ

  • LLM の利用に最適化された構造化テキスト応答

  • アダルトコンテンツを確認する

  • キーボード入力エラーの変換(エラッタ)

Related MCP server: KiMCP

目次

設定

前提条件

インストール

  1. リポジトリをクローンします。

git clone https://github.com/jikime/py-mcp-naver-search.git
cd py-mcp-naver-search
  1. UV設置

curl -LsSf https://astral.sh/uv/install.sh | sh
  1. 仮想環境を作成し、依存関係をインストールします。

uv venv -p 3.12
source .venv/bin/activate
pip install -r requirements.txt
  1. Naver API 資格情報を使用して.envファイルを作成します。

cp env.example .env
vi .env

NAVER_CLIENT_ID=your_client_id_here
NAVER_CLIENT_SECRET=your_client_secret_here

Dockerの使用

  1. Docker イメージをビルドします。

docker build -t py-mcp-naver-search .
  1. コンテナを実行します。

docker run py-mcp-naver-search

ローカルの使用

  1. サーバーを実行します。

mcp run server.py

MCP設定を構成する

MCP 設定ファイルにサーバー構成を追加します。

クロードデスクトップアプリ

  1. Smithery経由で自動的にインストールするには:

npx -y @smithery/cli install @jikime/py-mcp-naver-search --client claude
  1. 手動でインストールするには~/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"

利用可能な検索カテゴリ

サーバーは次の検索カテゴリをサポートしています。

  1. blog - ブログ投稿

  2. news - ニュース記事

  3. book - 本

  4. adult - アダルトコンテンツチェック

  5. encyc - 百科事典のエントリ

  6. cafe_article - カフェの記事

  7. kin - 知識iN Q&A

  8. local - 地元のビジネス情報

  9. errata - キーボード入力エラーの修正

  10. shop - ショッピングアイテム

  11. doc - 学術論文と文書

  12. image - 画像

  13. 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 ファイルを参照してください。

Install Server
A
license - permissive license
A
quality
D
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

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

  • F
    license
    A
    quality
    D
    maintenance
    Provides 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
  • A
    license
    Not graded
    quality
    D
    maintenance
    Integrates Korean APIs (Naver, Kakao, TMAP) into LLM applications for search, maps, and directions.
    10
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    Korean-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

View all related MCP servers

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.

View all MCP Connectors

Latest Blog Posts

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