Naver Search MCP-Server

Dieser MCP-Server (Multi-Platform Communication Protocol) bietet Zugriff auf die Naver Search-APIs, sodass KI-Agenten auf Naver nach verschiedenen Arten von Inhalten suchen können.

Überblick

Suchen Sie nach Blogs, Nachrichten, Büchern, Bildern, Einkaufsartikeln und mehr
Mehrere Suchkategorien mit Paginierungsunterstützung
Strukturierte Textantworten, optimiert für die LLM-Nutzung
Auf Inhalte für Erwachsene prüfen
Tastatureingabefehler (Errata) konvertieren

Inhaltsverzeichnis

Aufstellen

Voraussetzungen

Python 3.12+
Anmeldeinformationen für die Naver Developer-API
- Sie können diese Anmeldeinformationen erhalten, indem Sie sich beim Naver Developers- Portal anmelden.
- Und Sie können auch meinen Blog Naver Search API MCP Server überprüfen.

Installation

Klonen Sie das Repository:

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

UV-Anlage

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

Erstellen Sie eine virtuelle Umgebung und installieren Sie Abhängigkeiten:

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

Erstellen Sie eine .env Datei mit Ihren Naver-API-Anmeldeinformationen:

cp env.example .env
vi .env

NAVER_CLIENT_ID=your_client_id_here
NAVER_CLIENT_SECRET=your_client_secret_here

Verwenden von Docker

Erstellen Sie das Docker-Image:

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

Führen Sie den Container aus:

docker run py-mcp-naver-search

Lokale Verwendung

Führen Sie den Server aus:

mcp run server.py

Führen Sie den MCP Inspector aus

mcp dev server.py

MCP-Einstellungen konfigurieren

Fügen Sie die Serverkonfiguration zu Ihrer MCP-Einstellungsdatei hinzu:

Claude Desktop-App

So installieren Sie es automatisch über Smithery :

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

Zur manuellen Installation öffnen Sie ~/Library/Application Support/Claude/claude_desktop_config.json

Fügen Sie dies zum mcpServers -Objekt hinzu:

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

Cursor-IDE

Öffnen Sie ~/.cursor/mcp.json

Fügen Sie dies zum mcpServers -Objekt hinzu:

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

für Docker

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

Verwenden des Clients

Das Repository enthält ein Client-Skript zum Testen:

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

Verfügbare Suchkategorien

Der Server unterstützt die folgenden Suchkategorien:

blog - Blogbeiträge
news - Nachrichtenartikel
book - Bücher
adult - Überprüfung auf Inhalte für Erwachsene
encyc - Enzyklopädieeinträge
cafe_article - Café-Artikel
kin - Wissen iN Q&A
local - Lokale Geschäftsinformationen
errata - Korrektur von Tastatureingabefehlern
shop - Einkaufsartikel
doc - Akademische Arbeiten und Dokumente
image - Bilder
webkr - Webdokumente

API-Referenz

Werkzeuge

Blog durchsuchen

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

Sucht mit dem angegebenen Schlüsselwort nach Blogs auf Naver.

News suchen

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

Sucht mit dem angegebenen Schlüsselwort nach Neuigkeiten auf Naver.

Buch suchen

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

Sucht mithilfe des angegebenen Schlüsselworts nach Buchinformationen auf Naver.

Überprüfen Sie die Erwachsenenabfrage

check_adult_query(query: str) -> str

Bestimmt, ob es sich bei der eingegebenen Abfrage um einen Suchbegriff für Erwachsene handelt.

Enzyklopädie durchsuchen

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

Sucht anhand des angegebenen Schlüsselworts nach enzyklopädischen Informationen zu Naver.

Cafe-Artikel suchen

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

Sucht mit dem angegebenen Schlüsselwort nach Café-Artikeln auf Naver.

Suche in KnowledgeiN

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

Sucht mit dem angegebenen Schlüsselwort nach „Knowledge iN Q&A“ auf Naver.

Lokale Suche

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

Sucht mit dem angegebenen Schlüsselwort nach lokalen Geschäftsinformationen.

Korrigieren Sie Errata

correct_errata(query: str) -> str

Konvertiert koreanische/englische Tastatureingabefehler.

Shop durchsuchen

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

Sucht auf Naver anhand des angegebenen Schlüsselworts nach Einkaufsproduktinformationen.

Dokument suchen

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

Sucht nach wissenschaftlichen Arbeiten, Berichten usw. anhand des angegebenen Schlüsselworts.

Bild suchen

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

Sucht nach Bildern anhand des angegebenen Schlüsselworts.

Webdokument durchsuchen

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

Sucht nach Webdokumenten anhand des angegebenen Schlüsselworts.

Ressourcen

Verfügbare Suchkategorien

GET naver://available-search-categories

Gibt eine Liste der auf diesem MCP-Server verfügbaren Naver-Suchkategorien zurück.

Antwortformat

Alle Tools geben Antworten im strukturierten Textformat zurück, optimiert für die LLM-Verarbeitung:

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

Danksagung

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert – Einzelheiten finden Sie in der Datei LICENSE.

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Bietet Zugriff auf Naver Search-APIs, sodass KI-Agenten in mehreren Kategorien (Blogs, Nachrichten, Bücher, Bilder, Einkaufsartikel usw.) mit strukturierten Antworten suchen können, die für die LLM-Nutzung optimiert sind.

Related MCP Servers

tavily-search
Tomatio13
-
security
A
license
-
quality
Tavily AI search API
Last updated -
1
26
Python
MIT License
MCP Tavily Search Server
spences10
A
security
A
license
A
quality
Integrates Tavily's search API with LLMs to provide advanced web search capabilities, including intelligent result summaries, domain filtering for quality control, and configurable search parameters.
Last updated -
3
64
9
JavaScript
MIT License
MCP JinaAI Search Server
spences10
A
security
A
license
A
quality
Enables efficient web search integration with Jina.ai's Search API, offering clean, LLM-optimized content retrieval with support for various content types and configurable caching.
Last updated -
1
22
3
JavaScript
MIT License
Tavily MCP Server with Proxy Support
tulong66
-
security
F
license
-
quality
Enables LLMs to perform sophisticated web searches through proxy servers using Tavily's API, supporting comprehensive web searches, direct question answering, and recent news article retrieval with AI-extracted content.
Last updated -
1
Python

View all related MCP servers