Naver Search MCP Server

Naver Search MCP Server

Naver 検索 API および DataLab（データラボ）API と連携する Model Context Protocol（MCP）サーバーです。
ウェブ、ニュース、ブログ、ショッピングインサイト、検索キーワードのトレンド分析、および自然言語によるショッピングカテゴリ検索に対応しています。

• 英語ドキュメント（README-en.md）

---

クイックセットアップ（Quick Start）

Claude Desktop、Cursor、Claude Code、Cline など、お使いの MCP クライアント設定ファイル（claude_desktop_config.json、mcp.json など）の mcpServers に、以下の設定を追加してください。

ご案内： Kakao PlayMCP 連携サービスのサポートは終了しました。ローカル環境で API キーを直接設定してご利用ください。

1. NAVER API HUB（推奨／新規発行）

Naver Cloud Platform（NCP）の NAVER API HUB キーを使用する場合：

{
  "mcpServers": {
    "naver-search": {
      "command": "npx",
      "args": ["-y", "@isnow890/naver-search-mcp"],
      "env": {
        "NCP_APIGW_API_KEY_ID": "your_client_id",
        "NCP_APIGW_API_KEY": "your_client_secret"
      }
    }
  }
}

2. Naver Developer Center（既存発行者専用）

既存の Naver Developer Center（openapi.naver.com）キーを使用する場合（2027-06-30 までサポート）：

{
  "mcpServers": {
    "naver-search": {
      "command": "npx",
      "args": ["-y", "@isnow890/naver-search-mcp"],
      "env": {
        "NAVER_CLIENT_ID": "your_client_id",
        "NAVER_CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}

3. OpenClaw（ClawHub）

OpenClaw を使用する場合、ClawHub スキルとしてすぐにインストールできます：

openclaw skills install naver-search-mcp

参考： OpenClaw 環境では、NAVER API HUB のペア（NCP_APIGW_API_KEY_ID / NCP_APIGW_API_KEY）または Developer Center のペア（NAVER_CLIENT_ID / NAVER_CLIENT_SECRET）のいずれか一方を設定する必要があります。

---

API キーの発行方法

使用する環境変数のペアに応じて、呼び出し先のプラットフォームが自動的に決まります。（いずれか一方のペアのみ設定してください）

プラットフォーム	環境変数	備考
NAVER API HUB（推奨）	NCP_APIGW_API_KEY_ID NCP_APIGW_API_KEY	• Naver Cloud Platform コンソール にアクセス • Menu > All Services > Application Services > NAVER API HUB > Application を登録後、「認証情報」を確認
Naver Developer Center（既存）	NAVER_CLIENT_ID NAVER_CLIENT_SECRET	• 2026-07-31 をもって新規発行を停止 • 既存の発行済みキーは 2027-06-30 まで正常に動作

---

提供ツール（Tools）

1. カテゴリ検索

• find_category：カテゴリ番号が分からなくても、自然言語で検索してショッピングインサイト用のカテゴリ ID を取得します。

2. 検索ツール（Search）

• search_webkr：ウェブ文書検索
• search_news：ニュース検索
• search_blog：ブログ検索
• search_cafearticle：カフェ記事検索
• search_image：画像検索
• search_kin：知識iN検索
• search_encyc：百科事典検索
• search_local：地域のスポット検索

3. DataLab トレンド分析（DataLab）

日付パラメーターでは "today" キーワードを使用できます（例：endDate: "today"）。

• datalab_search：検索キーワードのトレンド分析
• datalab_shopping_category：ショッピングカテゴリ別のクリックトレンド
• datalab_shopping_by_device：デバイス別（PC／モバイル）のショッピングトレンド
• 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：キーワードの年齢層別トレンド

---

ライセンス

MIT License