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

Related MCP server: KiMCP

Inhaltsverzeichnis

• Voraussetzungen

• Installation

• MCP-Einstellungen konfigurieren

• API-Referenz

• Danksagung

• Lizenz

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

1. Klonen Sie das Repository:

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

2. UV-Anlage

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

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

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

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

1. Erstellen Sie das Docker-Image:

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

2. Führen Sie den Container aus:

docker run py-mcp-naver-search

Lokale Verwendung

1. Führen Sie den Server aus:

mcp run server.py

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

1. So installieren Sie es automatisch über Smithery :

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

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

1. blog - Blogbeiträge

2. news - Nachrichtenartikel

3. book - Bücher

4. adult - Überprüfung auf Inhalte für Erwachsene

5. encyc - Enzyklopädieeinträge

6. cafe_article - Café-Artikel

7. kin - Wissen iN Q&A

8. local - Lokale Geschäftsinformationen

9. errata - Korrektur von Tastatureingabefehlern

10. shop - Einkaufsartikel

11. doc - Akademische Arbeiten und Dokumente

12. image - Bilder

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

• Naver Search API MCP Server Blog

• Naver Open API

• MCP-Protokoll

Lizenz

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