io.github.primoliquors/beacon

Beacon - verified-merchant index for AI shopping agents

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

0.1.0
Version
remote
Transport
5
Tools

Security review

Review passed

Reviewed Jan 1, 2000.

  • tools: 5 tools scanned
  • metadata: scanned

No findings.

Tools (5)

  • 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 rank

  • search_offerings

    Find offerings (products) matching a category, joined to merchant + capabilities.

  • verify_capability

    Verify a merchant capability with evidence, e.g. age_gate_21 or ships_to_US-FL.

  • get_merchant_view

    Full agent view of one merchant: record + offerings + capabilities + evidence.

  • index_stats

    Graph coverage stats: counts of registry entries, merchants, offerings, capabilities.