serpapi-mcp

Umiejętność integrująca SerpAPI z Twoim agentem Claude poprzez protokół MCP. Pozwala na uruchamianie zapytań wyszukiwania internetowego z pełnym dostępem do wyników organicznych, pytań podobnych (PAA), pakietów wideo, grafiki i Knowledge Graph. Zwraca strukturyzowane dane JSON, które możesz dalej przetwarzać. Obsługuje wiele silników wyszukiwania (Google Light, Google pełny) i tryby wyświetlania (kompaktny, pełny). Opcjonalnie zapisuje każde zapytanie i odpowiedź w Airtable dla celów audytu i analizy.

1. Zainstaluj mcporter — narzędzie klienckie MCP wymagane do komunikacji z serwerem SerpAPI. Uruchom w terminalu: npm install -g mcporter, a następnie zweryfikuj instalację poleceniem mcporter --help.

2. Skonfiguruj klucz API SerpAPI. Ustaw zmienną środowiskową SERPAPI_API_KEY na Twój klucz, lub SERPAPI_API_KEYS jeśli chcesz skonfigurować kilka kluczy jako rezerwę (oddzielone przecinkami, próbowane w kolejności). Umieść zmienną w konfiguracji umiejętności lub w zmiennych globalnych agenta.

3. Użyj komendy /serp do wyszukiwania. Podstawowa składnia to /serp . Na przykład: /serp "ceny akcji AAPL" lub /serp site:cnmv.es "edukacja finansowa".

4. Dostosuj parametry wyszukiwania jeśli potrzebujesz. Możesz określić silnik (domyślnie google_light), liczbę wyników (domyślnie 5) i tryb wyświetlania (domyślnie compact). Przykład: /serp "hipoteka czy inwestycja" google 10 complete — ta komenda zwróci 10 wyników w trybie pełnym, włącznie z PAA i pakietami wideo.

5. Odbierz wyniki w formacie JSON. Umiejętność zwraca pełny payload SerpAPI na standardowe wyjście, które możesz natychmiast wykorzystać w logice agenta lub dalszych przetworzeniach.

6. Opcjonalnie włącz logowanie do Airtable. Jeśli chcesz archiwizować zapytania i odpowiedzi, skonfiguruj skrypt airtable_log.mjs — będzie automatycznie zapisywać surowy JSON i podsumowanie (top 10 wyników organicznych, pytania, wideo, grafika, liczniki) do Twojej tabeli Airtable.