ネイバー検索MCPサーバー
Naver Search APIとDataLab APIを統合したMCPサーバーで、Naverのさまざまなサービスにわたる包括的な検索とデータ傾向分析を可能にします。
バージョン履歴
1.0.2 (2025年4月26日)- README を更新しました: カフェ記事検索ツールとバージョン履歴セクションが改善されました
1.0.1 (2025年4月26日)- カフェ記事検索機能を追加しました
- ショッピングカテゴリ情報がzodに追加されました
- ソースコードのリファクタリング
1.0.0 (2025年4月8日)情報
npm経由でMCPをインストールする場合、@mseep/server-naver-search ( https://www.npmjs.com/package/@mseep/server-naver-search )は使用しないでください。このパッケージは私の著作物のコピーであり、許可なく公開されています。このパッケージのnpxバージョンも壊れており、正常に動作しません。代わりにこちらの公式パッケージをご利用ください。
前提条件
- Naver Developers APIキー（クライアントIDとシークレット）
- Node.js 18以上
- NPM 8以上
- Docker（オプション、コンテナのデプロイメント用）
APIキーの取得
- Naver Developersにアクセス
- 「アプリケーションを登録」をクリックします
- アプリケーション名を入力し、次の API をすべて選択します。
- 検索（ブログ、ニュース、書籍検索など）
- DataLab（検索トレンド）
- DataLab（ショッピングインサイト）
- 取得したクライアントIDとクライアントシークレットを環境変数として設定します
ツールの詳細
利用可能なツール:
- search_webkr : Naverウェブドキュメントを検索
- search_news : ネイバーニュースを検索
- search_blog : ネイバーブログを検索
- search_cafearticle : ネイバーカフェの記事を検索
- search_shop : ネイバーショッピングを検索
- search_image : Naver画像を検索
- search_kin : Naver KnowledgeiNで検索
- search_book : ネイバーの書籍を検索
- search_encyc : Naver百科事典を検索
- search_academic : Naverの学術論文を検索
- search_local : Naverのローカルスポットを検索
- datalab_search : 検索語の傾向を分析する
- datalab_shopping_category : ショッピングカテゴリーのトレンドを分析する
- datalab_shopping_by_device : デバイス別のショッピング傾向を分析する
- datalab_shopping_by_gender : 性別別のショッピング傾向を分析する
- datalab_shopping_by_age : 年齢層別にショッピング傾向を分析する
- datalab_shopping_keywords : ショッピングキーワードのトレンドを分析する
- datalab_shopping_keyword_by_device : デバイス別にショッピングキーワードのトレンドを分析する
- datalab_shopping_keyword_by_gender : 性別別にショッピングキーワードのトレンドを分析
- datalab_shopping_keyword_by_age : 年齢層別にショッピングキーワードのトレンドを分析
インストール
オプション 1: Smithery 経由のクイックインストール (推奨)
Smithery 経由で Naver Search MCP Server を自動的にインストールするには、AI クライアントに基づいて次のいずれかのコマンドを使用します。
Claude Desktopの場合:
npx -y @smithery/cli@latest install @isnow890/naver-search-mcp --client claude
カーソルの場合:
npx -y @smithery/cli@latest install @isnow890/naver-search-mcp --client cursor
ウィンドサーフィンの場合:
npx -y @smithery/cli@latest install @isnow890/naver-search-mcp --client windsurf
クラインの場合:
npx -y @smithery/cli@latest install @isnow890/naver-search-mcp --client cline
インストーラーは次のことを要求します:
- NAVER_クライアントID
- ネイバークライアントシークレット
オプション2: 手動インストール
環境変数
# Windows
set NAVER_CLIENT_ID=your_client_id
set NAVER_CLIENT_SECRET=your_client_secret
# Linux/Mac
export NAVER_CLIENT_ID=your_client_id
export NAVER_CLIENT_SECRET=your_client_secret
NPXで実行
npx @isnow890/naver-search-mcp
Dockerで実行
docker run -i --rm \
-e NAVER_CLIENT_ID=your_client_id \
-e NAVER_CLIENT_SECRET=your_client_secret \
mcp/naver-search
クロードデスクトップ構成
claude_desktop_config.jsonに追加:
{
"mcpServers": {
"naver-search": {
"command": "npx",
"args": ["-y", "@isnow890/naver-search-mcp"],
"env": {
"NAVER_CLIENT_ID": "your_client_id",
"NAVER_CLIENT_SECRET": "your_client_secret"
}
}
}
}
カーソルAI設定
mcp.jsonに追加:
{
"mcpServers": {
"naver-search": {
"command": "npx",
"args": ["-y", "@isnow890/naver-search-mcp"],
"env": {
"NAVER_CLIENT_ID": "your_client_id",
"NAVER_CLIENT_SECRET": "your_client_secret"
}
}
}
}
Dockerの場合:
{
"mcpServers": {
"naver-search": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"NAVER_CLIENT_ID=your_client_id",
"-e",
"NAVER_CLIENT_SECRET=your_client_secret",
"mcp/naver-search"
]
}
}
}
建てる
Dockerビルド:
docker build -t mcp/naver-search .
ライセンス
MITライセンス