localfalcon

n8n community node for Local Falcon API - Local SEO rank tracking and analysis

Package Information

Released: 1 mo ago
Downloads: 24 weekly / 131 monthly
Latest Version: 1.1.8
Author: Pia Miranda

Available Nodes

Local Falcon icon
Local Falcon
Interact with Local Falcon API for local SEO rank tracking

Documentation

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:
npm install @local-falcon/n8n-nodes-localfalcon

  1. Restart your n8n instance

  2. 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 (3x3 to 21x21)
    • 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

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

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:

Discussion