mcpField
G
google-reviews

google-reviews

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

google-reviews について

DataForSEO API を使うスクリプトで、Google Maps の評価、クチコミ数、評価分布、店舗情報を取得するスキルです。単一店舗と複数店舗の検索に対応し、クチコミの確認や比較に使えます。

主な機能

  1. 01評価とクチコミ数の取得
  2. 02評価分布と店舗情報の取得
  3. 03単一店舗または複数店舗の検索
  4. 04JSON 出力と一括検索テーブル
  5. 05場所を指定した店舗検索

活用シーン

  1. 01店舗の Google Maps クチコミ確認
  2. 02複数店舗の評価比較
  3. 03レポート用クチコミデータの収集

インストール

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

$npx skills add https://github.com/openclaudia/openclaudia-skills --skill google-reviews

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

詳細

Google Reviews

DataForSEO API を使用して、あらゆるビジネスの Google マップの評価、レビュー件数、評価の分布を取得します。

このスキルを使用するタイミング

次のような場合に、このスキルを使用します。

  • ビジネスの Google レビューを確認したい場合
  • 複数のビジネスの評価を比較したい場合
  • レポートや分析用に Google のレビュー件数が必要な場合
  • ビジネスの Google マップでの掲載状況について質問された場合
  • 競合他社のレビューを調査したい場合

ツールの場所

グローバルツールディレクトリ：~/.agents/tools/

  • スクリプト：~/.agents/tools/fetch-google-reviews.js
  • 認証情報（推奨）：環境変数の AISA_ONE_API_KEY — aisa.one 経由でプロキシします
  • 認証情報（代替）：環境変数の DATAFORSEO_LOGIN と DATAFORSEO_PASSWORD — DataForSEO に直接接続します。スクリプトは、どちらが設定されているかを自動検出します。

使用方法

単一のビジネス
cd ~/.agents/tools && node fetch-google-reviews.js "Business Name" "City,Province,Country"

例：

cd ~/.agents/tools && node fetch-google-reviews.js "Trust Auto Sales" "Richmond,British Columbia,Canada"
バッチモード

ビジネスの配列を含む JSON ファイルを作成してから、次を実行します。

cd ~/.agents/tools && node fetch-google-reviews.js --batch /path/to/businesses.json

JSON ファイルの形式：

[
  {"keyword": "Business One", "location": "Vancouver,British Columbia,Canada"},
  {"keyword": "Business Two"}
]
  • keyword（必須）：検索するビジネス名
  • location（任意）：デフォルトは「Richmond,British Columbia,Canada」です

出力

単一のビジネス（JSON）
{
  "keyword": "Trust Auto Sales",
  "title": "Trust Auto Sales",
  "rating": 4.2,
  "reviews": 677,
  "rating_distribution": {"1": 117, "2": 7, "3": 3, "4": 19, "5": 531},
  "address": "3691 Number 3 Rd, Richmond, BC V6X 2B8",
  "category": "Car dealer",
  "url": "https://trustauto.ca/"
}
バッチモード

Markdown テーブルの後に完全な JSON を出力します。

| Business | Rating | Reviews | Address |
|----------|--------|---------|---------|
| Trust Auto Sales | 4.2 | 677 | 3691 Number 3 Rd, Richmond, BC V6X 2B8 |

場所の形式

DataForSEO の場所の形式を使用します：City,Province/State,Country

例：

  • Richmond,British Columbia,Canada
  • Vancouver,British Columbia,Canada
  • Toronto,Ontario,Canada
  • New York,New York,United States

API の詳細

  • DataForSEO の business_data/google/my_business_info/live エンドポイントを使用します
  • AISA_ONE_API_KEY が設定されている場合は、aisa.one プロキシ（api.aisa.one/apis/v1/dataforseo/...、Bearer 認証）経由で接続します。そうでない場合は、DataForSEO に直接接続（api.dataforseo.com/v3/...、Basic 認証）します
  • 同期処理です（結果をすぐに返します）
  • キーワードと場所に一致する最初のビジネスを返します
  • バッチモードでは、レート制限を回避するため、リクエスト間に 200ms の遅延を追加します

重要な注意事項

  • まだ npm install を実行していない場合：cd ~/.agents/tools && npm install
  • スクリプトはローカルの .env と環境変数の両方から認証情報を読み込みます
  • DataForSEO では API 呼び出しごとに料金が発生するため、大規模なバッチではご注意ください

コメント

Markdown 対応