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
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:
- Führen Sie den MCP Inspector aus
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ägenews - Nachrichtenartikelbook - Bücheradult - Überprüfung auf Inhalte für Erwachseneencyc - Enzyklopädieeinträgecafe_article - Café-Artikelkin - Wissen iN Q&Alocal - Lokale Geschäftsinformationenerrata - Korrektur von Tastatureingabefehlernshop - Einkaufsartikeldoc - Akademische Arbeiten und Dokumenteimage - Bilderwebkr - 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.
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.