@isnow890/naver-search-mcp 1.0.40 → 1.0.41

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025 isnow890
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE. 
+MIT License
+
+Copyright (c) 2025 isnow890
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE. 

package/README.md

@@ -1,455 +1,448 @@
-# Naver Search MCP Server
-
-[![한국어](https://img.shields.io/badge/한국어-README-yellow)](README-ko.md)
-
-[![Trust Score](https://archestra.ai/mcp-catalog/api/badge/quality/isnow890/naver-search-mcp)](https://archestra.ai/mcp-catalog/isnow890__naver-search-mcp)
-[![smithery badge](https://smithery.ai/badge/@isnow890/naver-search-mcp)](https://smithery.ai/server/@isnow890/naver-search-mcp)
-[![MCP.so](https://img.shields.io/badge/MCP.so-Naver%20Search%20MCP-blue)](https://mcp.so/server/naver-search-mcp/isnow890)
-
-MCP server for Naver Search API and DataLab API integration, enabling comprehensive search across various Naver services and data trend analysis.
-
-> ⚠️ **Smithery Installation Notice**: Due to compatibility issues with the Smithery platform, **direct installation is recommended starting from version 1.0.40**. Smithery installation is only supported up to version 1.0.30.
-
-#### Version History
-
-###### 1.0.4 (2025-08-21)
-
-- `find_category` tool added - with fuzzy matching and ranking system support
-- Enhanced parameter validation with Zod schema
-- Improved category search workflow
-- Implemented level-based category ranking system (major categories prioritized)
-
-###### 1.0.30 (2025-08-04)
-
-- MCP SDK upgraded to 1.17.1
-- Fixed compatibility issues with Smithery specification changes
-- Added comprehensive DataLab shopping category code documentation
-
-###### 1.0.2 (2025-04-26)
-
-- README updated: cafe article search tool and version history section improved
-
-###### 1.0.1 (2025-04-26)
-
-- Cafe article search feature added
-- Shopping category info added to zod
-- Source code refactored
-
-###### 1.0.0 (2025-04-08)
-
-- Initial release
-
-#### Information
-
-**If you want to install the MCP via npm, do NOT use @mseep/server-naver-search (https://www.npmjs.com/package/@mseep/server-naver-search). That package is a copy of my work and was published without my permission. The npx version of that package is also broken and will not work properly. Please use this official package instead.**
-
-#### Prerequisites
-
-- Naver Developers API Key (Client ID and Secret)
-- Node.js 18 or higher
-- NPM 8 or higher
-- Docker (optional, for container deployment)
-
-#### Getting API Keys
-
-1. Visit [Naver Developers](https://developers.naver.com/apps/#/register)
-2. Click "Register Application"
-3. Enter application name and select ALL of the following APIs:
-   - Search (for blog, news, book search, etc.)
-   - DataLab (Search Trends)
-   - DataLab (Shopping Insight)
-4. Set the obtained Client ID and Client Secret as environment variables
-
-## Tool Details
-
-### Available tools:
-
-#### 🆕 Category Search
-
-- **find_category**: Category search tool - No more need to manually check category numbers via URL for trend and shopping insight searches.
-
-#### Search Tools
-
-- **search_webkr**: Search Naver web documents
-- **search_news**: Search Naver news
-- **search_blog**: Search Naver blogs
-- **search_cafearticle**: Search Naver cafe articles
-- **search_shop**: Search Naver shopping
-- **search_image**: Search Naver images
-- **search_kin**: Search Naver KnowledgeiN
-- **search_book**: Search Naver books
-- **search_encyc**: Search Naver encyclopedia
-- **search_academic**: Search Naver academic papers
-- **search_local**: Search Naver local places
-
-#### DataLab Tools
-
-- **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
-
-### DataLab Shopping Category Codes
-
-For DataLab shopping analysis tools, you need to use specific **8-digit category codes**. Here are some common examples:
-
-#### Popular Category Codes:
-
-- **50000000**: Fashion/Clothing (패션의류)
-- **50000002**: Cosmetics/Beauty (화장품/미용)
-- **50000003**: Digital/Home Appliances (디지털/가전)
-- **50000004**: Sports/Leisure (스포츠/레저)
-- **50000005**: Automotive/Tools (자동차/공구)
-- **50000006**: Books/Music/DVDs (도서/음반/DVD)
-- **50000007**: Toys/Hobbies (완구/취미)
-- **50000008**: Food/Beverages (식품/음료)
-- **50000009**: Health/Medical (건강/의료용품)
-- **50000010**: Household/Living (생활/주방용품)
-
-#### How to Find Category Codes:
-
-1. Visit [Naver Shopping](https://shopping.naver.com)
-2. Navigate to desired category
-3. Check the `cat_id` parameter in the URL
-4. Use the 8-digit code (e.g., `cat_id=50000000` → use `"50000000"`)
-
-#### Usage Example:
-
-When using shopping category tools, specify category like:
-
-```json
-{
-  "category": "50000000",
-  "startDate": "2024-01-01",
-  "endDate": "2024-01-31",
-  "timeUnit": "month"
-}
-```
-
-#### Complete Category List:
-
-For a complete list of category codes, you can download from Naver Shopping Partner Center or extract them by browsing Naver Shopping categories.
-
-### 🎯 Business Use Cases & Scenarios
-
-#### 🛍️ E-commerce Market Research
-
-```javascript
-// 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"
-```
-
-#### 📱 Digital Marketing Strategy
-
-```javascript
-// 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
-```
-
-#### 🏢 Business Intelligence & Competitive Analysis
-
-```javascript
-// 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
-```
-
-#### 📊 Seasonal Business Planning
-
-```javascript
-// 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
-```
-
-#### 🎯 Customer Persona Development
-
-```javascript
-// 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
-```
-
-### 📈 Advanced Analysis Scenarios
-
-#### Market Entry Strategy
-
-1. **Category Discovery**: Use `find_category` to explore market segments
-2. **Trend Analysis**: Identify growing vs declining categories
-3. **Demographic Targeting**: Age/gender analysis for customer targeting
-4. **Competitive Intelligence**: Keyword performance comparison
-5. **Device Strategy**: Mobile vs PC shopping optimization
-
-#### Product Launch Planning
-
-1. **Market Validation**: Category growth trends and seasonality
-2. **Target Customers**: Demographic analysis for product positioning
-3. **Marketing Channels**: Device preferences for advertising strategy
-4. **Competitive Landscape**: Keyword competition and opportunities
-5. **Pricing Strategy**: Category performance and price correlation
-
-#### Performance Monitoring
-
-1. **Category Health**: Monitor product category trends
-2. **Keyword Tracking**: Track brand and product keyword performance
-3. **Demographic Shifts**: Monitor changing customer demographics
-4. **Seasonal Patterns**: Plan inventory and marketing campaigns
-5. **Competitive Benchmarking**: Compare performance against category averages
-
-### Quick Reference: Popular Category Codes
-
-| 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.
-
-## Installation
-
-### Step 1: Download Source Code
-
-To use this MCP server, you need to download the source code first:
-
-#### Clone with Git
-
-```bash
-git clone https://github.com/isnow890/naver-search-mcp.git
-cd naver-search-mcp
-npm install
-npm run build
-```
-
-#### Or Download ZIP File
-
-1. Download the latest version from [GitHub Releases](https://github.com/isnow890/naver-search-mcp/releases)
-2. Extract the ZIP file to your desired location
-3. Navigate to the extracted folder in terminal:
-
-```bash
-cd /path/to/naver-search-mcp
-npm install
-npm run build
-```
-
-### Step 2: Claude Desktop Configuration
-
-After installation, 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
-
-#### Windows Configuration
-
-Add to Claude Desktop config file (`%APPDATA%\Claude\claude_desktop_config.json`):
-
-```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"
-      }
-    }
-  }
-}
-```
-
-#### macOS/Linux Configuration
-
-Add to Claude Desktop config file (`~/Library/Application Support/Claude/claude_desktop_config.json`):
-
-```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"
-      }
-    }
-  }
-}
-```
-
-### Step 3: Path Configuration Important Notes
-
-⚠️ **Important**: You must change the following paths in the above configuration to your actual installation paths:
-
-- **Windows**: Change `C:\\path\\to\\naver-search-mcp` to your actual downloaded folder path
-- **macOS/Linux**: Change `/path/to/naver-search-mcp` to your actual downloaded folder path
-
-Finding your path:
-
-```bash
-# 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
-```
-
-### Step 4: Restart Claude Desktop
-
-After completing the configuration, completely close and restart Claude Desktop to activate the Naver Search MCP server.
-
----
-
-## Alternative Installation Methods
-
-### Option 2: NPX Installation (For v1.0.30 and below)
-
-For older versions that support NPX installation:
-
-#### Environment Variables
-
-```bash
-# 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
-```
-
-#### Claude Desktop Configuration for NPX
-
-Add to `claude_desktop_config.json`:
-
-```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"
-      }
-    }
-  }
-}
-```
-
-#### Cursor AI Configuration for NPX
-
-Add to `mcp.json`:
-
-```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"
-      }
-    }
-  }
-}
-```
-
-### Option 3: Legacy Smithery Installation (Only for v1.0.30 and below)
-
-⚠️ **Note**: This method only works for versions 1.0.30 and below due to platform compatibility issues.
-
-#### For Claude Desktop:
-```bash
-npx -y @smithery/cli@latest install @isnow890/naver-search-mcp --client claude
-```
-
-#### For other AI clients:
-```bash
-# 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
-```
-
-### Option 4: Docker Installation
-
-For containerized deployment:
-
-```bash
-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:
-
-```json
-{
-  "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"
-      ]
-    }
-  }
-}
-```
-
-## Build
-
-Docker build:
-
-```bash
-docker build -t mcp/naver-search .
-```
-
-## License
-
-MIT License
+# Naver Search MCP Server
+
+[![한국어](https://img.shields.io/badge/한국어-README-yellow)](README-ko.md)
+
+[![Trust Score](https://archestra.ai/mcp-catalog/api/badge/quality/isnow890/naver-search-mcp)](https://archestra.ai/mcp-catalog/isnow890__naver-search-mcp)
+[![smithery badge](https://smithery.ai/badge/@isnow890/naver-search-mcp)](https://smithery.ai/server/@isnow890/naver-search-mcp)
+[![MCP.so](https://img.shields.io/badge/MCP.so-Naver%20Search%20MCP-blue)](https://mcp.so/server/naver-search-mcp/isnow890)
+
+MCP server for Naver Search API and DataLab API integration, enabling comprehensive search across various Naver services and data trend analysis.
+
+> ⚠️ **Smithery Installation Notice**: Due to compatibility issues with the Smithery platform, **direct installation is recommended starting from version 1.0.40**. Smithery installation is only supported up to version 1.0.30.
+
+#### Version History
+
+###### 1.0.4 (2025-08-21)
+
+- `find_category` tool added - with fuzzy matching and ranking system support
+- Enhanced parameter validation with Zod schema
+- Improved category search workflow
+- Implemented level-based category ranking system (major categories prioritized)
+
+###### 1.0.30 (2025-08-04)
+
+- MCP SDK upgraded to 1.17.1
+- Fixed compatibility issues with Smithery specification changes
+- Added comprehensive DataLab shopping category code documentation
+
+###### 1.0.2 (2025-04-26)
+
+- README updated: cafe article search tool and version history section improved
+
+###### 1.0.1 (2025-04-26)
+
+- Cafe article search feature added
+- Shopping category info added to zod
+- Source code refactored
+
+###### 1.0.0 (2025-04-08)
+
+- Initial release
+
+#### Information
+
+**If you want to install the MCP via npm, do NOT use @mseep/server-naver-search (https://www.npmjs.com/package/@mseep/server-naver-search). That package is a copy of my work and was published without my permission. The npx version of that package is also broken and will not work properly. Please use this official package instead.**
+
+#### Prerequisites
+
+- Naver Developers API Key (Client ID and Secret)
+- Node.js 18 or higher
+- NPM 8 or higher
+- Docker (optional, for container deployment)
+
+#### Getting API Keys
+
+1. Visit [Naver Developers](https://developers.naver.com/apps/#/register)
+2. Click "Register Application"
+3. Enter application name and select ALL of the following APIs:
+   - Search (for blog, news, book search, etc.)
+   - DataLab (Search Trends)
+   - DataLab (Shopping Insight)
+4. Set the obtained Client ID and Client Secret as environment variables
+
+## Tool Details
+
+### Available tools:
+
+#### 🆕 Category Search
+
+- **find_category**: Category search tool - No more need to manually check category numbers via URL for trend and shopping insight searches.
+
+#### Search Tools
+
+- **search_webkr**: Search Naver web documents
+- **search_news**: Search Naver news
+- **search_blog**: Search Naver blogs
+- **search_cafearticle**: Search Naver cafe articles
+- **search_shop**: Search Naver shopping
+- **search_image**: Search Naver images
+- **search_kin**: Search Naver KnowledgeiN
+- **search_book**: Search Naver books
+- **search_encyc**: Search Naver encyclopedia
+- **search_academic**: Search Naver academic papers
+- **search_local**: Search Naver local places
+
+#### DataLab Tools
+
+- **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
+
+### DataLab Shopping Category Codes
+
+For DataLab shopping analysis tools, you need to use specific **8-digit category codes**. Here are some common examples:
+
+#### Popular Category Codes:
+
+- **50000000**: Fashion/Clothing (패션의류)
+- **50000002**: Cosmetics/Beauty (화장품/미용)
+- **50000003**: Digital/Home Appliances (디지털/가전)
+- **50000004**: Sports/Leisure (스포츠/레저)
+- **50000005**: Automotive/Tools (자동차/공구)
+- **50000006**: Books/Music/DVDs (도서/음반/DVD)
+- **50000007**: Toys/Hobbies (완구/취미)
+- **50000008**: Food/Beverages (식품/음료)
+- **50000009**: Health/Medical (건강/의료용품)
+- **50000010**: Household/Living (생활/주방용품)
+
+#### How to Find Category Codes:
+
+1. Visit [Naver Shopping](https://shopping.naver.com)
+2. Navigate to desired category
+3. Check the `cat_id` parameter in the URL
+4. Use the 8-digit code (e.g., `cat_id=50000000` → use `"50000000"`)
+
+#### Usage Example:
+
+When using shopping category tools, specify category like:
+
+```json
+{
+  "category": "50000000",
+  "startDate": "2024-01-01",
+  "endDate": "2024-01-31",
+  "timeUnit": "month"
+}
+```
+
+#### Complete Category List:
+
+For a complete list of category codes, you can download from Naver Shopping Partner Center or extract them by browsing Naver Shopping categories.
+
+### 🎯 Business Use Cases & Scenarios
+
+#### 🛍️ E-commerce Market Research
+
+```javascript
+// 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"
+```
+
+#### 📱 Digital Marketing Strategy
+
+```javascript
+// 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
+```
+
+#### 🏢 Business Intelligence & Competitive Analysis
+
+```javascript
+// 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
+```
+
+#### 📊 Seasonal Business Planning
+
+```javascript
+// 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
+```
+
+#### 🎯 Customer Persona Development
+
+```javascript
+// 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
+```
+
+### 📈 Advanced Analysis Scenarios
+
+#### Market Entry Strategy
+
+1. **Category Discovery**: Use `find_category` to explore market segments
+2. **Trend Analysis**: Identify growing vs declining categories
+3. **Demographic Targeting**: Age/gender analysis for customer targeting
+4. **Competitive Intelligence**: Keyword performance comparison
+5. **Device Strategy**: Mobile vs PC shopping optimization
+
+#### Product Launch Planning
+
+1. **Market Validation**: Category growth trends and seasonality
+2. **Target Customers**: Demographic analysis for product positioning
+3. **Marketing Channels**: Device preferences for advertising strategy
+4. **Competitive Landscape**: Keyword competition and opportunities
+5. **Pricing Strategy**: Category performance and price correlation
+
+#### Performance Monitoring
+
+1. **Category Health**: Monitor product category trends
+2. **Keyword Tracking**: Track brand and product keyword performance
+3. **Demographic Shifts**: Monitor changing customer demographics
+4. **Seasonal Patterns**: Plan inventory and marketing campaigns
+5. **Competitive Benchmarking**: Compare performance against category averages
+
+### Quick Reference: Popular Category Codes
+
+| 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.
+
+## Installation
+
+### Method 1: NPX Installation (Recommended)
+
+The easiest way to use this MCP server is through NPX. For detailed package information, see the [NPM package page](https://www.npmjs.com/package/@isnow890/naver-search-mcp).
+
+#### Claude Desktop Configuration
+
+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):
+
+```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"
+      }
+    }
+  }
+}
+```
+
+#### Cursor AI Configuration
+
+Add to `mcp.json`:
+
+```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"
+      }
+    }
+  }
+}
+```
+
+### Method 2: Local Installation
+
+For local development or custom modifications:
+
+#### Step 1: Download and Build Source Code
+
+##### Clone with Git
+
+```bash
+git clone https://github.com/isnow890/naver-search-mcp.git
+cd naver-search-mcp
+npm install
+npm run build
+```
+
+##### Or Download ZIP File
+
+1. Download the latest version from [GitHub Releases](https://github.com/isnow890/naver-search-mcp/releases)
+2. Extract the ZIP file to your desired location
+3. Navigate to the extracted folder in terminal:
+
+```bash
+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.
+
+#### Step 2: Claude Desktop Configuration
+
+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
+
+##### Windows Configuration
+
+Add to Claude Desktop config file (`%APPDATA%\Claude\claude_desktop_config.json`):
+
+```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"
+      }
+    }
+  }
+}
+```
+
+##### macOS/Linux Configuration
+
+Add to Claude Desktop config file (`~/Library/Application Support/Claude/claude_desktop_config.json`):
+
+```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"
+      }
+    }
+  }
+}
+```
+
+##### Path Configuration Important Notes
+
+⚠️ **Important**: You must change the following paths in the above configuration to your actual installation paths:
+
+- **Windows**: Change `C:\\path\\to\\naver-search-mcp` to your actual downloaded folder path
+- **macOS/Linux**: Change `/path/to/naver-search-mcp` to your actual downloaded folder path
+- **Build Path**: Make sure the path points to `dist/src/index.js` (not just `index.js`)
+
+Finding your path:
+
+```bash
+# 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
+```
+
+#### Step 3: Restart Claude Desktop
+
+After completing the configuration, completely close and restart Claude Desktop to activate the Naver Search MCP server.
+
+---
+
+## Alternative Installation Methods
+
+### Method 3: Legacy Smithery Installation (Only for v1.0.30 and below)
+
+⚠️ **Note**: This method only works for versions 1.0.30 and below due to platform compatibility issues.
+
+#### For Claude Desktop:
+```bash
+npx -y @smithery/cli@latest install @isnow890/naver-search-mcp --client claude
+```
+
+#### For other AI clients:
+```bash
+# 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
+```
+
+### Method 4: Docker Installation
+
+For containerized deployment:
+
+```bash
+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:
+
+```json
+{
+  "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"
+      ]
+    }
+  }
+}
+```
+
+## Build
+
+Docker build:
+
+```bash
+docker build -t mcp/naver-search .
+```
+
+## License
+
+MIT License

package/dist/data/README.md

@@ -1,26 +1,26 @@
-# 카테고리 데이터 폴더
-
-이 폴더에 `categories.xlsx` 파일을 배치하세요.
-
-## 파일 구조
-
-```
-data/
-└── categories.xlsx
-```
-
-## Excel 파일 형식
-
-| 카테고리번호 | 대분류 | 중분류 | 소분류 | 세분류 |
-|-------------|--------|--------|--------|--------|
-| 50003307    | 가구/인테리어 | DIY자재/용품 | 가구부속품 | 가구다리 |
-
-- 첫 번째 행(헤더)은 자동으로 건너뜁니다
-- 카테고리번호는 필수입니다
-- 대분류는 필수, 나머지 분류는 선택사항입니다
-
-## 사용법
-
-1. `categories.xlsx` 파일을 이 폴더에 배치
-2. MCP 서버 시작시 자동으로 로드됨
+# 카테고리 데이터 폴더
+
+이 폴더에 `categories.xlsx` 파일을 배치하세요.
+
+## 파일 구조
+
+```
+data/
+└── categories.xlsx
+```
+
+## Excel 파일 형식
+
+| 카테고리번호 | 대분류 | 중분류 | 소분류 | 세분류 |
+|-------------|--------|--------|--------|--------|
+| 50003307    | 가구/인테리어 | DIY자재/용품 | 가구부속품 | 가구다리 |
+
+- 첫 번째 행(헤더)은 자동으로 건너뜁니다
+- 카테고리번호는 필수입니다
+- 대분류는 필수, 나머지 분류는 선택사항입니다
+
+## 사용법
+
+1. `categories.xlsx` 파일을 이 폴더에 배치
+2. MCP 서버 시작시 자동으로 로드됨
 3. 파일 수정시 자동으로 캐시 갱신됨

package/dist/src/index.js

@@ -253,10 +253,10 @@ async function main() {
                 : "undefined",
         });
         if (!clientId || !clientSecret) {
-            throw new Error(`Missing required environment variables:
-        NAVER_CLIENT_ID: ${clientId ? "provided" : "missing"}
-        NAVER_CLIENT_SECRET: ${clientSecret ? "provided" : "missing"}
-        
+            throw new Error(`Missing required environment variables:
+        NAVER_CLIENT_ID: ${clientId ? "provided" : "missing"}
+        NAVER_CLIENT_SECRET: ${clientSecret ? "provided" : "missing"}
+        
         Please set these environment variables before running the server.`);
         }
         const config = {

package/package.json

@@ -1,41 +1,41 @@
-{
-  "name": "@isnow890/naver-search-mcp",
-  "version": "1.0.40",
-  "description": "Naver Search MCP Server",
-  "main": "dist/index.js",
-  "module": "./src/index.ts",
-  "types": "dist/index.d.ts",
-  "files": [
-    "dist"
-  ],
-  "scripts": {
-    "prebuild": "npx shx rm -rf dist",
-    "build": "tsc && shx cp -r data dist/",
-    "prepare": "npm run build",
-    "watch": "tsc --watch",
-    "start": "node dist/src/index.js"
-  },
-  "engines": {
-    "node": ">=18"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "1.17.1",
-    "axios": "^1.6.7",
-    "zod": "^3.23.0",
-    "zod-to-json-schema": "^3.23.0",
-    "sharp": "^0.33.2",
-    "dotenv": "^16.4.5",
-    "xlsx": "0.18.5"
-  },
-  "devDependencies": {
-    "@types/node": "^22",
-    "shx": "^0.3.4",
-    "typescript": "^5.3.3"
-  },
-  "author": "isnow890",
-  "license": "MIT",
-  "bin": {
-    "naver-search-mcp": "dist/src/index.js"
-  },
-  "type": "module"
-}
+{
+  "name": "@isnow890/naver-search-mcp",
+  "version": "1.0.41",
+  "description": "Naver Search MCP Server",
+  "main": "dist/src/index.js",
+  "module": "./src/index.ts",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "prebuild": "npx shx rm -rf dist",
+    "build": "tsc && shx cp -r data dist/",
+    "prepare": "npm run build",
+    "watch": "tsc --watch",
+    "start": "node dist/src/index.js"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "1.17.1",
+    "axios": "^1.6.7",
+    "zod": "^3.23.0",
+    "zod-to-json-schema": "^3.23.0",
+    "sharp": "^0.33.2",
+    "dotenv": "^16.4.5",
+    "xlsx": "0.18.5"
+  },
+  "devDependencies": {
+    "@types/node": "^22",
+    "shx": "^0.3.4",
+    "typescript": "^5.3.3"
+  },
+  "author": "isnow890",
+  "license": "MIT",
+  "bin": {
+    "naver-search-mcp": "dist/src/index.js"
+  },
+  "type": "module"
+}