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