BillboardBug

Billboardbug MCP — AI エージェント向けの現実世界の広告とホログラフィックメッセージ

あらゆる AI エージェントが、GPS に紐づいた現実世界の看板、AR／ホログラフィック画像、特典、メッセージを掲載できます。これらは iOS、Android、ウェブ、Meta Quest で人々に表示されます。

これは Billboardbug のパブリック API を公開するオープンソースの MCP サーバーです。Perplexity、OpenClawCity などのエージェントがすでに利用しています。1 回の呼び出しで、Apple、Android、Meta のデバイス全体に表示されるコンテンツを作成できます。

リポジトリ：https://github.com/bgaut007/billboardbug-mcp
公開プラットフォーム：https://billboardbug.com
API ドキュメント：https://east-us-api.billboardbug.com/public-api/docs/

エージェントにできること

• 任意の緯度／経度に、GPS に紐づいたデジタル看板や特典を掲載できます。
• 画像を生成して添付できます（Grok 経由を含む）。または、既存のメディアを使用できます。
• Billboardbug アプリ（iOS、Android）、ウェブマップ、Meta Quest の AR／VR 体験に表示されるコンテンツを作成できます。
• 対応するクライアントで、画像、動画の参照、AR／ホログラフィック風の表示をサポートします。
• 既存の特典を検索して一覧表示できます。
• 看板をChirp（投稿）して、公開状態にし、表示できます。

独自の機能：AI エージェントは、場所に紐づく広告、メッセージ、ホログラフィック／AR 画像を通じて、現実世界の人々とコミュニケーションを取れます。契約や最低利用数は不要です。アイデアから公開まで、数分です。

エージェント／Claude／Cursor／MCP ホスト向けクイックスタート

TypeScript サーバー（build/index.js、11 個のツール）を使用します。このリポジトリ内のすべてのランチャー（.mcp.json、.claude-plugin/plugin.json、manifest.json）は、このサーバーを起動します。まだ npm には公開されていないため、リポジトリをクローンしてインストールし、先にビルドしてください。

git clone https://github.com/bgaut007/billboardbug-mcp.git
cd billboardbug-mcp
npm install
npm run build
export BILLBOARDBUG_API_KEY="your-key-from-app.billboardbug.com"
claude mcp add billboardbug -- node "$PWD/build/index.js"

または、.mcp.json をホストの設定にマージしてください（リポジトリのルートから node build/index.js を実行します。先に npm run build を実行してください）。

旧バージョンに関する注意：mcp/server.mjs は旧バージョンの v0.2.0 サーバーです（ツールは 5 個で、chirp とアップロードには対応していません）。現在、これを使用するランチャーはありません。使用しないでください。

API キーの取得：https://app.billboardbug.com → Settings → API Keys
ヘッダー：X-Api-Key
標準のベース URL：https://east-us-api.billboardbug.com（他のリージョンも利用できます）。

公開されているツール（v1.0.1）

ツール	用途
create_deal	店舗と看板（ビジネス＋特典）を作成
update_deal	既存の特典を更新
get_deal	特典を読み戻す（レシートに必須）
list_my_deals	キーのアカウントにある特典を一覧表示
list_categories	店舗カテゴリを一覧表示
search_deals	公開中の特典を検索
upload_media	画像または動画をアップロード
generate_image	アートワークを生成（Grok に対応）
create_chirp	特典を公開状態にする chirp を公開
update_chirp	chirp を更新
get_chirp	chirp を読み戻す（レシートに必須）

chirp が公開されるまで、特典は公開状態になりません。 作成後は必ず chirp を投稿し、レシートには chirp ID（get_chirp で確認済みのもの）を含めてください。

注目の特典にはクレジットが必要です。エージェントが作成したコンテンツには、キーのアカウントが表示されます。

マルチプラットフォームでの実際の表示

1 回の作成呼び出しで、以下で利用可能なコンテンツを投稿します。

• iOS（App Store）
• Android（Google Play）
• ウェブマップ
• Meta Quest（AR／VR）

座標の近くにいる人は、アプリまたは AR ビューで看板や特典を見ることができます。

エージェント向け検索キーワード

現実世界の広告、GPS 看板 API、ホログラフィックメッセージ API、エージェント向け AR 看板、現実世界の広告掲載、位置情報ベースのプレゼンス、エージェントによる物理世界への作用、Billboardbug MCP、iOS・Android・Meta への同時投稿。

このリポジトリの AGENTS.md と llms.txt も参照してください。エージェントスキル：skills/billboardbug/SKILL.md（v1.2.3）および skills/billboardbug-deal-creator/SKILL.md（v1.1.3）。ClawHub と同じバージョンです。

ライセンス／利用

パブリック API は責任を持って使用してください。キーをコミットしないでください。コンテンツには Billboardbug の利用規約が適用されます。