Listings API

Listings API MCP

MCP に対応したあらゆる AI アシスタントを Listings API に接続し、50 以上のディレクトリ、マップ、検索エンジンにわたるビジネスリスティング、レビュー、投稿、ローカル分析を管理できます。

ウェブサイト · API ドキュメント · MCP ページ · Claude ディレクトリ · API キーを取得 · Apify アクター

---

Listings API とは

ローカル検索はビジネスデータを基盤としています。店舗、クリニック、フランチャイズ店には、名称、住所、電話番号、営業時間、カテゴリー、写真があり、検索エンジンが十分な信頼を寄せて順位付けするには、そのデータを Google、Apple Maps、Bing、Facebook、Yelp、音声アシスタント、さらに多数の小規模なディレクトリで同一に保つ必要があります。このデータを手作業で一貫させる方法では、数店舗を超えると対応できません。

Listings API は、この業務を担う REST API です。各拠点の情報を一度登録すると、API が 50 を超える掲載先に同期し、各リスティングの掲載状況を追跡し、重複を検出して抑制します。また、それらのリスティングに寄せられたレビューを取得して返信できるほか、接続済みプロフィールへの投稿やオファーの公開、Google、Facebook、Bing が返すパフォーマンスデータの取得もできます。代理店、多拠点ブランド、フランチャイズ事業者は、これを使って数百から数千の拠点のローカルプレゼンスを一元管理しています。

この MCP サーバーについて

Model Context Protocol を使うと、AI アシスタントから外部ツールを呼び出せます。このサーバーは Listings API を MCP ツールとして公開するため、Claude、Cursor、Windsurf、Gemini CLI、Cline などのアシスタントが、自然な会話を通じて、ユーザー自身のアカウントとデータを使用しながら、拠点の検索、レビューの閲覧、返信の作成と公開、投稿のスケジュール設定、分析データの取得を行えます。

これはリモートサーバーです。https://listingsapi.com/mcp で実行され、Streamable HTTP を使用します。ローカルサーバーパッケージやビルドは不要です。クライアントから URL を指定し、OAuth のブラウザーフローでサインインするか、クライアントでヘッダーが必要な場合は既存の API キーを使用してください。

https://listingsapi.com/mcp

ディレクトリで探す

同じサーバーが以下のディレクトリにも掲載されています。お使いのクライアントが対応しているディレクトリからインストールできます。

ディレクトリ	掲載先
Claude	claude.ai/directory/listings-api
公式 MCP レジストリ	com.listingsapi/mcp
Cursor	cursor.directory/plugins/listings-api
Glama	glama.ai/mcp/connectors/com.listingsapi/mcp
Smithery	smithery.ai/servers/support-hxau/listingsapi
MCP.so	mcp.so/servers/listings-api
mcpservers.org	mcpservers.org/servers/listings-api/listingsapi-mcp

このリポジトリのエージェントスキルは別途掲載されています。エージェントスキルをご覧ください。

できること

接続すると、アシスタントはアカウントの次の5つの領域で作業できます。

ロケーション。 ロケーションのプロフィールを作成、更新し、ロケーションを検索して詳細を確認できます。ロケーションは、各パブリッシャーのリスティングで使用されるマスターレコードです。

リスティングとサイテーション。 現在どのパブリッシャーにロケーションが掲載されているか、各リスティングの状態を確認できます。プランの対象サイト一覧を表示したり、ネットワークが特定のロケーションまたはアカウント全体について検出した重複リスティングを取得したりできます。また、リスティングに重複のマークを付けて非表示にしたり、誤判定の場合はそのマークを解除したりできます。音声アシスタントの掲載状況は別途報告されます。

レビュー。 レビューを読み、IDを指定して特定のレビューを取得し、レビュー分析を確認できます。また、接続先のパブリッシャーが対応している場合は返信を公開できます。公開した返信はレビューサイトに表示されます。

投稿。 既存の投稿を読み、接続済みの対応プロフィールに投稿を公開できます。対応しているパブリッシャーとペイロードについては、現在のツールの仕様を確認してください。

分析。 任意のロケーションについて、Google、Facebook、Bingのパフォーマンスを確認できます。検索表示回数、マップ表示回数、ルート検索数、通話数、ウェブサイトのクリック数などを、指定した期間で取得できます。

GoogleまたはFacebookアカウントの連携、プロフィールとロケーションの照合、Google ビジネス プロフィールのリスティングがないロケーションへの新規作成に対応する、接続済みアカウントの操作も用意されています。

ロケーションのアーカイブや投稿の削除などの破壊的な操作は、MCP ツールとして公開されていません。現在利用可能な操作を確認するには、MCP guideとサーバーのドキュメントツールを使用してください。

リクエストの例

サーバーに接続すると、アシスタントに次のようなことを依頼できます。

• 「テキサス州にあるすべてのロケーションを一覧表示して、電話番号が登録されていないものを教えてください。」
• 「全店舗から、先週の星3つ未満のレビューをすべて表示し、ロケーションごとにまとめてください。」
• 「オースティン店の最新のGoogleレビューへの返信を60語以内で下書きして、投稿してください。」
• 「北東部地域のすべてのロケーションに、整備料金が20％オフになるキャンペーン投稿を公開してください。期間は月末までです。」
• 「今月の上位10店舗について、先月と比べたルート検索数と通話数を比較してください。」
• 「Google ビジネス プロフィールのリスティングがまだないロケーションはどこですか？」

必要なもの

ListingsAPI アカウントが必要です。本番環境での利用については、プランと登録をご覧ください。または、以下でDay Passの利用可否を確認してください。OAuth対応クライアントを使うと、設定ファイルにAPIキーをコピーせずにサインインできます。

1日パスで無料でお試しください

登録前にリアルタイムの利用状況を確認してください。Day Pass は期間限定で提供されます。open が true の間は、Day Pass の登録から無料の24時間サンドボックスを有効化できます。最大2か所に対応し、ListingsAPI のデモディレクトリ10件と同期します。実際の掲載先に書き込むことはありません。レビュー、投稿、ソーシャル、分析、接続済みアカウント、Webhook は対象外です。

登録時には、氏名、メールアドレス、会社名の入力と、利用規約およびプライバシーポリシーへの同意が必要です。メールで届くリンクまたは6桁のコードからパスを有効化すると、24時間のカウントが始まります。現在の制限と有効化手順については、Day Pass ガイドをご覧ください。OAuth クライアントでは、Day Pass のメールアドレスを使って サインインリンクをメールで送信 を選択します。API キーを使うクライアントでは、同じ API ヘッダープレフィックスを使用して、Day Pass キーをローカルで設定してください。プラグインやスキルをインストールしても、パスは開始されません。

キーにはアクセスレベルがあります。読み取りアクセスのキーは、すべての検索とレポートに使用できます。ロケーションの作成や更新、レビューへの返信、投稿の公開、アカウントの接続には、書き込みアクセスのキーが必要です。

サーバーでは、次の2つの認証方法を利用できます。

方法	ヘッダー	使用する場合
OAuth 2.0	クライアントによって管理されます	クライアントがブラウザーでのサインインと同意フローに対応している場合
API キー	Authorization: API <your-key>	クライアントで静的ヘッダーが必要な場合。キーはローカル設定にのみ入力してください

OAuth では、パブリッククライアント、PKCE、動的クライアント登録を使用します。事前に発行されたクライアントシークレットは不要です。書き込みが必要なタスクでない限り、読み取りアクセスから始めてください。OAuth トークンは MCP エンドポイントに適用されます。REST インテグレーションでは API キーを使用します。

セットアップ

以下のクライアント別手順に従ってください。API キーのプレースホルダーはローカル設定でのみ置き換え、共有リポジトリに認証情報を含めないでください。

Claude Code

claude mcp add --transport http listingsapi https://listingsapi.com/mcp --header "Authorization: API <your-api-key>"

Claude Desktop

claude.ai/directory/listings-apiを開き、接続 をクリックします。Claude でサインインフローを実行すると、Claude Desktop と Claude.ai でコネクターを利用できるようになります。

URL を使って追加するには、代わりに「設定」を開き、「コネクター」、「カスタムコネクターを追加」の順に選択して、URL として https://listingsapi.com/mcp を入力します。サーバーが初めて認証を要求すると、Claude Desktop に認証を求めるメッセージが表示されます。

Cursor

Cursor Directoryからインストールするか、~/.cursor/mcp.json またはプロジェクト内の .cursor/mcp.json に追加します。

{
  "mcpServers": {
    "listingsapi": {
      "url": "https://listingsapi.com/mcp"
    }
  }
}

サーバーの項目にある 接続 を使い、ブラウザーで OAuth を完了します。このリポジトリの Cursor プラグインでも同じ設定を使用します。API キー認証が必要な場合は、ローカル設定の項目内に "headers": { "Authorization": "API <your-api-key>" } を追加してください。

Windsurf

エディターの MCP 設定から MCP 設定ファイルを開きます。従来の Windsurf の場所は ~/.codeium/windsurf/mcp_config.json です。エディターのバージョンによっては、パスが異なる場合があります。OAuth に対応したクライアントでは、次の内容を追加します。

{
  "mcpServers": {
    "listingsapi": {
      "serverUrl": "https://listingsapi.com/mcp"
    }
  }
}

ブラウザーに表示される認証プロンプトを完了します。API キー認証を使う場合は、ローカル設定の項目内に "headers": { "Authorization": "API <your-api-key>" } を追加してください。お使いのエディターバージョンに対応する情報は、最新の Cascade MCP ドキュメントをご覧ください。

Gemini CLI

このリポジトリを拡張機能としてインストールします：

gemini extensions install https://github.com/listings-api/listingsapi-mcp

Gemini CLI を再起動し、/mcp auth listingsapi を実行して、ブラウザーでのサインインを完了します。/mcp を使って接続と検出されたツールを確認します。この拡張機能では OAuth が有効になり、API キーの設定は不要です。

拡張機能ではなく API キーを使う場合は、~/.gemini/settings.json の既存の mcpServers オブジェクトに次のエントリを追加します：

{
  "mcpServers": {
    "listingsapi": {
      "httpUrl": "https://listingsapi.com/mcp",
      "headers": { "Authorization": "API ${LISTINGSAPI_API_KEY}" }
    }
  }
}

ローカル環境で LISTINGSAPI_API_KEY を設定します。一度に使用する接続設定は 1 つだけにしてください。認証と設定の詳細については、Gemini の MCP ドキュメントを参照してください。

Cline

MCP Servers を開き、Remote Servers を選択して、https://listingsapi.com/mcp を追加し、Streamable HTTP を選択します。お使いの Cline のバージョンで Authenticate が表示される場合は、認証を完了します。手動で設定する場合は、"type": "streamableHttp" を指定します。type を省略すると、デフォルトで従来の SSE が使われます。Cline のインストールガイドには、完全な設定、API キーを使う代替手段、読み取り専用の検証手順が記載されています。

VS Code と GitHub Copilot

.vscode/mcp.json に追加します：

{
  "servers": {
    "listingsapi": {
      "type": "http",
      "url": "https://listingsapi.com/mcp",
      "headers": { "Authorization": "API <your-api-key>" }
    }
  }
}

その他のクライアント

上記のエンドポイントとヘッダーを使って、ストリーマブル HTTP トランスポートを使用します。サーバーは SSE を必要としません。

レート制限

リクエストはこのサーバーではなく、Listings API のプランに対してカウントされます。Launch プランでは 1 分あたり 10 件、Growth プランでは 50 件のリクエストが許可され、Enterprise の上限はアカウントごとに合意します。上限を超えると、API は 429 と、待ち時間を示す retry_after_seconds の値を返します。すべてのエラーレスポンスには correlation_id も含まれているため、サポートに伝えれば、該当するリクエストを特定できます。詳細は listingsapi.com/docs/rate-limits を参照してください。

実用上の注意点として、「すべての所在地を確認して」と頼まれたアシスタントは、所在地ごとに 1 件のリクエストをためらわずに実行します。Launch プランでは 10 回呼び出すごとに待ち時間が発生するため、質問の範囲を絞るか、バッチに分けて処理するようアシスタントに依頼してください。

開始前に知っておくべきこと

接続済みのプロフィールが先です。 Google または Facebook のレビューへの返信、投稿の公開、パブリッシャー分析の取得には、該当する Google または Facebook のプロフィールがアカウントに接続され、所在地と紐付けられている必要があります。分析結果が空だったり、返信に失敗したりする場合、通常はプロフィールが紐付けられていないことが原因です。先に接続と紐付けを済ませてから、ワークフローを実行してください。

リスティングの作成は非同期です。 Google ビジネス プロフィールのリスティングを作成したとき、成功レスポンスが意味するのはリクエストが受け付けられたことであり、リスティングが公開されたことではありません。Google による確認と準備は、独自のスケジュールで進みます。公開済みだと決めつけず、後でリスティングのステータスを確認してください。

書き込みは実際に反映されます。 このサーバー経由で公開した返信は、レビューサイトで公開されます。投稿は接続済みのプロフィールで公開されます。書き込み操作は、ダッシュボードで行う場合と同じように慎重に扱ってください。

所在地の説明には最低文字数があります。 新しい所在地には 200 文字以上の説明が必要です。これは、作成リクエストが最初の試行で失敗する最も一般的な原因です。

トラブルシューティング

症状	考えられる原因	対処方法
すべての呼び出しで 401 が発生する	キーが間違っている、有効期限が切れている、または貼り付け時に余分な空白が入っている	ダッシュボードの API Keys セクションでキーを再生成し、ヘッダーを更新してください
書き込み時に 403 が発生する	キーが読み取りアクセスのみを許可している	書き込みアクセス権を持つキーを発行してください
429 が発生する	プランのレート制限に達している	retry_after_seconds の時間だけ待つか、より小さなバッチに分けて処理するようアシスタントに依頼してください
分析結果が空で返る	プロフィールが接続されていないか、所在地に紐付けられていない	接続済みアカウントの操作を実行して、プロフィールを連携し、所在地に紐付けてください
返信は受け付けられたが表示されない	レビューサイトで処理中	数分待ってからレビューを更新してください

エージェントスキル

このリポジトリから必要なワークフローを、Skills CLI を使ってインストールできます。スキルは手順を提供するものであり、インストール時に認証情報を設定したり、アクセス権を付与したり、顧客のワークフローを実行したりするものではありません。

5つのワークフロースキルは skills.sh に掲載されています。また、一般的な listingsapi スキルは OpenClaw 向けに ClawHub にあります。

npx skills add listings-api/listingsapi-mcp

スキル	機能
listingsapi-listing-audit	プロフィールの完全性、公開者のステータス、リンクの有効性、重複の候補を確認し、優先順位を付けた修正計画を作成します。
listingsapi-review-management	レビューを振り分け、返信の下書きを作成し、承認済みの返信のみを公開または編集します。
listingsapi-multi-location-posting	選択した複数の拠点で、承認済みの Google/Facebook キャンペーンを準備して公開し、その結果を確認します。
listingsapi-performance-reporting	明示的な期間、対象範囲、データの鮮度に関する注意事項を踏まえて、パフォーマンスと評判を比較します。
listingsapi-integration	REST/SDK 認証、拠点の設定、公開者との接続、送信チェックを、新規または既存のアプリに統合します。
listingsapi	一般的なアカウント操作、接続の前提条件、Day Pass に関するガイダンスを提供します。

スキルを直接選ぶには、次のコマンドを実行します。

npx skills add listings-api/listingsapi-mcp --skill listingsapi-integration

統合スキルの既存の名前はそのままです。標準的な検出方法に対応するため、正規のソースは skills/ にあります。元の listingsapi-integration/ パスと ZIP は、互換性を保つためのコピーとして維持されています。正規の統合スキルを編集した後は、python3 scripts/package-integration.py を実行してください。読み取り専用のワークフローには読み取りアクセスが必要です。公開返信、キャンペーンの公開、プロフィールの編集、公開者との接続には、具体的な操作の承認と書き込みアクセスが必要です。Day Pass の対象は、サンドボックスの拠点とデモ用リスティングのみです。

検証とリリースの手順については、スキルの公開に関する注意事項を参照してください。GitHub での公開状況と skills.sh へのインデックス登録は別のものです。skills.sh の FAQ では、実際の CLI インストールのテレメトリーを通じた検出方法について説明しています。

ドキュメントとサポート

• API リファレンス全文：listingsapi.com/docs
• MCP サーバーのページ：listingsapi.com/mcp
• Python および Node 向け SDK：listingsapi.com/sdks
• API を独自のコードに統合するためのエージェントスキル：listingsapi-integration
• スケジュール実行およびノーコードでの利用に対応する Apify アクター：apify.com/listingsapi
• サポート：[email protected]

このリポジトリについて

このリポジトリには、MCP ディレクトリやクライアントが読み込む接続マニフェストのほか、アカウントのワークフローと開発者向け連携スキルが含まれています。製品コードは含まれていません。Listings API サービス自体はクローズドソースで、listingsapi.com で稼働しています。

ファイル	読み込み元
server.json	公式 MCP Registry（registry.modelcontextprotocol.io）
gemini-extension.json	このリポジトリを拡張機能としてインストールした場合の Gemini CLI
mcp.json and .cursor-plugin/plugin.json	マーケットプレイスプラグイン用の Cursor
llms-install.md	サーバーを自動で設定する Cline
logo.svg	この README と上記の各ディレクトリ
logo-400.png	400×400 の PNG が必要な Cline Marketplace
skills/listingsapi/SKILL.md	ClawHub と互換性のあるスキルクライアント向けに用意された、対話型のアカウントワークフロースキル
skills/listingsapi-*/	個別にインストールできるワークフローおよび開発者向け連携スキル
listingsapi-integration/	元のファイルパスを維持した、連携スキルの生成済み互換コピー
listingsapi-integration.zip	スキルのアップロードに対応したクライアント向けにパッケージ化された skills/listingsapi-integration/ ディレクトリ

パッケージのパス、提出の前提条件、現在のテスト状況については、マーケットプレイスへの提出に関する注意事項を参照してください。今回の変更について、Cursor と Cline のセットアップテストは実施していません。

ライセンス

このリポジトリのマニフェストは MIT License のもとで公開されています。詳細は LICENSE を参照してください。Listings API 自体の利用には、Listings API の利用規約が適用されます。

skills/listingsapi/ の対話型スキルは、ClawHub との互換性のため MIT-0 のもとで公開されています。リポジトリのルートにある MIT ライセンスと既存の連携スキルに変更はありません。