Mattering Automations Local Falcon integration

Connect Local Falcon to Mattering Automations: geo-grid rank scans, scan, competitor, trend, keyword and location reports, campaigns, Falcon Guard, and reviews analysis as workflow steps and agent tools.

Get the credential Connect Verify Node reference Troubleshooting

The Mattering Automations Local Falcon integration covers the rank-tracking API in depth: run geo-grid scans around a business location, read scan, competitor, trend, keyword, and location reports, manage scheduled scans and recurring campaigns, protect listings with Falcon Guard, pull reviews analysis, and search or save locations.

Setup is your Local Falcon account API key. Report reads are free; scans and On-Demand calls bill against your Local Falcon credit balance, and grid size drives the cost of a scan.

Before you start

A Local Falcon account on a plan that includes API access.
A Mattering workspace with access to the Automations app.

Get your Local Falcon API key

The connector authenticates with your Local Falcon account API key, sent as an Authorization Bearer header so it stays out of request bodies and logs.

Generate or copy your API key.

Report reads are free. Scans, campaign runs, and On-Demand endpoints bill against your Local Falcon credit balance, and grid size drives the cost of a scan. The account info node returns your remaining credit balance so a workflow can check it before scanning.

Connect Local Falcon to Mattering

In Mattering Automations, open Connectors and click Add Connector.

Choose Local Falcon from the list.

Click Create new credential, paste your API key, and save. The credential is stored encrypted in Google Secret Manager.

Click Test Connection to confirm the key reaches your account, then Connect. The Local Falcon nodes appear in your canvas palette.

Verify it works

Open an automation canvas and drop the LF: Account Info node onto it, then run a test step: a successful response returns your account details and remaining credit balance, which confirms the key works without spending credits.

To read tracked data, use a report list node like LF: List Scan Reports and then LF: Get Scan Report with a report key. To create new data, LF: Run a Scan starts a geo-grid scan and consumes credits based on grid size.

Node reference

40 nodes, generated from the connector itself so this reference always matches what ships.

Read and query nodes 27

LF: Account Info

lf_get_account

View Account Information. Includes remaining credit balance.

LF: Calculate Grid Points

lf_grid_points

Calculate Grid Points from Base Coordinate

LF: Get Campaign Report

lf_get_campaign

Get Specific Campaign Report

LF: Get Competitor Report

lf_get_competitor_report

Get Specific Competitor Report

LF: Get Falcon Guard Report

lf_get_guard_report

Get Specific Falcon Guard Report

LF: Get Keyword Report

lf_get_keyword_report

Get Specific Keyword Report

LF: Get Knowledge Base Article

lf_get_kb_article

Get Single Article

LF: Get Location Report

lf_get_location_report

Get Specific Location Report

LF: Get Reviews Analysis Report

lf_get_review_report

Get Specific Reviews Analysis Report

LF: Get Scan Report

lf_get_scan_report

Get Specific Scan Report. Full grid result incl. per-point rankings; ai_analysis adds Falcon AI commentary.

LF: Get Trend Report

lf_get_trend_report

Get Specific Trend Report

LF: Keyword Search at a Point (On-Demand)

lf_point_search

Keyword Search at a Specific Coordinate Point. Billed per request on the On-Demand API.

LF: List Campaign Reports

lf_list_campaigns

List of All Campaign Reports

LF: List Competitor Reports

lf_list_competitor_reports

List of All Competitor Reports

LF: List Connected Locations

lf_list_locations

List All Connected Locations

LF: List Falcon Guard Reports

lf_list_guard_reports

List of All Falcon Guard Reports

LF: List Keyword Reports

lf_list_keyword_reports

List of All Keyword Reports

LF: List Location Groups

lf_list_location_groups

List All Location Groups

LF: List Location Reports

lf_list_location_reports

List of All Location Reports

LF: List Reviews Analysis Reports

lf_list_review_reports

List of All Reviews Analysis Reports

LF: List Scan Reports

lf_list_scan_reports

List of All Scan Reports

LF: List Scheduled Scans

lf_list_autoscans

List all Scheduled Scans

LF: List Trend Reports

lf_list_trend_reports

List of All Trend Reports

LF: Ranking at a Point (On-Demand)

lf_point_ranking

Get Business Ranking at Specific Coordinate Point. Billed per request on the On-Demand API.

LF: Search Business Locations

lf_search_locations

Search for a Business Location

LF: Search GBP Places (On-Demand)

lf_places_search

Search for Google My Business Locations

LF: Search Knowledge Base

lf_search_kb

Search / List Articles

Action nodes 13

LF: Create Campaign

lf_campaign_create

Create a Campaign. Starts RECURRING credit-spending scans; pair with pause. No API delete exists.

LF: Edit Campaign

lf_campaign_update

Edit a Campaign

LF: Full Grid Scan (On-Demand)

lf_full_grid_scan

Run a Full Grid Search. Billed per request on the On-Demand API; grid size drives cost.

LF: Guard - Pause Protection

lf_guard_pause

Pause Location Protection

LF: Guard - Protect Location

lf_guard_add

Add location(s) to Falcon Guard

LF: Guard - Remove Protection

lf_guard_remove

Remove Location Protection

LF: Guard - Resume Protection

lf_guard_resume

Resume Location Protection

LF: Pause Campaign

lf_campaign_pause

Pause a Campaign

LF: Reactivate Campaign

lf_campaign_reactivate

Reactivate a Campaign

LF: Resume Campaign

lf_campaign_resume

Resume a Campaign

LF: Run Campaign Now

lf_campaign_run

Manually Run a Campaign. Consumes credits for every location/keyword in the campaign.

LF: Run a Scan

lf_run_scan

Run a Scan. Consumes account credits per scan (grid size drives cost).

LF: Save Location to Account

lf_add_location

Save a Business Location to Account. No API delete exists; remove saved locations in the Local Falcon UI.

Using the integration

On the automation canvas

Run grid scans, read scan, competitor, trend, and location reports, manage campaigns and Falcon Guard, and pull reviews analysis, then feed the results into the rest of a workflow: write grid ranks to a Mattering database, open tasks when a point drops, or hand a report to an AI step.

The generic request node

An advanced Local Falcon request node can call any documented API path your account can access, so endpoints beyond the typed nodes stay reachable without waiting on a connector update.

From AI assistants over MCP

Every node speaks MCP, the open protocol for connecting AI assistants to tools. Claude, ChatGPT, and Matter can run local rank research through the same nodes your workflows use and chain them into multi-step analysis.

Troubleshooting

A node returns an authentication error

Confirm you pasted the API key from your Local Falcon account under Settings, then API, and that your plan includes API access. The key is sent as an Authorization Bearer header; a plan without API access will reject it.

A scan or campaign node fails citing insufficient credits

Scans, campaign runs, and On-Demand calls spend Local Falcon credits, and grid size drives the cost. Run the account info node first to read your remaining balance, and reduce the grid size or top up credits before scanning.

There is no node to delete a campaign or a saved location

Local Falcon's API has no delete for campaigns or saved locations, so those nodes are intentionally absent. Pause a campaign from a workflow, and remove saved locations or campaigns in the Local Falcon UI. Falcon Guard protection can be paused, resumed, or removed through the API.

A scan takes too long to return in a single step

A full grid scan can take time to complete. Use the eager option on the run scan node to return within a short window, or split the flow: start the scan, then read the scan report in a later scheduled step once it has finished.

Saving an Apple location is rejected

Apple locations require the location name and the center latitude and longitude in addition to the place ID. Provide those fields on the save location node when the platform is set to Apple.

The Local Falcon MCP

What connecting Local Falcon unlocks for AI agents and automations, with common uses and FAQs.

More guides

All Automations documentation

Every integration guide, plus how connectors, credentials, and workflows fit together.

Local Falcon is a trademark of its respective owner. Mattering uses platform names to identify the services these integrations connect to; no endorsement or affiliation is implied.