ValueSerp MCP Server - Preisgünstige Google-Suche

Jul 22, 2025 — Stefan-Lucian Deleanu

Kommen wir zur Sache. Wenn Sie Claude für ernsthafte Anwendungen nutzen, sind Sie an die Wissensgrenze gestoßen. Die Trainingsdaten des Modells enden zu einem bestimmten Datum, und Sie müssen Ihren Kunden erklären, warum Ihr KI-Assistent denkt, es sei immer noch 2023 oder wann auch immer.

Der ValueSerp MCP-Server behebt dies, indem er Claude direkten Zugriff auf die Suchergebnisse von Google gewährt. Kein Web-Scraping, keine HTML-Parsing-Albträume – nur saubere API-Aufrufe, die strukturierte Daten zurückgeben.

Was Sie tatsächlich erhalten

Dies ist ein Model Context Protocol (MCP) Server, der als Brücke zwischen Claude und der Such-API von ValueSerp fungiert. Er bietet vier Suchendpunkte an:

google_search - Standard web search
google_news_search - News-specific results
google_images_search - Image search with filtering
google_videos_search - Video content search

Jeder Endpunkt gibt JSON-Daten zurück, die Claude analysieren und in Antworten verwenden kann. Keine iframe-Einbettungen, keine JavaScript-Ausführung – nur Daten.

Die technische Umsetzung

Der Server ist in TypeScript gebaut und verwendet das MCP SDK. Hier ist die Kernarchitektur:

// Client handles API communication
export class ValueSerpClient {
  private async makeRequest(endpoint: string, params: Record<string, any>): Promise<ValueSerpResponse> {
    const url = this.buildUrl(endpoint, params);
    const response = await fetch(url, {
      method: 'GET',
      headers: {
        'Accept': 'application/json',
        'User-Agent': 'ValueSerp-MCP-Server/1.0.0'
      }
    });
    // Error handling and response parsing
  }
}

Der interessante Teil ist die Parametervalidierung. Googles Such-API hat Dutzende von Parametern, und das Senden ungültiger Kombinationen führt zu kryptischen Fehlern. Der Server validiert alles, bevor Anfragen gestellt werden:


// Parameter validation with Zod schemas
const searchParamsSchema = z.object({
  q: z.string().describe("Search query (required)"),
  num: z.number().min(1).max(100).default(10).optional(),
  time_period: z.enum(["last_hour", "last_day", "last_week", "last_month", "last_year", "custom"]).optional(),
  // ... 20+ more parameters
});

Leistung und Einschränkungen

Lass uns über Zahlen sprechen, die wirklich wichtig sind:

Reaktionszeit: 200-000 ms je nach Komplexität der Abfrage
Ratenlimits: Hängt von Ihrem ValueSerp-Plan ab (typischerweise 1000-10000 Anfragen/Monat)
Ergebnisqualität: Wie bei Googles öffentlicher API – keine besonderen Zutaten
Geografische Zielgruppenansprache: Unterstützt alle Google-Domains und Standortparameter

Was es nicht tut:

JavaScript auf Ergebnisseiten ausführen
Umgehung von Bezahlschranken oder Anmeldeschranken
Cache-Ergebnisse (jede Abfrage trifft die API)
Authentifizierung für private Inhalte verwalten

Praktische Anwendungsfälle, die tatsächlich funktionieren

Vergiss den Unternehmensschwachsinn. Hier ist, wofür Entwickler das tatsächlich nutzen:

1. Technische Dokumentationsassistent


User: "What breaking changes were introduced in React 19?"
Claude: [Searches for recent React 19 documentation and changelog]
       "Based on the official React blog post from [actual date], React 19 introduces..."

Sicherheitsvorfallreaktion


User: "Check if CVE-2024-XXXXX affects our stack"
Claude: [Searches vulnerability databases and security advisories]
       "This CVE was published 3 hours ago. It affects Node.js versions..."

3. Automatisierung der Wettbewerbsanalyse


User: "What features did Competitor X announce this week?"
Claude: [Searches news and company blogs]
       "According to their blog post from Monday, they're launching..."

Einrichten ohne Unterstützung

Vorausgesetzt, Sie können grundlegende npm-Befehle ausführen:


# Clone and build
git clone https://github.com/valueserp/mcp-server
cd mcp-server
npm install && npm run build

# Set your API key
export VALUESERP_API_KEY=your_key_here

# Add to Claude config
# Edit: ~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "valueserp": {
      "command": "node",
      "args": ["/path/to/valueserp-mcp/dist/server.js"]
    }
  }
}

Erweiterte Parameterverwendung

Die wahre Kraft kommt aus den Kombinationen von Parametern. Das ist es, was die meisten Tutorials Ihnen nicht sagen werden:


// Time-boxed news search with duplicate filtering
await claude.use_tool('google_news_search', {
  q: 'kubernetes vulnerability',
  time_period: 'last_day',
  sort_by: 'date',
  show_duplicates: false,  // Requires sort_by: 'date'
  num: 50
});

// Location-specific results with auto-configuration
await claude.use_tool('google_search', {
  q: 'restaurant reviews',
  location: 'Tokyo, Japan',
  location_auto: true,  // Auto-sets gl, hl, and google_domain
  order_online: true    // Includes delivery/pickup data
});

// Academic image search
await claude.use_tool('google_images_search', {
  q: 'cell mitosis diagram',
  images_usage: 'non_commercial_reuse_with_modification',
  images_type: 'line_drawing',
  images_size: 'large'
});

Kostenanalyse

Seien wir transparent über die Wirtschaftlichkeit:

Suchenkosten: $0,0025 oder weniger (bei Plänen)
Gewinnschwelle: ~20 Suchen/Tag vs. manuelle Recherchezeit

Die meisten Alternativen für SERP sind teurer, was dies zu einer guten Wahl für Budgetbewusste macht, die bereit sind, mehr Latenz in Kauf zu nehmen.

Fehlerbehandlung und Randfälle

Der Server behandelt häufige Fehlermodi elegant:


// Built-in retry logic for transient failures
if (!response.ok) {
  const errorText = await response.text();
  throw new Error(`ValueSerp API error: ${response.status} ${response.statusText} - ${errorText}`);
}

// Parameter validation prevents most 400 errors
if (params.show_duplicates && params.sort_by !== 'date') {
  throw new ValidationError('show_duplicates requires sort_by=date');
}

Die Quintessenz

Dieses Tool macht eine Sache: Es gibt Claude Zugang zu aktuellen Suchergebnissen. Es ist nicht revolutionär, es ist keine "KI-gestützte Suche" – es ist einfach eine gut umgesetzte Brücke zwischen zwei Diensten.

Wenn Sie möchten, dass Claude über Ereignisse informiert wird, die nach seinem Trainingsstopp stattgefunden haben, funktioniert das. Wenn Sie jedoch interne Dokumente durchsuchen oder auf authentifizierte Inhalte zugreifen müssen, suchen Sie woanders.

Der Code ist auf GitHub unter GPL-3.0. Forken Sie ihn, verbessern Sie ihn oder beschweren Sie sich darüber – ganz nach Ihrer Wahl.

ValueSerp MCP Server - Preisgünstige Google-Suche