Skip to main content
Glama
isnow890

Naver Search MCP Server

by isnow890

Naver Search MCP Server

한국어

Trust Score MCP.so

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 to NAVER API HUB on NAVER Cloud Platform, and is shutting down three search APIs entirely.

Date

What happens

2026-07-31

Developers Center stops accepting new key applications.Shopping / Book / Academic search APIs shut down completely.

2027-06-30

Developers Center support ends — existing keys stop working.

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 HUB below.

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. Shopping Insight (datalab_shopping_*) and find_category are a different API and are not affected.

Related MCP server: naver-mcp

Available on ClawHub for OpenClaw

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 needs one credential 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's apiKey field maps to NAVER_CLIENT_SECRET; HUB users should set both HUB variables explicitly in the environment instead of using apiKey.

Quick Start: Use Without API Key

You can use this server immediately without API keys through Kakao PlayMCP. Simply visit the link and start using it right away!

Tool Details

Available tools:

  • 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 Tools

  • 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. Shopping Insight (datalab_shopping_*) is a different API and is unaffected.

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

Getting API Keys

Two platforms issue keys for this server. Set one pair of environment variables — see Configuration below for how the pair you set determines the platform used.

  1. Go to the NAVER Cloud Platform console and sign up or log in.

  2. Click the region & platform selector in the top right of the console, choose your region/platform, and click Apply.

  3. Open Menu > All Services > Application Services > NAVER API HUB.

  4. Click Application, select (or create) your application, then under API management click 인증 정보 (Authentication Info).

  5. Copy the Client ID and Client Secret shown in the popup.

  6. Use these as NCP_APIGW_API_KEY_ID (Client ID) and NCP_APIGW_API_KEY (Client Secret) in the configuration below.

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

Naver Developers Center stops accepting new applications on 2026-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.

  1. Visit Naver Developers and log in with your Naver account

  2. Click the "Application Registration" (애플리케이션 등록) button

  3. Fill in the application information:

    • Application Name: Enter any name (e.g., "Naver Search MCP")

    • Usage: Select "Search" (검색)

  4. In the API Settings section, check ALL of the following APIs:

    • 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

  5. Click "Register" to complete registration

  6. After registration, you'll see your Client ID and Client Secret on the application detail page

  7. Use these as NAVER_CLIENT_ID / NAVER_CLIENT_SECRET in the configuration below

Configuration

Credentials

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

Variables

Platform

Endpoint

NCP_APIGW_API_KEY_ID, NCP_APIGW_API_KEY

NAVER API HUB (NCP)

naverapihub.apigw.ntruss.com

NAVER_CLIENT_ID, NAVER_CLIENT_SECRET

Naver Developers (legacy)

openapi.naver.com

If both pairs are set, NAVER API HUB wins.

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

Migration to NAVER API HUB

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

Date

What happens

2026-06-25

NAVER API HUB launched

2026-07-31

Developers Center stops accepting new applications

2027-06-30

Developers Center support ends — existing keys stop working

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

Installation

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

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):

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

Claude Code Configuration

Add to your Claude Code settings:

{
  "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:

npx -y @isnow890/naver-search-mcp

Make sure one credential 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's apiKey field maps to NAVER_CLIENT_SECRET; HUB users should set both HUB variables explicitly instead.

Method 3: Local Installation

For local development or custom modifications:

Step 1: Download and Build Source Code

Clone with Git
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

  2. Extract the ZIP file to your desired location

  3. Navigate to the extracted folder in terminal:

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):

{
  "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):

{
  "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:

# 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.

Prerequisites

  • A credential pair for one platform — NAVER API HUB or Naver Developers (see Getting API Keys)

  • Node.js 18 or higher

  • NPM 8 or higher

License

MIT License


Version History

1.0.49 (2026-07-26)

  • NAVER API HUB support: set NCP_APIGW_API_KEY_ID / NCP_APIGW_API_KEY to call the new platform. Existing NAVER_CLIENT_ID / NAVER_CLIENT_SECRET keep working unchanged — the platform is chosen by which variable pair you set

  • Removed search_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 plain Error instead of the raw AxiosError. Code branching on error.response?.status sees undefined; the same detail is in Error.message

  • Error messages name the platform and HTTP status, and 401s suggest checking whether a key was set on the other platform's variables

1.0.48 (2026-05-12)

  • Fixed find_category data loading when the MCP server is launched by npx from a different working directory

  • Category data is now resolved relative to the installed package before falling back to local development paths

1.0.47 (2025-01-03)

  • Added "today" keyword support for 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 handlers for 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 @gloomyrobot for reporting the server termination issue

1.0.45 (2025-09-28)

  • Resolved platform compatibility issues for hosted MCP installations

  • Replaced the Excel export in category search with JSON for better compatibility

  • Restored the search_webkr tool for Korean web search

  • Improved hosted platform installation compatibility

1.0.44 (2025-08-31)

  • Added the get_current_korean_time tool 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

1.0.40 (2025-08-21)

  • Added the find_category tool 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

1.0.30 (2025-08-04)

  • MCP SDK upgraded to 1.17.1

  • Fixed compatibility issues with hosted MCP platform 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

Available Tools

19 tools
datalab_shopping_by_ageC

Perform a trend analysis on Naver Shopping by age. (네이버 쇼핑 연령별 트렌드 분석)

ParametersJSON Schema
NameRequiredDescriptionDefault
agesYesAge groups
categoryYesCategory code
endDateYesEnd date (yyyy-mm-dd)
startDateYesStart date (yyyy-mm-dd)
timeUnitYesTime unit

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure. It states the tool performs 'trend analysis' but doesn't describe what that entails—whether it returns aggregated data, visualizations, or statistical insights. It also omits information about rate limits, authentication needs, or data freshness, which are critical for a data analysis tool.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, efficient sentence that front-loads the core purpose. The Korean translation adds redundancy but may aid clarity for Korean-speaking users. No extraneous information is included, making it appropriately concise.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a data analysis tool with 5 required parameters and no output schema, the description is insufficient. It doesn't explain the output format (e.g., time-series data, charts), data granularity, or how results are structured. Without annotations or output schema, users lack critical context to interpret results effectively.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema fully documents all parameters. The description adds no additional meaning beyond implying 'trend analysis' involves the parameters, but doesn't explain how they interact (e.g., how ages affect trends over time). Baseline 3 is appropriate as the schema does the heavy lifting.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('perform a trend analysis') and resource ('Naver Shopping by age'), with the Korean translation reinforcing the purpose. It distinguishes from some siblings (e.g., datalab_shopping_by_device) by specifying 'by age', but doesn't explicitly differentiate from datalab_shopping_keyword_by_age, which is a similar but distinct tool.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus alternatives. It doesn't mention sibling tools like datalab_shopping_by_gender or datalab_shopping_keyword_by_age, nor does it specify prerequisites or appropriate contexts for trend analysis versus other shopping-related tools.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

datalab_shopping_by_deviceC

Perform a trend analysis on Naver Shopping by device. (네이버 쇼핑 기기별 트렌드 분석)

ParametersJSON Schema
NameRequiredDescriptionDefault
categoryYesCategory code
deviceYesDevice type
endDateYesEnd date (yyyy-mm-dd)
startDateYesStart date (yyyy-mm-dd)
timeUnitYesTime unit

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries full burden for behavioral disclosure. It mentions 'trend analysis' but doesn't specify what that entails (e.g., returns data, charts, insights), whether it's read-only or has side effects, or any constraints like rate limits or authentication needs. This is inadequate for a tool with 5 required parameters.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is brief and front-loaded with the core purpose. The Korean translation adds redundancy but doesn't significantly detract. It could be more concise by omitting the translation, but it's still efficient with no wasted sentences.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a tool with 5 required parameters, no annotations, and no output schema, the description is incomplete. It lacks behavioral context (e.g., what the analysis returns, any limitations), usage guidance relative to siblings, and doesn't compensate for the absence of structured metadata. This leaves significant gaps for an agent.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents all parameters thoroughly. The description adds no parameter-specific information beyond implying device analysis, which is covered by the 'device' parameter's enum. Baseline 3 is appropriate when the schema does the heavy lifting.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool performs 'trend analysis on Naver Shopping by device' with a Korean translation. It specifies the verb ('perform trend analysis'), resource ('Naver Shopping'), and scope ('by device'), but doesn't explicitly differentiate from sibling tools like 'datalab_shopping_by_age' or 'datalab_shopping_by_gender' beyond the device focus.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus alternatives. It doesn't mention sibling tools like 'datalab_shopping_by_age' or 'datalab_shopping_by_gender' for comparison, nor does it specify prerequisites or exclusions. The description only states what it does, not when it's appropriate.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

datalab_shopping_by_genderC

Perform a trend analysis on Naver Shopping by gender. (네이버 쇼핑 성별 트렌드 분석)

ParametersJSON Schema
NameRequiredDescriptionDefault
categoryYesCategory code
endDateYesEnd date (yyyy-mm-dd)
genderYesGender
startDateYesStart date (yyyy-mm-dd)
timeUnitYesTime unit

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden of behavioral disclosure. It mentions 'trend analysis' but doesn't specify what data is returned (e.g., time-series metrics, aggregated statistics), whether it's a read-only operation, any rate limits, or authentication requirements. For a data analysis tool with zero annotation coverage, this leaves significant gaps in understanding its behavior.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is concise and front-loaded with the core purpose in the first sentence. The Korean translation adds minimal redundancy. However, it could be slightly more structured by explicitly mentioning the required parameters or output format.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's complexity (5 required parameters, no output schema, no annotations), the description is minimally adequate. It states the purpose but lacks details on behavioral traits, output format, and usage context. With no output schema, the agent doesn't know what data to expect, which is a significant gap for a trend analysis tool.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, with all parameters clearly documented in the schema (e.g., 'Category code', 'End date (yyyy-mm-dd)'). The description adds no additional parameter semantics beyond implying gender-based filtering. With high schema coverage, the baseline score of 3 is appropriate as the schema does the heavy lifting.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose: 'Perform a trend analysis on Naver Shopping by gender.' It specifies the verb ('perform trend analysis'), resource ('Naver Shopping'), and dimension ('by gender'). However, it doesn't explicitly differentiate from sibling tools like 'datalab_shopping_by_age' or 'datalab_shopping_by_device' beyond the gender focus.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. It doesn't mention sibling tools like 'datalab_shopping_by_age' for age-based analysis or 'datalab_shopping_keyword_by_gender' for keyword-focused gender analysis. The agent must infer usage from the name and description alone.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

datalab_shopping_categoryC

Perform a trend analysis on Naver Shopping category. (네이버 쇼핑 카테고리별 트렌드 분석)

ParametersJSON Schema
NameRequiredDescriptionDefault
categoryYesArray of category name and code pairs
endDateYesEnd date (yyyy-mm-dd)
startDateYesStart date (yyyy-mm-dd)
timeUnitYesTime unit

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries full burden. It mentions 'trend analysis' but doesn't disclose what this entails operationally - whether it's a read-only query, requires authentication, has rate limits, returns aggregated data, or what format the analysis takes. The Korean translation adds no behavioral information.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is appropriately brief with two equivalent language versions. However, the Korean translation adds no new information and could be considered redundant. The core English statement is front-loaded and efficient.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a data analysis tool with 4 required parameters and no output schema, the description is insufficient. It doesn't explain what 'trend analysis' returns, what metrics are analyzed, or provide context about the Naver Shopping platform. Without annotations or output schema, users must guess about the tool's behavior and results.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so parameters are well-documented in the schema. The description doesn't add any meaningful parameter semantics beyond what's already in the schema - it doesn't explain how categories relate to trend analysis, what the time unit affects, or provide examples of valid category inputs.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('Perform a trend analysis') and target resource ('Naver Shopping category'), making the purpose understandable. It distinguishes from some siblings like 'datalab_shopping_by_age' by specifying category-level analysis, though it doesn't explicitly differentiate from all similar tools like 'datalab_shopping_keywords'.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. With multiple sibling tools for shopping data analysis (e.g., by age, device, gender, keywords), there's no indication of when category trend analysis is preferred over other dimensions or keyword analysis.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

datalab_shopping_keyword_by_ageC

Perform a trend analysis on Naver Shopping keywords by age. (네이버 쇼핑 키워드 연령별 트렌드 분석)

ParametersJSON Schema
NameRequiredDescriptionDefault
agesYesAge groups
categoryYesCategory code
endDateYesEnd date (yyyy-mm-dd)
keywordYesSearch keyword
startDateYesStart date (yyyy-mm-dd)
timeUnitYesTime unit

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure but offers minimal information. It states the tool performs 'trend analysis' but doesn't describe what the analysis entails (e.g., returns data, visualizations, or insights), potential rate limits, authentication needs, or data freshness. For a tool with 6 required parameters and no annotation coverage, this is a significant gap in transparency.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, efficient sentence in English with a Korean translation for clarity, front-loading the core purpose without unnecessary details. It avoids redundancy and wastes no words, making it easy for an agent to parse quickly.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's complexity (6 required parameters, no output schema, and no annotations), the description is incomplete. It lacks behavioral context (e.g., what the analysis returns, any side effects), usage differentiation from siblings, and doesn't compensate for the absence of output schema by describing expected results. For a data analysis tool with multiple inputs, this leaves significant gaps for an agent.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, with all parameters well-documented in the schema (e.g., 'ages' as age groups with enum values, 'timeUnit' with enum options). The description adds no parameter-specific semantics beyond implying analysis involves 'keywords' and 'age', which the schema already covers via 'keyword' and 'ages' parameters. Baseline 3 is appropriate when the schema does the heavy lifting.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool performs 'trend analysis on Naver Shopping keywords by age' with a Korean translation for clarity. It specifies the verb ('perform trend analysis'), resource ('Naver Shopping keywords'), and dimension ('by age'), making the purpose evident. However, it doesn't explicitly differentiate from sibling tools like 'datalab_shopping_by_age' or 'datalab_shopping_keyword_by_gender', which would require a 5.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. It doesn't mention sibling tools like 'datalab_shopping_by_age' (which might analyze shopping trends by age without keyword focus) or 'datalab_shopping_keyword_by_gender' (which does similar analysis by gender), leaving the agent to infer usage from names alone. There are no explicit when/when-not instructions or prerequisites.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

datalab_shopping_keyword_by_deviceC

Perform a trend analysis on Naver Shopping keywords by device. (네이버 쇼핑 키워드 기기별 트렌드 분석)

ParametersJSON Schema
NameRequiredDescriptionDefault
categoryYesCategory code
deviceYesDevice type
endDateYesEnd date (yyyy-mm-dd)
keywordYesSearch keyword
startDateYesStart date (yyyy-mm-dd)
timeUnitYesTime unit

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries full burden for behavioral disclosure. It states it performs 'trend analysis' but doesn't describe what the analysis returns (e.g., time-series data, metrics), whether it's read-only or has side effects, rate limits, authentication needs, or error conditions. For a tool with 6 required parameters and no annotations, this leaves significant behavioral gaps.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is appropriately concise with two parallel sentences (English and Korean). Both sentences directly state the tool's purpose without unnecessary elaboration. However, the Korean translation adds redundancy rather than new information, slightly reducing efficiency.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a tool with 6 required parameters, no annotations, and no output schema, the description is insufficient. It doesn't explain what the trend analysis returns, how results are structured, or provide context about the Naver Shopping platform. With rich parameter requirements but poor behavioral disclosure, the description leaves too many gaps for effective tool use.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents all 6 parameters with descriptions and enums. The description adds no additional parameter information beyond what's in the schema - it doesn't explain relationships between parameters (e.g., how keyword interacts with device) or provide usage examples. With complete schema coverage, baseline 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool performs 'trend analysis on Naver Shopping keywords by device' with a Korean translation. It specifies the verb 'perform trend analysis' and resource 'Naver Shopping keywords by device', making the purpose understandable. However, it doesn't explicitly differentiate from sibling tools like 'datalab_shopping_by_device' or 'datalab_shopping_keyword_by_age', which would require more specific distinction.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. It doesn't mention sibling tools like 'datalab_shopping_by_device' (which might analyze shopping trends by device without keyword focus) or 'datalab_shopping_keyword_by_age' (which does keyword analysis by age instead of device). There's no context about appropriate use cases or exclusions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

datalab_shopping_keyword_by_genderC

Perform a trend analysis on Naver Shopping keywords by gender. (네이버 쇼핑 키워드 성별 트렌드 분석)

ParametersJSON Schema
NameRequiredDescriptionDefault
categoryYesCategory code
endDateYesEnd date (yyyy-mm-dd)
genderYesGender
keywordYesSearch keyword
startDateYesStart date (yyyy-mm-dd)
timeUnitYesTime unit

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries full burden for behavioral disclosure. While 'trend analysis' implies a read-only operation, the description doesn't specify whether this requires authentication, has rate limits, returns time-series data, or what format the analysis takes. For a tool with 6 required parameters and no output schema, this leaves significant behavioral questions unanswered.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is appropriately concise with two parallel statements (English and Korean) that convey the same essential information. While the Korean translation adds redundancy, it doesn't significantly detract from efficiency. The description is front-loaded with the core purpose and wastes no space on unnecessary details.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's complexity (6 required parameters, trend analysis function) and lack of both annotations and output schema, the description is insufficiently complete. It doesn't explain what the analysis returns, how results are structured, or provide context about the Naver Shopping platform. The agent must rely entirely on the parameter schema without understanding the tool's output behavior.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, with all parameters clearly documented in the input schema. The description adds no parameter-specific information beyond what's already in the schema. According to scoring rules, when schema coverage is high (>80%), the baseline is 3 even with no param info in the description, which applies here.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool performs 'trend analysis on Naver Shopping keywords by gender' with a Korean translation. It specifies the verb 'perform trend analysis' and resource 'Naver Shopping keywords by gender', making the purpose understandable. However, it doesn't explicitly differentiate from sibling tools like 'datalab_shopping_by_gender' or 'datalab_shopping_keyword_by_age', which would require more specific scope details.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. With multiple sibling tools in the datalab_shopping family (by_age, by_device, category, keywords), there's no indication of when gender-specific keyword analysis is appropriate versus other demographic or categorical analyses. The agent must infer usage from the tool name alone.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

datalab_shopping_keywordsC

Perform a trend analysis on Naver Shopping keywords. (네이버 쇼핑 키워드별 트렌드 분석)

ParametersJSON Schema
NameRequiredDescriptionDefault
categoryYesCategory code
endDateYesEnd date (yyyy-mm-dd)
keywordYesArray of keyword name and value pairs
startDateYesStart date (yyyy-mm-dd)
timeUnitYesTime unit

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries full burden. It mentions 'trend analysis' which implies a read-only operation, but doesn't disclose any behavioral traits like authentication requirements, rate limits, data freshness, or what the analysis output contains. For a data analysis tool with no annotation coverage, this leaves significant gaps in understanding how it behaves.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is appropriately concise with a single English sentence and a Korean translation. It's front-loaded with the core purpose. However, the Korean translation adds redundancy without additional information, slightly reducing efficiency.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given no annotations, no output schema, and multiple sibling tools, the description is incomplete. It doesn't explain what the trend analysis returns (e.g., metrics, time series data), how it differs from other shopping keyword tools, or any prerequisites. For a data analysis tool with rich parameter requirements, more context is needed to use it effectively.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents all 5 parameters with descriptions. The description doesn't add any parameter-specific information beyond what's in the schema. It mentions 'keywords' generally but doesn't explain the keyword array structure or how category codes work. Baseline 3 is appropriate when schema does the heavy lifting.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool performs 'trend analysis on Naver Shopping keywords' with a Korean translation for clarity. It specifies the action ('trend analysis'), resource ('Naver Shopping keywords'), and domain context. However, it doesn't explicitly differentiate from sibling tools like 'datalab_shopping_keyword_by_age' or 'datalab_shopping_category', which appear to be related keyword analysis tools with different breakdowns.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. With multiple sibling tools like 'datalab_shopping_by_age', 'datalab_shopping_keyword_by_gender', and 'search_shop', there's no indication of whether this is the primary keyword analysis tool or how it differs from others that might also analyze shopping keywords with demographic filters.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

search_academicC

Perform a search on Naver Academic. (네이버 전문자료 검색)

ParametersJSON Schema
NameRequiredDescriptionDefault
displayNoNumber of results to display (default: 10)
queryYesSearch query
sortNoSort method (sim: similarity, date: date)
startNoStart position of search results (default: 1)

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries full burden but offers minimal behavioral insight. It states it performs a search but doesn't disclose rate limits, authentication needs, pagination behavior, error conditions, or what the search results look like. For a search tool with zero annotation coverage, this is inadequate.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is extremely concise with just two brief phrases, front-loading the core purpose. Every word earns its place, and there's no redundant or verbose language. The Korean translation adds precision without bloating the text.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given no annotations and no output schema, the description is incomplete for a search tool with 4 parameters. It doesn't explain what results to expect, how they're structured, or important behavioral aspects like rate limits or error handling. The high schema coverage helps but doesn't compensate for missing output and behavioral context.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, providing good documentation for all parameters. The description adds no parameter-specific information beyond what's in the schema, so it meets the baseline of 3 without compensating value. The Korean text doesn't clarify parameters further.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('Perform a search') and target resource ('on Naver Academic'), with the Korean translation adding specificity. It distinguishes this tool from most siblings (e.g., search_blog, search_news) by specifying the academic domain, though it doesn't explicitly differentiate from all possible search tools.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus alternatives. The description doesn't mention when academic searches are appropriate compared to other search tools (like search_webkr or search_news) or the datalab_* tools, leaving the agent to infer usage context.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

search_blogC

Perform a search on Naver Blog. (네이버 블로그 검색)

ParametersJSON Schema
NameRequiredDescriptionDefault
displayNoNumber of results to display (default: 10)
queryYesSearch query
sortNoSort method (sim: similarity, date: date)
startNoStart position of search results (default: 1)

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries full burden for behavioral disclosure. It states the basic action but doesn't describe what the search returns (blog posts, metadata, links), whether there are rate limits, authentication requirements, or how results are structured. For a search tool with no annotation coverage, this leaves significant gaps in understanding the tool's behavior.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is extremely concise with just two short phrases that convey the essential purpose. Both the English and Korean versions are front-loaded with the core functionality, and there's no wasted language or unnecessary elaboration.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a search tool with no annotations and no output schema, the description is insufficient. It doesn't explain what kind of results to expect (blog posts, metadata, links), how results are formatted, or any limitations. The combination of missing behavioral context and lack of output information makes this description incomplete for effective tool use.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents all 4 parameters thoroughly. The description adds no parameter-specific information beyond what's in the schema. The baseline of 3 is appropriate when the schema does all the parameter documentation work.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('Perform a search') and target resource ('on Naver Blog'), with the Korean translation adding clarity for the specific platform. However, it doesn't distinguish this from sibling tools like search_news or search_webkr, which also perform searches on Naver platforms but for different content types.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided about when to use this tool versus alternatives. The description doesn't mention what makes blog search unique compared to other search tools in the sibling list, nor does it specify prerequisites or typical use cases for blog content versus other content types.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

search_bookC

Perform a search on Naver Book. (네이버 책 검색)

ParametersJSON Schema
NameRequiredDescriptionDefault
displayNoNumber of results to display (default: 10)
queryYesSearch query
sortNoSort method (sim: similarity, date: date)
startNoStart position of search results (default: 1)

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden of behavioral disclosure. It states the tool performs a search but doesn't describe what the search returns (e.g., book titles, authors, metadata), whether it's paginated, rate limits, authentication needs, or error handling. This leaves significant gaps in understanding the tool's behavior beyond the basic action.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is extremely concise with just one sentence and a parenthetical translation, making it front-loaded and efficient. Every word serves a purpose: it defines the action and resource clearly without any fluff or redundancy.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the lack of annotations and output schema, the description is incomplete. It doesn't explain what the search returns (e.g., book results format), behavioral aspects like pagination or errors, or how it differs from sibling tools. For a search tool with no structured output information, more context is needed to be fully helpful.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has 100% description coverage, providing details for all 4 parameters (query, display, sort, start). The description adds no additional parameter semantics beyond what's in the schema. According to the rules, with high schema coverage (>80%), the baseline score is 3 when no param info is in the description, which applies here.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose: 'Perform a search on Naver Book.' It specifies the action (search) and resource (Naver Book), and the Korean translation adds clarity. However, it doesn't explicitly differentiate from sibling tools like search_academic or search_news, which also perform searches on different Naver services.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. It doesn't mention sibling tools like search_academic or search_news, nor does it specify scenarios where book searches are preferred over other search types. The only implied usage is for searching books, but no explicit context or exclusions are provided.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

search_encycC

Perform a search on Naver Encyclopedia. (네이버 지식백과 검색)

ParametersJSON Schema
NameRequiredDescriptionDefault
displayNoNumber of results to display (default: 10)
queryYesSearch query
sortNoSort method (sim: similarity, date: date)
startNoStart position of search results (default: 1)

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden. It mentions 'Perform a search' but doesn't disclose behavioral traits like rate limits, authentication needs, pagination behavior, error handling, or what the search returns. For a search tool with no annotation coverage, this leaves significant gaps in understanding how it behaves.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is extremely concise with just one sentence plus a Korean translation, which is front-loaded and wastes no words. Every part earns its place by clearly stating the purpose without redundancy.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given no annotations, no output schema, and a search tool with potential complexity (e.g., result format, limitations), the description is incomplete. It doesn't explain what the tool returns, any constraints, or how to interpret results, leaving the agent with insufficient context for effective use.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema fully documents all parameters. The description adds no additional parameter semantics beyond what's in the schema, such as explaining the search scope or result format. Baseline 3 is appropriate when the schema does the heavy lifting.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the verb ('Perform a search') and resource ('on Naver Encyclopedia'), making the purpose explicit. It distinguishes from siblings by specifying the encyclopedia domain, though it doesn't explicitly contrast with other search tools like search_blog or search_news beyond the resource name.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. With many sibling search tools (e.g., search_blog, search_news, search_academic), there is no indication of when encyclopedia searches are appropriate or what distinguishes this from other search types.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

search_imageC

Perform a search on Naver Image. (네이버 이미지 검색)

ParametersJSON Schema
NameRequiredDescriptionDefault
displayNoNumber of results to display (default: 10)
queryYesSearch query
sortNoSort method (sim: similarity, date: date)
startNoStart position of search results (default: 1)

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries full burden. It only states what the tool does ('Perform a search') without disclosing behavioral traits like rate limits, authentication requirements, response format, pagination behavior, or error conditions. For a search tool with no annotation coverage, this is a significant gap.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is extremely concise with just two short phrases that directly state the tool's purpose. Every word earns its place, and the Korean translation adds value for users familiar with that language without being redundant.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a search tool with 4 parameters, no annotations, and no output schema, the description is inadequate. It doesn't explain what the tool returns (image URLs, metadata, thumbnails?), doesn't mention rate limits or authentication, and provides no context about the Naver Image service. The description should do more given the complexity and lack of structured information.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents all 4 parameters thoroughly. The description adds no parameter information beyond what's in the schema. Baseline 3 is appropriate when the schema does all the parameter documentation work.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('Perform a search') and resource ('Naver Image'), making the purpose immediately understandable. However, it doesn't explicitly differentiate this image search tool from its many sibling search tools (like search_blog, search_news, etc.), which would require a 5.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. With 17 sibling tools including many other search types (academic, blog, news, etc.), there's no indication of when image search is appropriate versus other search tools or the datalab_* tools.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

search_kinC

Perform a search on Naver KnowledgeiN. (네이버 지식iN 검색)

ParametersJSON Schema
NameRequiredDescriptionDefault
displayNoNumber of results to display (default: 10)
queryYesSearch query
sortNoSort method (sim: similarity, date: date)
startNoStart position of search results (default: 1)

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries full burden for behavioral disclosure but offers minimal information. It doesn't mention rate limits, authentication requirements, pagination behavior (implied by 'display' and 'start' parameters but not explained), error conditions, or what format/search scope the results will have. The description only states what the tool does at a high level.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is appropriately concise with two parallel statements (English and Korean) that directly state the tool's purpose. There's no wasted verbiage or unnecessary elaboration, though the dual-language approach might be slightly redundant for some users.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a search tool with 4 parameters, no annotations, and no output schema, the description is insufficiently complete. It doesn't explain what KnowledgeiN is (a Q&A platform), what kind of content it searches, what the results look like, or any behavioral constraints. Given the complexity of search tools and lack of structured metadata, more context is needed.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

With 100% schema description coverage, the schema already fully documents all 4 parameters. The description adds no additional parameter semantics beyond what's in the schema - it doesn't explain typical query formats, what 'sim' vs 'date' sorting means in practice, or provide examples. The baseline score of 3 reflects adequate but minimal value addition.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the verb ('Perform a search') and resource ('on Naver KnowledgeiN'), with a Korean translation adding clarity for that audience. However, it doesn't distinguish this tool from its many sibling search tools (e.g., search_blog, search_news, search_academic) which all perform searches on different Naver platforms.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this specific search tool versus the 15+ sibling search tools listed. There's no mention of what makes KnowledgeiN unique (Q&A platform vs. blog/news searches) or when an agent should choose this over alternatives like search_webkr or search_academic.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

search_localC

Perform a search on Naver Local. (네이버 지역 검색)

ParametersJSON Schema
NameRequiredDescriptionDefault
displayNoNumber of results to display (default: 1, max: 5)
queryYesSearch query
sortNoSort method (random: accuracy, comment: review count)
startNoStart position of search results (default: 1, max: 1)

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden of behavioral disclosure. It only states the basic action ('Perform a search') without mentioning any behavioral traits such as rate limits, authentication needs, error handling, or what the output looks like (e.g., format, pagination). For a search tool with no annotation coverage, this is a significant gap in transparency.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is extremely concise and front-loaded, consisting of a single clear sentence with a helpful parenthetical translation. There is no wasted text, and it efficiently communicates the core purpose without unnecessary details, making it easy to parse quickly.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the complexity of a search tool with 4 parameters, no annotations, and no output schema, the description is incomplete. It lacks information on behavioral aspects (e.g., how results are returned, error cases), usage context compared to siblings, and any prerequisites or limitations. This makes it inadequate for an agent to fully understand how to invoke the tool effectively.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents all parameters (query, display, sort, start) with descriptions and constraints. The description adds no additional parameter semantics beyond what's in the schema, such as examples or usage tips. This meets the baseline of 3, as the schema handles the heavy lifting, but the description doesn't compensate or enhance understanding.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose: 'Perform a search on Naver Local' with the Korean translation for clarity. It specifies the verb 'search' and the resource 'Naver Local', making it understandable. However, it doesn't explicitly differentiate from sibling tools like search_blog or search_news, which also perform searches on Naver but on different platforms, leaving some ambiguity about when to choose this specific tool.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. With many sibling tools like search_blog, search_news, and search_shop, there is no indication of what makes Naver Local unique or when it should be preferred over other search tools. This lack of context makes it difficult for an agent to select the appropriate tool without additional information.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

search_newsC

Perform a search on Naver News. (네이버 뉴스 검색)

ParametersJSON Schema
NameRequiredDescriptionDefault
displayNoNumber of results to display (default: 10)
queryYesSearch query
sortNoSort method (sim: similarity, date: date)
startNoStart position of search results (default: 1)

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden. It states it performs a search but doesn't disclose behavioral traits like rate limits, authentication needs, result format, or whether it's read-only or has side effects. This is a significant gap for a tool with no annotation coverage.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is extremely concise with just two short phrases, front-loading the essential action and resource. There's no wasted language, and the bilingual note adds clarity without verbosity, making it highly efficient.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the lack of annotations and output schema, the description is incomplete. It doesn't explain what the search returns, potential limitations, or how it differs from siblings. For a search tool with no structured output information, more context is needed to be fully helpful.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema fully documents all parameters. The description adds no additional parameter information beyond what's in the schema, resulting in the baseline score of 3 where the schema does the heavy lifting.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the verb ('Perform a search') and resource ('on Naver News'), making the purpose immediately understandable. However, it doesn't differentiate from sibling tools like search_blog or search_webkr, which perform similar searches on different platforms, so it doesn't reach the highest score.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. With many sibling tools like search_blog and search_webkr available, there's no indication of what makes Naver News unique or when it's the appropriate choice, leaving usage unclear.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

search_shopC

Perform a search on Naver Shopping. (네이버 쇼핑 검색)

ParametersJSON Schema
NameRequiredDescriptionDefault
displayNoNumber of results to display (default: 10)
queryYesSearch query
sortNoSort method (sim: similarity, date: date)
startNoStart position of search results (default: 1)

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries full burden. It mentions 'Perform a search' but lacks behavioral details like rate limits, authentication requirements, pagination behavior, error handling, or what the search results look like. For a search tool with zero annotation coverage, this is a significant gap in transparency.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is extremely concise with just one sentence plus a parenthetical translation, front-loading the core purpose without any wasted words. Every element serves a clear purpose, making it efficient and well-structured.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given no annotations and no output schema, the description is incomplete for a search tool. It doesn't explain what the tool returns (e.g., result format, fields), behavioral constraints, or how it differs from sibling tools. The high schema coverage helps with parameters, but overall context is lacking for effective agent use.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema fully documents all 4 parameters (query, display, sort, start) with descriptions and defaults. The description adds no additional parameter semantics beyond what's in the schema, meeting the baseline of 3 for high schema coverage.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('Perform a search') and target resource ('Naver Shopping'), with the Korean translation adding specificity. However, it doesn't differentiate from sibling tools like search_blog or search_news that perform similar search operations on different platforms, missing explicit distinction.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus alternatives. With many sibling tools for different search types (e.g., search_blog, search_news, search_webkr), the description offers no context about appropriate use cases or exclusions, leaving the agent to infer based on tool names alone.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

search_webkrC

Perform a search on Naver Web Documents. (네이버 웹문서 검색)

ParametersJSON Schema
NameRequiredDescriptionDefault
displayNoNumber of results to display (default: 10)
queryYesSearch query
sortNoSort method (sim: similarity, date: date)
startNoStart position of search results (default: 1)

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden of behavioral disclosure. It states the tool performs a search, implying it's a read-only operation, but doesn't cover aspects like rate limits, authentication needs, error handling, or what the output looks like (e.g., result format, pagination). For a search tool with no annotation coverage, this leaves significant gaps in understanding its behavior.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is extremely concise and front-loaded, consisting of a single sentence with a clear purpose statement and a helpful Korean translation. There's no wasted text, and it efficiently communicates the core function without unnecessary details, making it easy to scan and understand quickly.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the complexity of a search tool with no annotations and no output schema, the description is incomplete. It doesn't explain what the tool returns (e.g., search results format, error responses) or address behavioral aspects like performance or limitations. With 4 parameters and many sibling tools, more context is needed to guide effective use, leaving gaps in overall understanding.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has 100% description coverage, with clear documentation for all four parameters (query, display, sort, start). The description doesn't add any additional meaning beyond what's in the schema, such as explaining the 'sim' and 'date' sort options further or providing usage examples. Since schema coverage is high, the baseline score of 3 is appropriate, as the schema does the heavy lifting.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose: 'Perform a search on Naver Web Documents' with the Korean translation for clarity. It specifies the verb 'search' and the resource 'Naver Web Documents,' making it easy to understand what the tool does. However, it doesn't explicitly differentiate from siblings like 'search_blog' or 'search_news,' which are also search tools on the same platform.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. With many sibling tools like 'search_blog,' 'search_news,' and 'search_academic,' it's unclear what makes 'search_webkr' unique or when it should be chosen over others. There's no mention of context, exclusions, or specific use cases.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. 19 tool updatesv1.0.0
    • First observeddatalab_search
    • First observeddatalab_shopping_by_age
    • First observeddatalab_shopping_by_device
    • First observeddatalab_shopping_by_gender
    • First observeddatalab_shopping_category
    • First observeddatalab_shopping_keyword_by_age
    • First observeddatalab_shopping_keyword_by_device
    • First observeddatalab_shopping_keyword_by_gender
    • First observeddatalab_shopping_keywords
    • First observedsearch_academic
    • First observedsearch_blog
    • First observedsearch_book
    • First observedsearch_encyc
    • First observedsearch_image
    • First observedsearch_kin
    • First observedsearch_local
    • First observedsearch_news
    • First observedsearch_shop
    • First observedsearch_webkr

TDQS

B3.4/5.0
Disambiguation4/5

The tools are clearly organized into two distinct groups: datalab trend analysis tools and search tools for different Naver services. Within each group, tools are differentiated by specific parameters like age, device, gender, or service type, making them mostly distinct. However, some datalab tools might overlap slightly in purpose (e.g., datalab_shopping_keywords and datalab_shopping_keyword_by_* variants), which could cause minor confusion.

Naming Consistency5/5

The naming follows a highly consistent pattern: all tools use snake_case with a clear prefix (datalab_ or search_) followed by a descriptive suffix (e.g., _search, _by_age, _blog). This consistency makes it easy to understand the tool's purpose and group at a glance, with no deviations in style or structure.

Tool Count4/5

With 19 tools, the count is on the higher side but reasonable for a server covering both search and trend analysis across multiple Naver services. It provides comprehensive coverage without being overwhelming, though it might feel slightly heavy compared to simpler servers. The tools are well-scoped to the domain of Naver's ecosystem.

Completeness5/5

The tool set appears complete for the server's purpose of accessing Naver search and trend data. It covers a wide range of Naver services (e.g., Blog, News, Shopping, Academic) with dedicated search tools, and the datalab tools provide detailed trend analysis across various dimensions (age, device, gender, category). There are no obvious gaps in coverage for the stated domain.

Maintenance

ActivitySlowing
ResponsivenessSyncing

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    C
    maintenance
    An MCP server that provides access to Naver OpenAPI services, enabling users to search blogs, news, books, images, and other content through standardized Model Context Protocol interfaces.
    114
    MIT
  • F
    license
    A
    quality
    C
    maintenance
    Naver Search API + Datalab API MCP server with 19 tools for Korean web search and trend analysis.
    19
    19
    -
  • F
    license
    C
    quality
    D
    maintenance
    이 MCP 서버는 네이버 쇼핑인사이트 API와 검색 API를 통합하여 카테고리 및 키워드 트렌드를 조회하고 블로그, 쇼핑, 지식iN, 백과사전 검색을 수행할 수 있게 해줍니다.
    12
    1
    -
  • A
    license
    A
    quality
    C
    maintenance
    An MCP server for the Naver Search Ad API that enables querying campaigns, ad groups, keywords, stats, keyword research, and bid estimates through any MCP client.
    19
    MIT

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/isnow890/naver-search-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server