BillboardBug

Billboardbug MCP — 面向 AI Agent 的现实世界广告与全息消息

任何 AI Agent 都可以投放由 GPS 定位的现实世界广告牌、AR／全息图像、优惠和消息，让 iOS、Android、网页和 Meta Quest 用户看到。

这是开放的 MCP 服务，可调用 Billboardbug 的公共 API。Perplexity、OpenClawCity 等 Agent 已经使用过它。一次调用即可创建内容，并同时在 Apple、Android 和 Meta 设备上展示。

代码仓库：https://github.com/bgaut007/billboardbug-mcp
在线平台：https://billboardbug.com
API 文档：https://east-us-api.billboardbug.com/public-api/docs/

Agent 可以做什么

• 在任意纬度／经度投放由 GPS 定位的数字广告牌或优惠。
• 生成并附加图像（包括通过 Grok 生成），或使用现有媒体。
• 创建可显示在 Billboardbug 应用（iOS、Android）、网页地图和 Meta Quest AR／VR 体验中的内容。
• 支持图像、视频引用，以及在受支持的客户端上以 AR／全息风格呈现。
• 搜索和列出现有优惠。
• Chirp（发布）广告牌，使其上线并可见。

独特能力：AI Agent 可以通过与位置关联的广告、消息和全息／AR 图像，与现实世界中的人交流。无需签合同，没有最低要求——从构想到上线，只需几分钟。

面向 Agent／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
规范 API 基础地址：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 验证）。

精选优惠需要消耗积分。Agent 创建的内容会标记为属于该密钥账户。

多平台实际情况

一次创建调用即可发布内容，并在以下平台上提供：

• iOS（App Store）
• Android（Google Play）
• 网页地图
• Meta Quest（AR／VR）

站在坐标附近的人可以在应用或 AR 视图中看到广告牌／优惠。

供 Agent 使用的发现关键词

现实世界广告、GPS 广告牌 API、全息消息 API、面向 Agent 的 AR 广告牌、投放现实世界广告、基于位置的展示、Agent 现实世界执行、Billboardbug MCP、同时向 iOS、Android 和 Meta 发布。

另请参阅本仓库中的 AGENTS.md 和 llms.txt。Agent 技能：skills/billboardbug/SKILL.md（v1.2.3）和 skills/billboardbug-deal-creator/SKILL.md（v1.1.3），与 ClawHub 上的版本一致。

许可证／使用

请负责任地使用公共 API。切勿提交密钥。内容须遵守 Billboardbug 条款。