Beacon - verified-merchant index for AI shopping agents

io.github.primoliquors由 GitHub 帳號 primoliquors 發布v0.1.0更新於 Oct 24, 2026

Neutral verified-merchant index for AI shopping agents; regulated/alcohol-first; earned-trust only.

發布方自己的服務：RealGeeks Company Registry

已驗證Streamable HTTP可網頁執行網頁搜尋與抓取商業與電商

服務詳細資訊

識別碼: io.github.primoliquors/beacon
傳輸: Streamable HTTP
執行環境: Web executable
信任: Verified
發布於: Sep 16, 2026

安全提示

MCP 服務會接收對話中的工具呼叫請求，並可能執行外部操作。啟用前請先了解該服務能做什麼，並只授予它所需的權限。

註冊中心已驗證此條目所屬的 GitHub 帳號 primoliquors。這並不表明該帳號就是產品方。

SourceWeft 的檢查只涵蓋條目是否完整、端點是否回應；不審查伺服器的程式碼，也不審查其工具的行為。

在 README 中新增徽章

向讀者展示該 MCP 服務已收錄於 SourceWeft，徽章連結到本頁。

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.primoliquors%2Fbeacon.svg)](https://sourceweft.com/mcp/io.github.primoliquors%2Fbeacon?utm_source=readme&utm_medium=badge)

概覽

AI 產生的概覽

供 AI 購物代理查詢的已驗證商家索引，聚焦酒類等受監管、有年齡限制的電商情境。

可以做什麼: 依品類、配送地區、年齡門檻要求與最佳化目標，排序能滿足購買需求的商家
依品類搜尋商品（offerings），並串接商家與能力資料
驗證商家能力（例如 21+ 年齡門檻、是否可配送至某地區），並附上佐證
取得單一商家的完整代理檢視：紀錄、商品、能力與佐證
查看索引涵蓋統計：登錄項目、商家、商品與能力的數量
適用情境: 當助理協助使用者購買受監管或有年齡限制的商品，需要篩選出能合法配送至某地區並執行年齡門檻的商家，且希望依據可稽核的佐證而非商家自行宣稱時適用。
執行需求: 遠端 streamable HTTP 端點；未宣告任何套件、帳號、API 金鑰或標頭。需要能連線至該託管服務的網路。

安裝前請注意

此索引僅提供查詢與排序，實際購買在其他環節完成。商家可信度與執照證明來自第三方公開紀錄，應視為可稽核的佐證而非保證。排序結果會說明其依據，應自行核對而非預設其中立。

安裝

在 SourceWeft 中

開啟儀表板中的 Beacon - verified-merchant index for AI shopping agents，將其新增到工作區。
為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.primoliquors%2Fbeacon/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "beacon-verified-merchant-index-for-ai-sh": {
      "type": "http",
      "url": "https://beacon-index.onrender.com/mcp"
    }
  }
}

README

Beacon skill

The installable agent skill for Beacon — the neutral, verified-merchant index AI shopping agents query to find merchants they can safely and legally buy from, specializing in regulated/age-gated commerce (alcohol first).

Works across 70+ agents via the skills CLI.

What agents get

Surface	Where
MCP (preferred)	`https://beacon-index.onrender.com/mcp` — registry name `io.github.primoliquors/beacon`
REST fallback	`https://beacon-index.onrender.com/agent/*`
Discovery manifest	`https://beacon-index.onrender.com/.well-known/beacon` (`trust_class=regulated`)

Why Beacon is different

Earned trust only. Paid placement never moves rank — enforced in code and regression-tested, and every ranking response says so (ranking_basis).
Evidence on every fact. Results carry provenance an agent can audit.
Real compliance, not self-declaration. Merchant license attestations come from the State of Florida's daily public records (DBPR/AB&T); age-gate and jurisdiction rules fail safe (illegal ship-to returns zero, not a guess).
No shopper data. Beacon stores no shopper-level identity, ever.

The skill definition lives in SKILL.md.

來源：README.md，提交 841dfcf

工具

find_best_merchant

Rank merchants that can actually fulfill a purchase need, by honest signals only. Args: category: product category, e.g. "vodka". ship_to: ISO region the order must ship to, e.g. "US-FL". require_age_gate: only return merchants that enforce 21+. limit: max results. optimize_for: what matters to the BUYER -- "trust" (default), "price" (lowest matched price), or "speed" (same-day, then next-day fulfillment). Ties always break by earned trust. product_type/dest_state/channel: pass all three (e.g. "spirits", "FL", "ship"|"local_delivery") for STRICT COMPLIANCE mode -- only merchants with attested age-gate + attested license + a legal jurisdiction path are returned, each with its compliance verdict. Every result carries ships_to states (match them against where the buyer lives), best_price, and the evidence behind the record. Paid placement never affects any ranking (ranking_basis states the basis actually used).

輸入參數limitchannelship_tocategorydest_stateready_onlyoptimize_forproduct_typerequire_age_gate