serpapi-mcp

Run SerpAPI searches via SerpAPI's MCP server using mcporter. Use when the user asks to search the web with SerpAPI/SerpAPI MCP, wants SerpAPI inside Clawdbot, or to use the /serp command.

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.