ネイバー検索MCPサーバー

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

概要

ブログ、ニュース、書籍、画像、ショッピングアイテムなどを検索
ページネーションをサポートする複数の検索カテゴリ
LLM の利用に最適化された構造化テキスト応答
アダルトコンテンツを確認する
キーボード入力エラーの変換（エラッタ）

設定

前提条件

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-search

UV設置

curl -LsSf https://astral.sh/uv/install.sh | sh

仮想環境を作成し、依存関係をインストールします。

uv venv -p 3.12
source .venv/bin/activate
pip install -r requirements.txt

Naver API 資格情報を使用して.envファイルを作成します。

cp env.example .env
vi .env

NAVER_CLIENT_ID=your_client_id_here
NAVER_CLIENT_SECRET=your_client_secret_here

Dockerの使用

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

docker build -t py-mcp-naver-search .

コンテナを実行します。

docker run py-mcp-naver-search

ローカルの使用

サーバーを実行します。

mcp run server.py

MCP設定を構成する

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&A
local - 地元のビジネス情報
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 ファイルを参照してください。

Integrations