ネイバー検索MCPサーバー
このMCP（マルチプラットフォーム通信プロトコル）サーバーは、Naver検索APIへのアクセスを提供し、AIエージェントがNaver上のさまざまなタイプのコンテンツを検索できるようにします。
概要
- ブログ、ニュース、書籍、画像、ショッピングアイテムなどを検索
- ページネーションをサポートする複数の検索カテゴリ
- LLM の利用に最適化された構造化テキスト応答
- アダルトコンテンツを確認する
- キーボード入力エラーの変換（エラッタ）
目次
設定
前提条件
- Python 3.12以上
- Naver 開発者 API 認証情報
インストール
- リポジトリをクローンします。
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設定を構成する
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 ファイルを参照してください。