Сервер MCP поиска Naver

Этот сервер MCP (мультиплатформенный протокол связи) обеспечивает доступ к API поиска Naver, позволяя агентам ИИ искать различные типы контента в Naver.

Обзор

Поиск блогов, новостей, книг, изображений, товаров и многого другого
Несколько категорий поиска с поддержкой пагинации
Структурированные текстовые ответы, оптимизированные для потребления LLM
Проверить наличие контента для взрослых
Преобразование ошибок ввода с клавиатуры (errata)

Настраивать

Предпосылки

Питон 3.12+
Учетные данные API разработчика Naver
- Вы можете получить эти учетные данные, зарегистрировавшись на портале разработчиков Naver .
- Вы также можете проверить мой блог Naver Search API MCP Server .

Установка

Клонируйте репозиторий:

git clone https://github.com/jikime/py-mcp-naver-search.git
cd py-mcp-naver-search

УФ-установка

curl -LsSf https://astral.sh/uv/install.sh | sh

Создайте виртуальную среду и установите зависимости:

uv venv -p 3.12
source .venv/bin/activate
pip install -r requirements.txt

Создайте файл .env с вашими учетными данными API Naver:

cp env.example .env
vi .env

NAVER_CLIENT_ID=your_client_id_here
NAVER_CLIENT_SECRET=your_client_secret_here

Использование Докера

Создайте образ Docker:

docker build -t py-mcp-naver-search .

Запустите контейнер:

docker run py-mcp-naver-search

Использование локального

Запустите сервер:

mcp run server.py

Запустите MCP Inspector

mcp dev server.py

Настройте параметры MCP

Добавьте конфигурацию сервера в файл настроек MCP:

Приложение Клод для ПК

Для автоматической установки через Smithery :

npx -y @smithery/cli install @jikime/py-mcp-naver-search --client claude

Для ручной установки откройте ~/Library/Application Support/Claude/claude_desktop_config.json

Добавьте это к объекту mcpServers :

{
  "mcpServers": {
    "Google Toolbox": {
      "command": "/path/to/bin/uv",
      "args": [
        "--directory",
        "/path/to/py-mcp-naver-search",
        "run",
        "server.py"
      ]
    }
  }
}

Курсор IDE

открыть ~/.cursor/mcp.json

Добавьте это к объекту mcpServers :

{
  "mcpServers": {
    "Google Toolbox": {
      "command": "/path/to/bin/uv",
      "args": [
        "--directory",
        "/path/to/py-mcp-naver-search",
        "run",
        "server.py"
      ]
    }
  }
}

для Докера

{
  "mcpServers": {
    "Google Toolbox": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "py-mcp-naver-search"
      ]
    }
  }
}

Использование клиента

В репозиторий включен клиентский скрипт для тестирования:

# Basic search
uv run client.py blog "Python programming" display=5 page=1

# News search with sorting
uv run client.py news "AI" display=10 page=1 sort=date

# Image search with filtering
uv run client.py image "cat" display=10 filter=large

# Check for adult content
uv run client.py adult "your query"

# Errata correction
uv run client.py errata "spdlqj"

Доступные категории поиска

Сервер поддерживает следующие категории поиска:

blog - Записи в блоге
news - Новостные статьи
book - Книги
adult - проверка контента для взрослых
encyc - записи энциклопедии
cafe_article - Статьи о кафе
kin - Знания в вопросах и ответах
local - местная деловая информация
errata - Исправление ошибок ввода с клавиатуры
shop - Товары для покупок
doc - Научные статьи и документы
image - Изображения
webkr - Веб-документы

Ссылка на API

Инструменты

Поиск в блоге

search_blog(query: str, display: int = 10, page: int = 1, sort: str = "sim") -> str

Поиск блогов на Naver по заданному ключевому слову.

Поиск новостей

search_news(query: str, display: int = 10, page: int = 1, sort: str = "sim") -> str

Ищет новости на Naver по указанному ключевому слову.

Поиск книги

search_book(query: str, display: int = 10, page: int = 1, sort: str = "sim") -> str

Ищет информацию о книгах на Naver, используя заданное ключевое слово.

Проверить запрос для взрослых

check_adult_query(query: str) -> str

Определяет, является ли введенный запрос поисковым запросом для взрослых.

Поиск в энциклопедии

search_encyclopedia(query: str, display: int = 10, page: int = 1, sort: str = "sim") -> str

Ищет энциклопедическую информацию на Naver, используя заданное ключевое слово.

Поиск Кафе Статья

search_cafe_article(query: str, display: int = 10, page: int = 1, sort: str = "sim") -> str

Поиск статей о кафе на Naver по заданному ключевому слову.

Поиск Знаний

search_kin(query: str, display: int = 10, page: int = 1, sort: str = "sim") -> str

Выполняет поиск Knowledge iN Q&A на Naver по указанному ключевому слову.

Поиск по месту

search_local(query: str, display: int = 5, page: int = 1, sort: str = "random") -> str

Поиск информации о местном бизнесе по заданному ключевому слову.

Исправление опечаток

correct_errata(query: str) -> str

Преобразует ошибки ввода с клавиатуры на корейский/английский язык.

Поиск Магазин

search_shop(query: str, display: int = 10, page: int = 1, sort: str = "sim") -> str

Выполняет поиск информации о товаре на сайте Naver по заданному ключевому слову.

Поиск документа

search_doc(query: str, display: int = 10, page: int = 1) -> str

Поиск научных статей, отчетов и т. д. по заданному ключевому слову.

Поиск изображения

search_image(query: str, display: int = 10, page: int = 1, sort: str = "sim", filter: str = "all") -> str

Поиск изображений по заданному ключевому слову.

Поиск в веб-документе

search_webkr(query: str, display: int = 10, page: int = 1) -> str

Поиск веб-документов по заданному ключевому слову.

Ресурсы

Доступные категории поиска

GET naver://available-search-categories

Возвращает список категорий поиска Naver, доступных на этом сервере MCP.

Формат ответа

Все инструменты возвращают ответы в структурированном текстовом формате, оптимизированном для обработки LLM:

Naver Blog search results (total 12,345 of 1~10):

### Result 1
Title(title): Sample Blog Post
Link(link): https://blog.example.com/post1
Description(description): This is a sample blog post about...
Blogger name(bloggername): John Doe
Blogger link(bloggerlink): https://blog.example.com
Post date(postdate): 20250429

### Result 2
...

Благодарности

Лицензия

Данный проект лицензирован по лицензии MIT — подробности см. в файле LICENSE.

Integrations