mcpField
L
local-falcon-tool

local-falcon-tool

github.com/garrettjsmithマーケティング・グロース13663 回インストール11 週間前に更新
リポジトリ

local-falcon-tool について

Local Falconで地理グリッド上のローカル検索順位を分析し、トレンドレポート、定期スキャン、Falcon Guard、レビュー分析を扱うガイドです。継続監視と競合分析に利用できます。

主な機能

  1. 01地理グリッド順位スキャン
  2. 02過去の順位トレンドレポート
  3. 03定期スキャンキャンペーン
  4. 04Falcon Guardによるプロフィール変更監視
  5. 05レビューの感情とトピック分析

活用シーン

  1. 01サービス地域内の順位を追跡
  2. 02期間ごとの順位変化を比較
  3. 03複数のキーワードと地域を定期監視
  4. 04ビジネスプロフィールの不正な変更を検知

MCP 対応

このスキルはMCP経由でLocal Falconを利用し、既存レポートの確認、スキャンの実行、トレンド・競合・Falcon Guard・レビュー分析結果の取得を案内します。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/garrettjsmith/localseoskills --skill local-falcon-tool

インストール後、Claude Code で/local-falcon-toolを入力して読み込まれたか確認します。

詳細

Local Falcon ツール

注記： LocalSEOData（localseodata-tool）には、一度限りのランキングスキャンを実行するための geogrid_scan エンドポイントが追加されました。簡易監査や一度限りのスキャンには LocalSEOData を使用してください。トレンドレポート、定期キャンペーン、Falcon Guard のモニタリング、AI プラットフォームのスキャン（GAIO／ChatGPT／Gemini／Grok）には、引き続き Local Falcon が欠かせません。

MCP 経由で Local Falcon に直接アクセスできます。このスキルでは、各操作をいつ使うか、結果をどう扱うかを説明します。

Local Falcon と他のツールを使い分ける場面

必要なものLocal Falcon を使用代わりに使用
地域全体のランキング✅ ジオグリッドスキャン—
特定地点のランキング✅ 実行できますが、過剰な機能です簡易的なスポットチェックには SerpAPI
地域内の競合他社のランキング✅ 競合レポートが自動生成されます—
ランキングの経時的な推移✅ トレンドレポート—
変更の GBP モニタリング✅ Falcon Guard—
感情分析を伴うレビュー分析✅ Reviews Analysis—
キーワード検索ボリューム❌Semrush、Ahrefs、DataForSEO
被リンクデータ❌Ahrefs、Semrush
ウェブサイトのトラフィックデータ❌Google Analytics
技術的なサイト監査❌Screaming Frog

スキャンを実行する前に

必ず最初に既存のレポートを確認してください。 スキャンにはクレジットが必要です。作業が重複しないようにしてください。

Step 1: listAllLocalFalconLocations → Find the place ID
Step 2: listLocalFalconScanReports (filter by placeId + keyword) → Check if a recent scan exists
Step 3: Only run a NEW scan if no recent report exists or the user explicitly wants fresh data

主なワークフロー

新しいランキングスキャンを実行する

用途： 地域全体で、あるキーワードに対するビジネスのランキングを知りたい場合。

  1. ビジネスを検索する： listAllLocalFalconLocations — 名前または住所で検索します
    • 見つからない場合：searchForLocalFalconBusinessLocation → saveLocalFalconBusinessLocationToAccount
  2. スキャンのパラメーターをユーザーに確認する：
    • キーワード（顧客が検索する語句）
    • グリッドサイズ（下記のグリッド表を参照）
    • 半径（下記の半径表を参照）
    • プラットフォーム：google、apple、gaio、chatgpt、gemini、grok、aimode
    • AI 分析：はい／いいえ（Google のみ、推奨）
  3. 実行する： runLocalFalconScan — 「submitted」と表示され、ただちに応答が返ります
  4. 状況を確認する： listLocalFalconScanReports（placeId で絞り込み）— 30 秒ごとに確認します
  5. 取得する： 分析用のフィールドマスクを指定して getLocalFalconReport を実行します
  6. 解釈する： 結果の診断には geogrid-analysis スキルを使用します

分析に推奨されるフィールドマスク： report_key,date,place_id,keyword,location,arp,atrp,solv,found_in,total_competitors,grid_size,radius,measurement,ai_analysis,image,heatmap

既存のレポートを確認する

用途： 現在または最近のランキングについてユーザーから質問された場合、またはベースラインデータが必要な場合。

  1. フィルター（placeId、キーワード、日付範囲）を指定して listLocalFalconScanReports を実行します
  2. フィールドマスクには report_key,date,keyword,location.name,arp,atrp,solv,grid_size,platform を使用します
  3. 同じキーワードのレポートが複数ある場合は、トレンドを確認するために getLocalFalconTrendReport を実行します
ランキングの推移を追跡する

用途： ランキングが改善しているか、低下しているかを確認したい場合。

  1. listLocalFalconTrendReports（placeId とキーワードで絞り込み）を実行します
  2. getLocalFalconTrendReport — スキャン日ごとの過去の ARP、ATRP、SoLV が返されます
  3. 日付ごとに指標を比較し、最適化施策との関連を確認します

重要なポイント： トレンドレポートが存在するのは、設定が同一（placeId、キーワード、グリッドサイズ、半径、座標が同じ）のスキャンが 2 件以上ある場合に限られます。スキャンの設定が異なる場合、トレンドレポートは生成されません。

キャンペーンを実行する（定期スキャン）

用途： 定期的なスキャンを自動化したい場合。

  1. listLocalFalconCampaignReports — まず既存のキャンペーンを確認します
  2. createLocalFalconCampaign — キーワード、場所、頻度、グリッドサイズを設定します
  3. キャンペーンはスケジュールに従って自動的に実行されます
  4. getLocalFalconCampaignReport — 集計結果を取得します

キャンペーンと個別スキャンの違い： キャンペーンではデータが 1 つのレポートに集約されます。個別スキャンでは、トレンド、場所、キーワードごとに別々のレポートが生成されます。継続的なモニタリングにはキャンペーンを、単発の分析には個別スキャンを使用してください。

競合分析

タイミング： ユーザーが競合に負けているかを知りたい場合。

  1. スキャンごとに競合レポートが自動生成されます
  2. getLocalFalconCompetitorReports — 利用可能なレポートの一覧を取得します
  3. getLocalFalconCompetitorReport — ARP、ATRP、SoLV、レビュー、評価を含む上位競合を取得します
  4. fieldmask を使用します：date,keyword,grid_size,radius,businesses.*.name,businesses.*.place_id,businesses.*.arp,businesses.*.atrp,businesses.*.solv,businesses.*.reviews,businesses.*.rating
GBP の変更を監視する（Falcon Guard）

タイミング： ユーザーが GBP を不正な編集から保護したい場合。

  1. listLocalFalconGuardReports — 現在監視中の内容を確認します
  2. addLocationsToFalconGuard — 監視対象にロケーションを追加します
  3. getLocalFalconGuardReport — 変更履歴と指標を確認します（OAuth 接続済みロケーションの通話、クリック、ルート検索）
レビュー分析

タイミング： ユーザーが AI を活用したレビュー分析情報を求めている場合。

  1. listLocalFalconReviewsAnalysisReports — 既存の分析結果を確認します
  2. getLocalFalconReviewsAnalysisReport — センチメント分析、トピック、競合との比較の全データを取得します

グリッドサイズの選択

ビジネスタイプグリッドサイズ半径理由
コーヒーショップ、サロン、レストラン5×5 または 7×71-3 mi顧客は徒歩や車で短距離を移動します
歯科医、カイロプラクター、単一拠点の医療機関7×7 または 9×93-7 mi市内全域から集客します
HVAC、配管工、電気工9×9 または 11×117-15 miサービス提供エリアが広範囲です
病院グループ、フランチャイズチェーン13×13 または 15×1510-20 mi地域を広くカバーします
地方のビジネス7×7 または 9×915-30 mi広範囲ですが、人口密度は低い地域です

目安： グリッドサイズは、現実的なサービス提供エリアをカバーするように設定します。小さすぎると、実態より良い結果が出ます。大きすぎると、実態より悪い結果が出ます。

クレジットの確認

  • スキャンを実行する前に、必ずクレジットを確認します：viewLocalFalconAccountInformation
  • グリッドが大きいほど、必要なクレジットが増えます
  • キャンペーンでは、ロケーション × キーワード × 頻度の分だけ必要量が増えます
  • AI 分析を実行すると、スキャンごとにコストが加算されます
  • 結果がすでに存在するかを確認せずに、スキャンを再実行しないでください

次に行うこと

取得した内容次のアクションスキル
ARP/ATRP/SoLV を含むスキャン結果データを解釈し、問題を診断しますgeogrid-analysis
競合レポートのデータ競合の異なる点を分析しますlocal-competitor-analysis
下降傾向を示すトレンド判断ツリーを使って原因を診断しますgeogrid-analysis 診断ツリー
Guard で検出した GBP の変更不正な編集を確認し、元に戻しますgbp-optimization
レビュー分析の結果分析情報をもとにレビュー戦略を立てますreview-management

次のデフォルト手順： スキャン結果の数値をそのままユーザーに返してはいけません。必ず最初に geogrid-analysis を使って解釈してください。

コメント

Markdown 対応