Naver Search MCP Server

by isnow890

77 stars

720 downloads

Not rated

GitHub Website

About

MCP server for Naver Search API integration. Provides comprehensive search capabilities across Naver services (web, news, blog, shopping, etc) and data trend analysis tools via DataLab API.

Details

Author: isnow890
GitHub stars: 77
Downloads: 720
Categories: Search, Knowledge Base, Other

- 11 search tools covering web, news, blog, cafe, shopping, image, KnowledgeiN, book, encyclopedia, academic, local.
- 8 DataLab tools for search term and shopping trends by category, device, gender, and age.
- Category search tool (find_category) with fuzzy matching.
- “today” keyword support for all DataLab date parameters.
- Runs via NPX, ClawHub, or local installation.
- Open source under MIT License.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Naver Search MCP Server

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "naver search mcp server": {
            "naver-search-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@isnow890/naver-search-mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "naver search mcp server": {
            "naver-search-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@isnow890/naver-search-mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "naver search mcp server": {
            "naver-search-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@isnow890/naver-search-mcp"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "naver search mcp server": {
            "naver-search-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@isnow890/naver-search-mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "naver search mcp server": {
            "naver-search-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@isnow890/naver-search-mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "naver search mcp server": {
            "naver-search-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@isnow890/naver-search-mcp"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "naver search mcp server": {
            "naver-search-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@isnow890/naver-search-mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "naver search mcp server": {
            "naver-search-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@isnow890/naver-search-mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "naver search mcp server": {
            "naver-search-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@isnow890/naver-search-mcp"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "naver search mcp server": {
            "naver-search-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@isnow890/naver-search-mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "naver search mcp server": {
            "naver-search-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@isnow890/naver-search-mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "naver search mcp server": {
            "naver-search-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@isnow890/naver-search-mcp"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "naver search mcp server": {
            "naver-search-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@isnow890/naver-search-mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "naver search mcp server": {
            "naver-search-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@isnow890/naver-search-mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "naver search mcp server": {
            "naver-search-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@isnow890/naver-search-mcp"
                ]
            }
        }
    }
}

From the repository

Install via NPX (recommended) with npx -y @isnow890/naver-search-mcp and configure environment variables NAVER_CLIENT_ID and NAVER_CLIENT_SECRET in your MCP client’s settings. Alternatively, install from ClawHub for OpenClaw or clone the source and build locally. You can also use it immediately without API keys through Kakao PlayMCP.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "naver search mcp server": {
            "naver-search-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@isnow890/naver-search-mcp"
                ]
            }
        }
    }
}

McpServers

{
    "naver-search-mcp": {
        "command": "npx",
        "args": [
            "-y",
            "@isnow890/naver-search-mcp"
        ]
    }
}

MCP server for Naver Search API and DataLab API integration, enabling comprehensive search across various Naver services and data trend analysis.

⚠️ Naver is migrating these APIs — read this before you set up

Naver is moving Search, Search Trend, and Shopping Insight from the Naver Developers Center toNAVER API HUBon NAVER Cloud Platform, and is shutting down three search APIs entirely.

Source:Naver Developers Center official notice(Korean) — "Search API, Search Trend, Shopping Insight 서비스 종료 및 NAVER API HUB 이관 안내".

Setting this up for the first time?Get your keys from NAVER API HUB. The Developers Center path closes to new applicants on 2026-07-31, so it is no longer the place to start. Step-by-step instructions are in Option A: NAVER API HUBbelow.

Already running with Developers Center keys?Nothing to change. They keep working until 2027-06-30, and this version supports both platforms from the same install. When you're ready, get a HUB key and swap the two environment variables — no other changes.

Support plan for this server:both platforms stay supported side by side through Naver's 2027-06-30 cutoff. The Developers Center path will be dropped in a later major version only after that date, once it can no longer work for anyone — so upgrading in the meantime will never take your working setup away.

Three tools were removed in 1.0.49:search_shop,search_book,search_academic. Naver shuts those search APIs down on 2026-07-31 with no replacement on any platform, so there is nothing this server can do to keep them. ShoppingInsight(datalab_shopping_) andfind_categoryare adifferentAPI and arenotaffected.

You can install this MCP server as an OpenClaw skill from ClawHub:

openclaw skills install naver-search-mcp

The ClawHub skill uses the published npm package internally and needsonecredential pair in your OpenClaw environment — either the NAVER API HUB pair (NCP_APIGW_API_KEY_ID/NCP_APIGW_API_KEY) or the Developers Center pair (NAVER_CLIENT_ID/NAVER_CLIENT_SECRET). OpenClaw'sapiKeyfield maps toNAVER_CLIENT_SECRET; HUB users should set both HUB variables explicitly in the environment instead of usingapiKey.
You can use this server immediately without API keys through Kakao PlayMCP. Simply visit the link and start using it right away!

- find_category: Category search tool so you no longer need to manually check category numbers in URLs for trend and shopping insight searches. Just describe the category in natural language.

- search_webkr: Search Naver web documents
- search_news: Search Naver news
- search_blog: Search Naver blogs
- search_cafearticle: Search Naver cafe articles
- search_image: Search Naver images
- search_kin: Search Naver KnowledgeiN
- search_encyc: Search Naver encyclopedia
- search_local: Search Naver local places

Removed in 1.0.49:search_shop,search_book,search_academic. Naver shuts down the Shopping / Book / Academic search APIs on 2026-07-31 with no replacement on any platform. This is not a limitation of this server. ShoppingInsight(datalab_shopping_) is a different API and is unaffected.

- datalab_search: Analyze search term trends
- datalab_shopping_category: Analyze shopping category trends
- datalab_shopping_by_device: Analyze shopping trends by device
- datalab_shopping_by_gender: Analyze shopping trends by gender
- datalab_shopping_by_age: Analyze shopping trends by age group
- datalab_shopping_keywords: Analyze shopping keyword trends
- datalab_shopping_keyword_by_device: Analyze shopping keyword trends by device
- datalab_shopping_keyword_by_gender: Analyze shopping keyword trends by gender
- datalab_shopping_keyword_by_age: Analyze shopping keyword trends by age group

Two platforms issue keys for this server. Setonepair of environment variables — see Configurationbelow for how the pair you set determines the platform used.

Option A: NAVER API HUB (recommended — the forward path)

- Go to the NAVER Cloud Platform consoleand sign up or log in. - Click the region & platform selector in the top right of the console, choose your region/platform, and clickApply. - OpenMenu > All Services > Application Services >NAVER API HUB. - ClickApplication, select (or create) your application, then under API management click인증 정보 (Authentication Info). - Copy theClient IDandClient Secretshown in the popup. - Use these asNCP_APIGW_API_KEY_ID(Client ID) andNCP_APIGW_API_KEY(Client Secret) in the configuration below.

Option B: Naver Developers (legacy — existing keys only)

Naver Developers Center stops accepting new applications on2026-07-31. If you don't already have a Client ID/Secret from this platform, use NAVER API HUB above instead. Existing Developers Center keys keep working until 2027-06-30.
- Visit Naver Developersand log in with your Naver account
- Click the "Application Registration" (애플리케이션 등록) button
- Fill in the application information:

- Application Name: Enter any name (e.g., "Naver Search MCP")
- Usage: Select "Search" (검색)

- Search(검색) - Required for blog, news, cafe article, web, image, kin, encyclopedia, and local search
- DataLab - Search Trends(데이터랩 - 검색어 트렌드) - Required for search term trend analysis
- DataLab - Shopping Insight(데이터랩 - 쇼핑인사이트) - Required for shopping trend analysis

Two platforms are supported. Setonepair — the server picks the platform from which variables you set, since the key strings themselves are indistinguishable.

If both pairs are set, NAVER API HUB wins.

The installation examples below use the legacyNAVER_CLIENT_ID/NAVER_CLIENT_SECRETpair; swap in the HUB pair from the table above if that's what you have.

Naver is moving these APIs from the Developers Center to NAVER API HUB on NAVER Cloud Platform.

Existing keys keep working until 2027-06-30. To migrate, get a key from the NAVER Cloud Platform console and setNCP_APIGW_API_KEY_ID/NCP_APIGW_API_KEY. Developers Center keys cannot be used against NAVER API HUB.

Method 1: NPX Installation (Recommended)

The most reliable way to use this MCP server is through NPX. For detailed package information, see the NPM package page.

Add to Claude Desktop config file (%APPDATA%\Claude\claude_desktop_config.jsonon Windows,~/Library/Application Support/Claude/claude_desktop_config.jsonon macOS/Linux):

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

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

Method 2: ClawHub Installation for OpenClaw

This MCP server can also be used from OpenClaw through the ClawHub skill wrapper. Install it with:

openclaw skills install naver-search-mcp

The ClawHub skill uses the same published npm package internally:

Make sureonecredential pair is configured in your OpenClaw environment before using the skill — the NAVER API HUB pair (NCP_APIGW_API_KEY_ID/NCP_APIGW_API_KEY) or the Developers Center pair (NAVER_CLIENT_ID/NAVER_CLIENT_SECRET). OpenClaw'sapiKeyfield maps toNAVER_CLIENT_SECRET; HUB users should set both HUB variables explicitly instead.

For local development or custom modifications:

git clone https://github.com/isnow890/naver-search-mcp.git cd naver-search-mcp npm install npm run build

- Download the latest version fromGitHub Releases
- Extract the ZIP file to your desired location
- Navigate to the extracted folder in terminal:

cd /path/to/naver-search-mcp npm install npm run build

⚠️Important: You must runnpm run buildafter installation to generate thedistfolder that contains the compiled JavaScript files.

After building, you'll need the following information:

- NAVER_CLIENT_ID: Client ID from Naver Developers
- NAVER_CLIENT_SECRET: Client Secret from Naver Developers
- Installation Path: Absolute path to the downloaded folder

Add to Claude Desktop config file (%APPDATA%\Claude\claude_desktop_config.json):

{ "mcpServers": { "naver-search": { "type": "stdio", "command": "cmd", "args": [ "/c", "node", "C:\\path\\to\\naver-search-mcp\\dist\\src\\index.js" ], "cwd": "C:\\path\\to\\naver-search-mcp", "env": { "NAVER_CLIENT_ID": "your-naver-client-id", "NAVER_CLIENT_SECRET": "your-naver-client-secret" } } } }

Add to Claude Desktop config file (~/Library/Application Support/Claude/claude_desktop_config.json):

{ "mcpServers": { "naver-search": { "type": "stdio", "command": "node", "args": ["/path/to/naver-search-mcp/dist/src/index.js"], "cwd": "/path/to/naver-search-mcp", "env": { "NAVER_CLIENT_ID": "your-naver-client-id", "NAVER_CLIENT_SECRET": "your-naver-client-secret" } } } }

⚠️Important: You must change the following paths in the above configuration to your actual installation paths:

- Windows: ChangeC:\\path\\to\\naver-search-mcpto your actual downloaded folder path
- macOS/Linux: Change/path/to/naver-search-mcpto your actual downloaded folder path
- Build Path: Make sure the path points todist/src/index.js(not justindex.js)

# Check current location pwd # Absolute path examples # Windows: C:\Users\username\Downloads\naver-search-mcp # macOS: /Users/username/Downloads/naver-search-mcp # Linux: /home/username/Downloads/naver-search-mcp

After completing the configuration, completely close and restart Claude Desktop to activate the Naver Search MCP server.

- A credential pair for one platform — NAVER API HUB or Naver Developers (seeGetting API Keys)
- Node.js 18 or higher
- NPM 8 or higher

- NAVER API HUB support: setNCP_APIGW_API_KEY_ID/NCP_APIGW_API_KEYto call the new platform. ExistingNAVER_CLIENT_ID/NAVER_CLIENT_SECRETkeep working unchanged — the platform is chosen by which variable pair you set
- Removedsearch_shop,search_book,search_academic. Naver shuts those search APIs down on 2026-07-31 with no replacement on any platform
- API errors now throw a plainErrorinstead of the rawAxiosError. Code branching onerror.response?.statusseesundefined; the same detail is inError.message
- Error messages name the platform and HTTP status, and 401s suggest checking whether a key was set on the other platform's variables

- Fixedfind_categorydata loading when the MCP server is launched bynpxfrom a different working directory
- Category data is now resolved relative to the installed package before falling back to local development paths

- Added "today" keyword supportfor all DataLab date parameters - no need to call separate time tool
- Fixed server termination issue- MCP server now properly exits when client disconnects
- Added graceful shutdown handlersfor SIGINT, SIGTERM, and transport close events
- Removed get_current_korean_time tool- redundant with new "today" keyword feature
- Removed memory monitoring module- resolved setInterval blocking process exit
- Special thanks to @gloomyrobotfor reporting the server termination issue

- Resolved platform compatibility issues for hosted MCP installations
- Replaced the Excel export in category search with JSON for better compatibility
- Restored thesearch_webkrtool for Korean web search
- Improved hosted platform installation compatibility

- Added theget_current_korean_timetool for essential Korea Standard Time context
- Referenced the time tool across existing tool descriptions for temporal queries
- Improved handling of "today", "now", and "current" searches with temporal context
- Expanded Korean date and time formatting outputs with multiple formats

- Added thefind_categorytool with fuzzy matching so you no longer need to check category numbers manually in URLs
- Enhanced parameter validation with Zod schema
- Improved the category search workflow
- Implemented a level-based category ranking system that prioritizes top-level categories

- MCP SDK upgraded to 1.17.1
- Fixed compatibility issues with hosted MCP platform specification changes
- Added comprehensive DataLab shopping category code documentation

- README updated: cafe article search tool and version history section improved

- Cafe article search feature added
- Shopping category info added to zod
- Source code refactored

Search global news using natural language. Webz.io News Search API returns the most relevant articles and content, with filters for source, country, language, date, sentiment, and category.

Fetch, convert, and search AWS documentation pages, with recommendations for related content.

Search campgrounds around the world on campertunity, check availability, and provide booking links.

The Ferryhopper MCP Server exposes ferry routes, schedules and booking redirects so an AI assistant can discover connections across Europe and the Mediterranean and send users to Ferryhopper to complete bookings.

All-in-One SEO & Web Intelligence Toolkit API from FetchSERP.

MCP server that provides read-only access to HyperKitty, the web-based email archive component of Mailman 3.

At Sunrise Apps, we believe AI agents should be limitless, especially when it comes to visual data. We created ImageSorcery to bridge the critical gap in AI's ability to interact with and manipulate images directly, all while upholding the highest standards of privacy and security.

Just Domain is the domain registrar for businesses built with AI. Its remote MCP server checks availability and returns first-year and renewal pricing, plus a link to register on justdomain.ai, with DNS and WHOIS privacy in the same place. No account, no API key, read only. Endpoint: https://mcp.justdomain.ai/

Research tools, including a Sqlite-backed document stash

Semantic search over 9 free-license stock photo sources. Hosted remote server with OAuth — no API key to paste.

SerpApi MCP Server for Google and other search engine results

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

⚠️ Naver is migrating these APIs — read this before you set up

Option A: NAVER API HUB (recommended — the forward path)

Option B: Naver Developers (legacy — existing keys only)

Method 1: NPX Installation (Recommended)

Method 2: ClawHub Installation for OpenClaw

Install

More like this

Sequential Thinking

Aws Kb Retrieval Server

Memory

Brave Search

Filesystem

EverArt