@local-falcon/n8n-nodes-localfalcon
v1.1.2
Published
n8n community node for Local Falcon API - Local SEO rank tracking and analysis
Readme
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
- Install the package in your n8n installation:
npm install n8n-nodes-localfalconRestart your n8n instance
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.
- Add the Local Falcon node to your workflow
- Select OAuth2 as the authentication method (selected by default)
- Click Create New Credential under "Local Falcon OAuth2 API"
- Click Sign in with Local Falcon to authorize via the OAuth consent screen
- Once authorized, the credential is ready to use
API Key
You can also authenticate using a Local Falcon API key.
- Generate your API key from the Local Falcon API Credentials page
- Add the Local Falcon node to your workflow
- Select API Key as the authentication method
- Enter your API key in the credential configuration
Compatibility
Tested with n8n version 1.0.0 and above.
Usage
Basic Scan Example
- Add the Local Falcon node to your workflow
- Choose your authentication method (OAuth2 or API Key)
- Select "Scan" as the resource
- Select "Run" as the operation
- Configure the scan parameters:
- Platform (Google, Apple Maps, etc.)
- Place ID
- Keyword
- Latitude/Longitude
- Grid size (3x3 to 21x21)
- Radius and measurement unit
Campaign Example
- Add the Local Falcon node
- Select "Campaign" as the resource
- Select "Create" as the operation
- Configure campaign settings including frequency (daily, weekly, monthly)
Resources
Supported Platforms
- Google Maps
- Apple Maps
- ChatGPT
- Gemini / Gemini Advanced
- Google AI Overview (GIAO)
- Grok
- AI Mode
Features
- Grid-based rank tracking (3x3 to 21x21 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
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:
