Description

n8n-nodes-localfalcon

This is an n8n community node that lets you use Local Falcon in your n8n workflows.

Local Falcon is a local SEO rank tracking platform that helps businesses monitor their visibility in Google Maps, Apple Maps, and other local search platforms.

n8n is a fair-code licensed workflow automation platform.

Installation

Follow the installation guide in the n8n community nodes documentation.

Manual Installation

1. Install the package in your n8n installation:
“bash
npm install n8n-nodes-localfalcon
“

2. Restart your n8n instance

3. The Local Falcon node will now be available in the nodes panel

Operations

This node supports the following resources and operations:

Scan

• List Reports: List all scan reports with filtering
• Get Report: Retrieve scan report by key
• Run: Execute a new scan

Campaign


• List: List all campaigns
• Get Report: Get campaign report
• Create: Create a new automated campaign
• Run: Manually run a campaign
• Pause: Pause a campaign
• Resume: Resume a paused campaign
• Reactivate: Reactivate a finished campaign

Location


• List: List all saved locations
• Search: Search for business locations
• Save: Save a location to your account

Report


• List Competitor Reports: Get the list of competitor reports
• Get Competitor: Get competitor report
• List Trend Reports: Get the list of trend reports
• Get Trend: Get trend analysis
• List Keyword Reports: Get the list of keyword reports
• Get Keyword: Get keyword analysis
• List Location Reports: Get the list of location reports
• Get Location: Get location analysis

Scheduled Scan


• List: List all scheduled scans

Falcon Guard


• List Locations: List all Falcon Guard protected locations
• Get Falcon Guard Report: Get specific Falcon Guard Report
• Add Location: Add location to monitoring
• Pause: Pause monitoring
• Resume: Resume monitoring
• Delete: Remove from monitoring

Reviews Analysis


• List Reviews Analysis: Get the list of Reviews Analysis reports
• Get Reviews Report: Get reviews analysis report

Account


• Get Info: Get account information

Credentials


This node supports two authentication methods:

OAuth2 (Recommended)


OAuth2 is the default and recommended authentication method. It uses Local Falcon’s OAuth 2.0 authorization code flow with pre-configured application credentials — no manual setup required.

1. Add the Local Falcon node to your workflow
2. Select OAuth2 as the authentication method (selected by default)
3. Click Create New Credential under “Local Falcon OAuth2 API”
4. Click Sign in with Local Falcon to authorize via the OAuth consent screen
5. Once authorized, the credential is ready to use

API Key


You can also authenticate using a Local Falcon API key.

1. Generate your API key from the Local Falcon API Credentials page
2. Add the Local Falcon node to your workflow
3. Select API Key as the authentication method
4. Enter your API key in the credential configuration

Compatibility


Tested with n8n version 1.0.0 and above.

Usage


Basic Scan Example


1. Add the Local Falcon node to your workflow
2. Choose your authentication method (OAuth2 or API Key)
3. Select “Scan” as the resource
4. Select “Run” as the operation
5. Configure the scan parameters:
– Platform (Google, Apple Maps, etc.)
– Place ID
– Keyword
– Latitude/Longitude
– Grid size (3×3 to 21×21)
– Radius and measurement unit

Campaign Example


1. Add the Local Falcon node
2. Select “Campaign” as the resource
3. Select “Create” as the operation
4. Configure campaign settings including frequency (daily, weekly, monthly)

Resources


• n8n community nodes documentation
• Local Falcon API Documentation
• Local Falcon Website

Supported Platforms


• Google Maps
• Apple Maps
• ChatGPT
• Gemini / Gemini Advanced
• Google AI Overview (GIAO)
• Grok
• AI Mode

Features


• Grid-based rank tracking (3×3 to 21×21 grids)
• Configurable radius (0.1 to 100 miles/km)
• Automated campaigns with multiple frequencies
• Field masking for optimized API responses
• Pagination support
• AI-powered analysis integration
• Comprehensive reporting (competitors, trends, keywords, locations, reviews)

License


MIT

Version History


1.1.0


• Added OAuth2 authentication support (authorization code flow)
• OAuth2 is now the default authentication method
• API Key authentication remains supported as an alternative
• Pre-configured OAuth application credentials for seamless setup

1.0.0


• Initial release
• Support for all major Local Falcon API endpoints
• Full CRUD operations for scans, campaigns, locations
• Comprehensive reporting capabilities
• Falcon Guard integration

Support


For issues or questions:

• GitHub Issues
• n8n Community Forum
• Local Falcon Support