Naver Search
STDIONaver Search API integration for comprehensive search and data trend analysis.
Naver Search API integration for comprehensive search and data trend analysis.
MCP server for Naver Search API and DataLab API integration, enabling comprehensive search across various Naver services and data trend analysis.
search_webkr tool for Korean web searchget_current_korean_time tool for essential Korea Standard Time contextfind_category tool with fuzzy matching so you no longer need to check category numbers manually in URLsFor a complete list of category codes, you can download from Naver Shopping Partner Center or extract them by browsing Naver Shopping categories.
// Fashion trend discovery find_category("fashion") → Check top fashion categories and codes datalab_shopping_category → Analyze seasonal fashion trends datalab_shopping_age → Identify fashion target demographics datalab_shopping_keywords → Compare "dress" vs "jacket" vs "coat"
// Beauty industry analysis find_category("cosmetics") → Find beauty categories datalab_shopping_gender → 95% female vs 5% male shoppers datalab_shopping_device → Mobile dominance in beauty shopping datalab_shopping_keywords → "tint" vs "lipstick" keyword performance
// Tech product insights find_category("smartphone") → Check electronics categories datalab_shopping_category → Track iPhone vs Galaxy trends datalab_shopping_age → 20-30s as main smartphone buyers datalab_shopping_device → PC vs mobile shopping behavior
// Holiday shopping analysis find_category("gift") → Gift categories datalab_shopping_category → Black Friday, Christmas trends datalab_shopping_keywords → "Mother's Day gift" vs "birthday gift" datalab_shopping_age → Age-based gift purchasing patterns
// Fitness market analysis find_category("exercise") → Sports/fitness categories datalab_shopping_gender → Male vs female fitness spending datalab_shopping_age → Primary fitness demographics (20-40s) datalab_shopping_keywords → "home workout" vs "gym" trend analysis
find_category to explore market segments| Category | Code | Korean |
|---|---|---|
| Fashion/Clothing | 50000000 | 패션의류 |
| Cosmetics/Beauty | 50000002 | 화장품/미용 |
| Digital/Electronics | 50000003 | 디지털/가전 |
| Sports/Leisure | 50000004 | 스포츠/레저 |
| Food/Beverages | 50000008 | 식품/음료 |
| Health/Medical | 50000009 | 건강/의료용품 |
💡 Tip: Use find_category with fuzzy searches like "beauty", "fashion", "electronics" to easily find categories.
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.json on Windows, ~/Library/Application Support/Claude/claude_desktop_config.json on 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" } } } }
Add to 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" } } } }
⚠️ Important Notice: Smithery installations can run into connection timeouts and freezes because of issues in the Smithery WebSocket relay infrastructure. This is a known platform limitation rather than a bug in this MCP server. For stable usage, we strongly recommend sticking with Method 1 (NPX installation).
Error -32001: Request timed out can appearIf you still want to try Smithery:
npx -y @smithery/cli@latest install @isnow890/naver-search-mcp --client claude
# Cursor npx -y @smithery/cli@latest install @isnow890/naver-search-mcp --client cursor # Windsurf npx -y @smithery/cli@latest install @isnow890/naver-search-mcp --client windsurf # Cline npx -y @smithery/cli@latest install @isnow890/naver-search-mcp --client cline
If you encounter timeouts on Smithery, switch back to Method 1 (NPX) for a stable experience.
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
cd /path/to/naver-search-mcp npm install npm run build
⚠️ Important: You must run npm run build after installation to generate the dist folder that contains the compiled JavaScript files.
After building, you'll need the following information:
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:
C:\\path\\to\\naver-search-mcp to your actual downloaded folder path/path/to/naver-search-mcp to your actual downloaded folder pathdist/src/index.js (not just index.js)Finding your path:
# 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.
For containerized deployment:
docker run -i --rm \ -e NAVER_CLIENT_ID=your_client_id \ -e NAVER_CLIENT_SECRET=your_client_secret \ mcp/naver-search
Docker configuration for Claude Desktop:
{ "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 build:
docker build -t mcp/naver-search .
MIT License