Lokaler Falcon MCP-Server

Ein MCP-Server (Model Context Protocol) für die Local Falcon API , implementiert in TypeScript unter Verwendung des offiziellen MCP SDK. Dieser Server stellt Local Falcon-Berichtsfunktionen als MCP-Tools bereit und ermöglicht die Integration in agentenbasierte KI-Systeme und Workflows.

Voraussetzungen

• Node.js (installieren Sie die LTS-Version)

Erste Schritte in Claude Desktop

1. Erstellen Sie ein neues Verzeichnis für den MCP-Server und installieren Sie das Paket.

2. Kopieren Sie den Pfad zum installierten npm-Modul und fügen Sie ihn den Argumenten in der Datei mcp.json hinzu. Achten Sie dabei darauf, dass er auf die Datei index.js unter /dist verweist.

3. Fügen Sie Ihren API-Schlüssel zur Umgebung in der Datei mcp.json hinzu.

Related MCP server: Google Search Console MCP

Ausführung über STDIO

Verwenden Sie für MacOS/Unix das folgende Format:

Verwenden Sie für Windows das folgende Format:

Ausführung über SSE über ein STDIO-Gateway

Verwenden Sie für alle Plattformen das folgende Format:

Pro-Benutzer

Für Claude Max/Team-Benutzer wird ein höheres MCP-Tool-Aufruflimit freigeschaltet. Dies muss durch Anhängen von is_pro=true an die Abfragezeichenfolge der URL aktiviert werden. Beispiel:

Ausführung über Claude Integrations (SSE)

Bei Verbindung mit Claude-Integrationen:

1. Benennen Sie den Server Local Falcon MCP

2. Fügen Sie die folgende URL hinzu: https://mcp.localfalcon.com/sse?local\_falcon\_api\_key=YOUR\_API\_KEY\_HERE

Werkzeugliste

• listLocalFalconScanReports: Ruft eine Liste aller Scan-Berichte ab, die von Ihrem lokalen Falcon-Konto durchgeführt wurden.

• listLocalFalconTrendReports: Ruft eine Liste aller Trendberichte ab, die von Ihrem lokalen Falcon-Konto durchgeführt wurden.

• listLocalFalconAutoScans: Ruft eine Liste aller automatischen Scans ab.

• listAllLocalFalconLocations: Ruft eine Liste aller Standorte ab.

• listLocalFalconLocationReports: Ruft eine Liste aller Standortberichte ab.

• getLocalFalconLocationReport: Ruft einen einzelnen Standortbericht ab. Ein Standortbericht sieht wie folgt aus: https://www.localfalcon.com/reports/location/view/c60c325a8665c4a , wobei c60c325a8665c4a der Berichtsschlüssel ist.

• getLocalFalconReport: Ruft einen einzelnen Local Falcon-Scanbericht mit einem Berichtsschlüssel ab. Liest nur die KI-Analyse des zurückgegebenen Berichts. Andernfalls ist die KI-Analyse nicht vorhanden. Benutzer können den Berichtsschlüssel auch im Format https://www.localfalcon.com/reports/view/0b38313fa35c37f eingeben, wobei 0b38313fa35c37f der Berichtsschlüssel ist.

• getLocalFalconTrendReport: Ruft einen einzelnen Local Falcon-Trendbericht ab. Ein Trendbericht sieht wie folgt aus: https://www.localfalcon.com/reports/trend/view/95290829819f6e8 , wobei 95290829819f6e8 der Berichtsschlüssel ist.

• listLocalFalconKeywordReports: Ruft eine Liste aller Keyword-Berichte ab. Ein Keyword-Bericht sieht wie folgt aus: https://www.localfalcon.com/reports/keyword/view/754ffcb0f309938 , wobei 754ffcb0f309938 der Berichtsschlüssel ist.

• getLocalFalconKeywordReport: Ruft einen einzelnen Local Falcon-Schlüsselwortbericht ab.

• getLocalFalconGrid: Eine Hilfsmethode zum Erstellen eines lokalen Falcon-Rasters.

• getLocalFalconGoogleBusinessLocations: Ruft lokale Falcon Google Business-Standorte ab.

• getLocalFalconRankingAtCoordinate: Ruft Suchergebnisse am angegebenen Koordinatenpunkt ab und ruft Rankingdaten für das angegebene Unternehmen ab.

• getLocalFalconKeywordAtCoordinate: Ruft Suchergebnisse am angegebenen Koordinatenpunkt ohne Rangvergleichsdaten ab.

• runLocalFalconFullGridSearch: Ruft eine vollständige Rastersuche mit dem übergebenen Schlüsselwort oder Suchbegriff ab, um eine Übereinstimmung mit dem angegebenen Unternehmen zu erzielen.

• getLocalFalconCompetitorReports: Ruft eine Liste aller Wettbewerberberichte in Ihrem Local Falcon-Konto ab.

• getLocalFalconCompetitorReport: Ruft bis zu 20 Konkurrenzunternehmen aus einem bestimmten Konkurrenzbericht von Ihrem Local Falcon-Konto ab.

• listLocalFalconCampaignReports: Ruft eine Liste aller Standortberichte in Ihrem Local Falcon-Konto ab.

• getLocalFalconCampaignReport: Ruft einen vollständigen Bericht einer Kampagne von Ihrem Local Falcon-Konto ab.

• listLocalFalconGuardReports: Ruft eine Liste aller Falcon Guard-Berichte in Ihrem lokalen Falcon-Konto ab.

• getLocalFalconGuardReport: Ruft einen vollständigen Bericht eines Falcon Guard-Berichts von Ihrem lokalen Falcon-Konto mit einer angegebenen Place_ID ab.

Für Entwickler

• Build (erforderlich zum Ausführen in lokalen MCP-Hostanwendungen):

  bun run build

• Führen Sie MCP Inspector aus:

  bun run inspector

• Führen Sie den MCP-Server aus:

  Führen Sie einen der folgenden Schritte aus:

  bun run start bun run start:sse bun run start:stdio

  Hinweis: Wenn SSE nicht angegeben ist, verwendet der Server standardmäßig stdio.

Lizenz

MIT

Danksagung

• Lokale Falcon-API

• Modellkontextprotokoll (MCP)

• Brötchen