OpenGMB

OpenGMB

OpenGMB は、Google ビジネス プロフィールを管理するためのオープンソースソフトウェアです。レビュー、投稿、プロフィールの編集、承認、パフォーマンス、レポート、順位追跡に対応しています。このリポジトリはコミュニティ版です。ご自身のサーバーで実行し、ご自身の API キーを使用します。1 つのオーナーログインで、必要な数のクライアントと店舗を管理できます。

公式の Google ビジネス プロフィール API を使用します。オーナーが管理する 1 つの設定を除き、担当者の承認なしに公開されることはありません。投稿とプロフィールの編集には、常に承認が必要です。レビューへの返信も承認が必要ですが、オーナーが星 4 または 5 のレビューに対する自動承認を有効にした場合は除きます。星 1〜3 のレビューへの返信には、常に担当者の承認が必要です。ルールは、承認前にすべての返信、投稿、編集をチェックします。

OpenGMB は Synectus が開発しています。Google との提携関係はなく、Google による推奨も受けていません。

コミュニティ版に含まれる機能

• 1 つのオーナーログインで、複数のクライアントと店舗を管理でき、店舗グループにも対応します。
• 投稿、レビュー、レビューへの返信、承認受信箱に加え、承認前にテキストをチェックするガードレールルールに対応します。
• パフォーマンスデータ、レポート、クライアントと共有できるレポートリンクを利用できます。
• レポートのホワイトラベルブランディングに対応します。
• ご自身の DataForSEO アカウントを使用した、ジオグリッドと順位追跡に対応します。
• ご自身の Anthropic キーを使用した、AI の下書きと提案に対応します。クレジットはありません。
• MCP サーバーと API トークンがあり、Claude やその他の MCP クライアントからプロフィールを操作できます。トークンは読み取り専用、または読み書き可能です。
• REST API（v1）、Webhook、Zapier アプリのソースコードを利用できます。
• QR コード付きのレビュー依頼リンクと、公開店舗ページに対応します。
• 2 要素サインインと監査ログに対応します。

サインアップページ、課金システム、クレジットシステムはありません。初回起動時に、env ファイルでオーナーのメールアドレスとパスワードを設定します。

このリポジトリに含まれないもの

OpenGMB はオープンコアです。ホスト版の OpenGMB では、チームとロール、クライアントポータル、月次クレジットプランによる課金、カスタムドメイン、マネージドサービスが追加されます。マネージドサービスでは、サーバー、Google との接続、アップデートを当社が管理します。ご自身でサーバーを運用したくない場合は、こちらをご利用ください。

クイックスタート

Docker Engine 24 以降と Compose プラグイン、イメージのビルド中に使用できる約 4 GB の空き RAM が必要です。Google サインインを利用する場合は、公開 HTTPS ホスト名も必要です。

cd deploy/selfhost
cp .env.example .env     # fill in the required values; the comments explain each one
docker compose up -d --build

初回起動前に、.env で OWNER_EMAIL と OWNER_PASSWORD を設定してください。その後、http://localhost:8080（または WEB_URL）を開いてサインインします。2 要素サインインが必須です。初回サインイン時に、アプリから認証アプリの登録を求められ、バックアップコードが一度だけ表示されるため、保存してください。Google クライアントは初期設定で mock モードになっています。Settings、Google の順に開き、「Use the sample Google account」を押すと、サンプルの店舗をインポートして、Google のキーを使わずにアプリを試すことができます。.env を変更した後は、再度 docker compose up -d を実行してください（restart では古い環境設定が維持されます）。本番運用を開始するには、ご自身の Google Cloud プロジェクトで Business Profile API の利用承認を Google から得る必要があります。申請はご自身で行い、承認には数日かかる場合があります。SETUP.md にすべての手順が記載されています。

このリポジトリの内容

パス	内容
apps/web	Next.js アプリ
apps/mcp	MCP サーバー（Streamable HTTP）
apps/worker	バックグラウンドジョブ：レビュー同期、公開、レポート、Pub/Sub プッシュ
packages/core	認証、テナント管理、監査ログ、アクションレジストリ、Google クライアント、ガードレールルール
packages/db	Drizzle スキーマとマイグレーション（Postgres）
deploy/selfhost	セルフホスト用スタック（Docker Compose）：OpenGMB の実行に使用します
integrations/zapier	Zapier アプリのソースコード

リポジトリのルートにある docker-compose.yml は、コントリビューター向けの開発用 Postgres のみを起動します。セルフホスト用スタックではありません。deploy/selfhost にあるものを実行してください。

内部パッケージ名には @opengmb/ プレフィックスを使用します。

コントリビュートと問題の報告

プルリクエストを作成する前に、CONTRIBUTING.md をお読みください。脆弱性は SECURITY.md の説明に従って、非公開で報告してください。

ライセンス

コードは MIT ライセンスの下で公開されています。LICENSE を参照してください。サードパーティに関する通知は THIRD_PARTY_NOTICES.md に記載されています。

商標

ライセンスの対象はコードです。OpenGMB の名称やロゴは対象外であり、Synectus Private Limited の商標です。そのため、フォークには独自の名称とロゴが必要です。TRADEMARKS.md を参照してください。