Versum

Versum Agent Assistant

AI エージェントは、地域のビジネスを見つけ、販売商品を確認し、在庫状況や価格を調べて、実際の注文や予約を開始できます。

理由

地域のビジネスは、AI エージェントからはほとんど見えません。メニューや価格表、予約ページは人向けに書かれており、エージェントは店舗に電話をかけられません。また、エージェントが利用できるウェブサイトを持たないビジネスも数多くあります。Versum は、各ビジネスが公開している情報を読み取り、注文、予約、問い合わせ用の実際のリンクを含む、ビジネスごとのカードにまとめ、そのカードをあらゆる MCP クライアントに提供します。

60 秒で始める

どちらもストリーミング可能な HTTP の MCP 接続先です。キー、アカウント、支払いは不要です。

接続先
https://versum.suverse.io/mcp/catalog	無料のビジネスカタログ：以下の 15 個のツールのみを提供します（推奨）
https://versum.suverse.io/mcp	キーなしのクライアント向けに同じ 15 個のツールを提供します（Versum ノードキーがあれば、計算用の接続先になります）

Claude — Customize → Connectors → Add custom connector → URL https://versum.suverse.io/mcp/catalog → Add。 サインインを求められることはありません。

ChatGPT（Developer mode を利用できるプラン）— コネクターの設定で Developer mode を有効にし、MCP URL https://versum.suverse.io/mcp/catalog を指定して、認証なしでコネクターを Create します。メニューの名前は ChatGPT のバージョンによって異なります。

Cursor（~/.cursor/mcp.json）または JSON サーバーリストを受け取るクライアント：

{
  "mcpServers": {
    "versum": { "type": "http", "url": "https://versum.suverse.io/mcp/catalog" }
  }
}

このエントリーだけを設定し、公式の MCP TypeScript SDK クライアントを接続して動作を確認しました。15 個のツールが一覧に表示され、ライブ呼び出しにも応答がありました。

リクエストを 1 回送信します。search_catalog に {"query": "a dozen red roses delivered", "location": "Miami, FL", "limit": 3} を指定すると、ライブの応答（2026-11-02）が返ります。最初のビジネスのみを抜粋しています。

{
  "found": 12,
  "returned": 3,
  "businesses": [
    {
      "id": "f2f197e1-7e39-4794-9e3c-54a77a75ef24",
      "name": "More Than Flowers",
      "trade": "Florist",
      "miles_away": 2.1,
      "offerings": [
        {
          "id": "e9a2aebb-cd9e-4627-8d8d-84d866a26bee",
          "title": "Three Dozen Roses - Hot Pink",
          "price": 135,
          "availability": "in_stock",
          "link": "https://morethanflowersmiami.com/miami-more-than-flowers/three-dozen-roses-hot-pink.html?ref=versum"
        }
      ],
      "can": ["check_delivery", "contact", "order"],
      "links": {
        "order": "https://morethanflowersmiami.com/miami-more-than-flowers/mayflower-wrapped-bouquet.html?ref=versum",
        "contact": "tel:+17865876195"
      }
    }
  ]
}

あらゆるビジネスのウェブサイトを自分で読み取る

reader/ は Versum 独自のオープンソースのリーダーです。カタログで使用されているのと同じリーダーを、お使いのマシン上であらゆるウェブサイトに対して実行できます。価格付きの商品、注文・予約・問い合わせへのリンク、営業時間、連絡先を確認でき、すべての値に読み取った元の文言が付いています。Google もプロキシもブラウザーも不要です。robots.txt に従い、モデルを使用する場合もご自身の ANTHROPIC_API_KEY のみを使います（--no-model で無効にできます）。

cd reader && npm install && npm run build
node dist/cli.cjs read https://example-business.com --pretty

共有キャッシュは無料で、デフォルトで有効です（--no-share または VERSUM_SHARE=0 で無効にできます）。送信・保存されるデータについては、reader/README.md とプライバシーポリシーをご覧ください。

検索方法（エージェント向け）

サーバーは、すべてのクライアントに指示として次のルールを送ります。簡単にまとめると、次のとおりです。

1. ユーザーの依頼を業種と場所に置き換えます。 «タンパで車から締め出されました» → locksmith、 Tampa。«エアコンから温風が出ます。33618です» → hvac、33618。カタログ内部のニッチキーを知っている必要はありません。 list_niches と search_catalog は一般的な言葉に対応します。
2. ツールを選びます。 名前がわかっている場合は find_business、業種がわかっている場合は list_cards、 どちらもわからない場合や、特定の商品（«ビーガンピザ»、«ブレーキパッド»）が必要な場合は search_catalog を使います。
3. 場所がなければ、推測しません。 依頼に市区町村名も ZIP コードもない場合は、ユーザーに尋ねます。カタログは場所を勝手に選ばず、 location_needed を返します。
4. 検索結果は候補です。 カードを確認します。掲載内容、顧客のもとへ出向くか（at_customer： 確認済み／出向かないことを確認済み／不明）、サービス提供地域、問い合わせ窓口を確認します。
5. 事実を混同しないでください。 営業時間は空き時間ではありません。商品の価格は最終的な合計金額ではありません。「近くにある」は「お住まいの地域に対応している」ではありません。データがないことは「ない」という意味ではありません。
6. 適切な窓口から次の手順に進みます。 メニューやカタログで確認し、予約には book、合計金額の確認には quote_order、事業者への問い合わせには request_to_owner を使います（チャネルが接続されている場合のみ）。それ以外の場合は電話します。
7. 本人の許可なく、本人に代わって何もしません。 問い合わせ、予約、注文、支払いは行いません。

各検索結果には、一致した理由（match.basis：確認済みの商品、事業者自身の説明、カテゴリタグ、またはカテゴリのみ）が記載されます。カタログが一般的な表現から必要な業種を判断できない場合、似ているだけの結果を返すのではなく、その旨を伝え、近い業種を提案します。

ツール

ツール	機能	主なパラメーター
list_niches	カタログが対応している、指定場所の近くの業種とその件数	location, radius_miles, niche
list_cards	指定場所の近くにある、ある業種のすべての事業者を固定順で表示します（オンライン業種の場合、場所の指定は不要です）	niche, location（地域の業種では必須）, query, needed_by, max_price, deliver_to, page
find_business	名前で事業者を検索します	name（必須）, location
search_catalog	業種が分からない場合に、意味に基づいて該当するものを検索します	query（必須）, location, fulfillment, max_price, only_local
get_card	事業者の詳細情報：販売内容、可能な手続き、連絡方法	id
get_business	get_card の別名	id
get_offering	商品・サービスの詳細情報。現在の価格も再確認します	id
get_product	get_offering の別名	id
quote_order	住所への配送を含む注文金額を、店舗独自のカートに問い合わせます。注文は行いません	offering_id, deliver_to（必須）, quantity, options
check_availability	事業者独自のシステムに問い合わせます：現在の在庫、空いている予約枠	business_id, offering_id（必須）, from, to
place_order	事業者独自のシステムで注文します。購入者はプラットフォームのチェックアウトページで支払います	business_id, lines（必須）, customer
book_slot	事業者独自のカレンダー（Square Appointments）で予約枠を予約します	business_id, offering_id, start_at, customer（必須）
order_status	この窓口から行った注文または予約の状況を確認します	order_id
request_to_owner	事業者の確認済みオーナーにリクエストを送信します（Telegram、メール、WhatsApp）。オーナーが確認するまでは予約されません	business_id, what, customer, idempotency_key（必須）, date, time, quantity, branch, note
request_status	リクエストの状況を確認します：送信状況（sent・link_given・expired・failed）とオーナーの回答（declined＝辞退、other_time＝別の時間、available＝空きあり・予約なし、confirmed＝予約済み）	request_id

check_availability、place_order、book_slot は、オーナーが Shopify または Square に接続した事業者で利用できます（カードに live_data と、connected の窓口が表示されます）。Shopify の場合、place_order はカート内の商品が入った店舗独自のチェックアウトリンクを返します。購入者は Shopify で詳細を入力して支払います。それ以外の事業者では、カードの窓口から各事業者独自の注文・予約ページに移動します。

request_to_owner は、オーナーがカードの所有権を申請し、チャネルに接続した事業者で利用できます。それ以外の事業者では、カードにある他の窓口とともに no_channel が返されます。同じ idempotency_key で再試行しても、リクエストが重複して送信されることはありません。

例：quote_order — Flowers of Miami、バラ12本

{"offering_id": "a05bbf1c-32c0-4a56-9038-310b0c35b852", "deliver_to": "1000 Brickell Ave, Miami, FL 33131"} — 「赤いバラ12本とカスミソウの小さなブーケ」。2026-11-02 時点で、店舗独自のカートから取得したリアルタイムの回答です。

店舗のカートで選べるオプション	送料	合計
Local Delivery（店舗が最初に選択）	$20.00	$80.25
Local Pickup	$0.00	$58.85

商品価格は $55.00 です。合計には、この住所に対する店舗独自の税金が含まれます。placed: false — 注文は行われていません。配送先住所のみが送信され（氏名、メールアドレス、電話番号は送信されていません）、その後カートのセッションは空になりました。店舗はカート経由で配送日を公開していないため、delivery_date は unknown でした。

オンラインビジネス

このカタログには、地域のビジネスだけでなく、あらゆる種類のビジネスが掲載されています。ソフトウェアやアプリ、API や MCP サーバー、オンラインショップ、オープンソースツール、コンテンツサイト、マーケットプレイスなどです。各カードには、そのビジネスが地域、オンライン、または両方のどれに該当するか（オンラインでも販売する地域のビジネス。独自のアプリを持つ地域のビジネスは地域のままです）と、その理由が記載されています。

• オンラインカードには所在地がありません。「オンラインサービス」と、提供内容、対象者、料金とプラン、無料トライアルまたは無料プラン、プラットフォーム、連携機能／API／ドキュメント、サポート、会社情報が表示されます。それぞれ、ビジネス自身のページから引用付きで取得した情報です。
• list_niches は、online_niches の下にオンライン分野を一覧表示します。
• オンライン分野を指定した list_cards は所在地を無視します。所在地を指定せず、オンライン関連（ソフトウェア、アプリ、API など）をリクエストした search_catalog は、オンラインビジネスを返します。location_needed が返されることはありません。
• get_card は online ブロックを追加します。各情報と、その情報を読み取ったページが記載されます。

実在するビジネスのみ

一部の「地域のビジネス」は、リード獲得サイトです。実際には、1 社が複数の架空の名前で問い合わせ電話を販売しています。Versum はこうしたサイトを確認し、掲載対象から除外します。

• 複数の異なるウェブサイトで同じ料金表が使われ、かつ電話番号が同じ番号帯にある。
• 免許が必要な業種のサイトに、免許番号が記載されていない。
• 所有者、創業年、会社名の記載がない。
• それらのサイトで同じサイトテンプレートと文章が使われている。

リード獲得サイトだと確認されたカードは、棚に掲載されることはありません。search_catalog、list_cards、find_business にも表示されず、サイトマップにも含まれません。また、そのページは 410 を返します。疑わしく見えるだけのカードは、非表示にする前に人が確認します。この確認は毎週実施されます。

公開基準

Versum は、一部の地域のビジネスについて独立したページ（versum.suverse.io/offers/…）も公開しています。ビジネス自身が公開しているページのみをもとに作成し、公開当日に再確認したうえで、独立したページであること（「掲載を依頼しておらず、掲載料も支払っていない。また、Versum のクライアントでもパートナーでもない」）を明記し、内容の訂正や削除を依頼できる方法を用意しています。すべてのページは、公開前に 18 項目の確認を通過します。ルールは公開されています。 公開基準。

制限

MCP ドア、キーなし	現時点では呼び出し回数の制限はありません。読み取った内容はキャッシュしてください
Versum ノードキーを使う MCP	キーの制限は x-ratelimit-limit / -remaining / -reset で返されます
オーナーサイト：ライブカードの生成	住所ごとの1日あたりの上限はありません。住所ごとに1時間あたり 60 リクエストです
無料チェック	ウェブサイトごとに1日あたり 3 回、住所ごとに1日あたり 20 回です

名刺

get_card は、事業者ごとに1枚の名刺を返します。あらゆる種類の事業者の実際のカードから推定した完全なスキーマは、 schema/card.schema.json にあります。主な項目は次のとおりです。

• identity — id、name、address、location、phone、email、website、hours / hours_folded、page_url

• offerings — 販売しているもの：それぞれに id、title、price、currency、availability、link があります

• actions（窓口） — order、book、reserve、request_quote、contact、check_delivery：実際の url（または tel: / mailto:）と、プラットフォームの場合は provider があります

• fulfillment — 配達、受け取りなどについて、判明していることと不明なことを含みます

• reach — エージェントが事業者とやり取りする方法を、1語で示します。

  reach	意味
  online_platform	注文または予約はプラットフォーム（店舗、注文システム、予約システム）を通じて行います
  own_cart	事業者独自のウェブサイトで注文できます
  form_only	リクエストフォームのみで、オンライン注文はできません
  phone_only	電話が唯一の窓口です
  no_site	事業者にウェブサイトがありません
  not_read	サイトを読み取れませんでした

• status — unverified：事業者自身の公開ページから読み取った情報であり、オーナーは確認していません。オーナーが申請してカードの内容を確認した事業者は owner_verified と表示されます。2026-11-08 時点でカードを確認した事業者オーナーはいません。確認済みカードは Versum 自身のテスト事業者のものだけで、棚には掲載されていません。

透明性評価

すべてのカードには、公開されている Versum 透明性評価 が付いています。事業者が自ら公開している情報をもとに、購入者がその事業者に 連絡する前に どれだけのことを把握できるかを示します。これはサービスの品質を評価するものではありません。星評価もレビューも「最高」などの評価もなく、Versum はどのページでもこの評価によって事業者を並べ替えることはありません。

項目（地域の事業者）	カウントされる条件
価格の公開	事業者自身のページに、テキストで価格が1つ以上掲載されている
ライセンスの表示	州のライセンスが必要な業種のみ（HVAC、配管、電気工事、屋根工事、歯科医など）
営業時間	サイト、Google ビジネス プロフィール、または確認済みオーナーによる設定のいずれかに掲載されている
サービス提供エリア / 住所	顧客のもとへ出向く業種は対応エリア、顧客が訪問する店舗などは所在地の住所
電話番号または予約 / 問い合わせリンク	タップして発信できる電話番号、または予約・問い合わせリンクがある
過去30日以内にウェブサイトを確認	Versum が30日以内にサイトを読み取っている

オンライン事業者では、種類（ソフトウェア、API、店舗、オープンソース、コンテンツ、マーケットプレイス）ごとに、無料チェックと同じ設定を使った独自の項目リストが適用されます。「誰に向いているか」という項目はありません。事業者が誰に適しているかはエージェントが判断します。事業者自身がサイトで対象ユーザーを明示している場合、get_card はその情報を出典とともに stated に返しますが、評価には反映しません。評価：すべての項目を満たす場合は A、1項目を除くすべてを満たす場合は B、半分以上を満たす場合は C、半分未満の場合は D です。 各 ✓ には、情報が見つかったページと読み取り日へのリンクがあります。方法： versum.suverse.io/transparency。

エージェント向け：get_card → 各カードの transparency {grade, have, of, source と read_at を含む items、または how_to_add}。list_cards と find_business → 各カードの transparency {grade, have, of, items: {key: true|false}}。この情報で並べ替えや絞り込みを行えますが、リストの順序には使用されません。カードページの JSON-LD では、通常の additionalProperty（PropertyValue、propertyID: versum-transparency）として記載され、Review や AggregateRating ではありません。

分類体系

すべてのカードは、1つ以上のニッチ（業種）に属します。各ニッチには key、人々が使う呼称（also_called）、販売しているものの種類（tags）があります。taxonomy/niches.json には、list_niches から読み取った2026-11-02時点の128のニッチが記載されています。ライブカタログには2026-11-03時点で130のニッチがあります。

カバレッジ

棚にあるカード	34,716（現在の件数：上のバッジ、または /api/public/stats）
ニッチ	136
町と地域	87

2026-11-08（20:36 UTC）時点です。新しい地域のスキャンは一時停止しています。既存のカードは保持され、再読み込みされます。

注文・価格へのリンク（2026-11-08、34,716 件のカード中）
オンライン注文へのリンクあり	2,773
オンライン予約へのリンクあり	5,188
価格が少なくとも 1 つ記載されている	5,211

現在、最もカバレッジが充実しているのは、タンパ、セントピーターズバーグ、タンパ湾東部の郊外です。情報がまだ少ない、または空の地域もあります。たとえば、ピネラス郡北部（クリアウォーター、ダニーデン、パームハーバー）です。また、フロリダ州のその他の都市では、これまでに収集されたカードがはるかに少ない状況です。こうした地域の近くで検索結果が空の場合、通常はその地域がまだスキャンされていないことを意味し、そのような事業者が存在しないという意味ではありません。

事業者の皆さまへ

• 無料チェック：「AI はあなたのビジネスについて何を知っているか」 — versum.suverse.io でウェブサイトを入力すると、公開されている計算方法（スコアの算出方法）に基づく 100 点満点のスコアを確認できます。AI アシスタントがあなたのビジネスを挙げるか（ニッチと都市ごとに購入者からの質問を 3 つ作成し、Claude にウェブ検索を通じて毎週質問します。レポートにはエンジン名と日付が記載されます）、購入者が探している情報がウェブサイトに掲載されているか、検索エンジンや AI ボットがウェブサイトを読み取れるか、15 マイル以内の同じニッチの事業者と比べてどうか、最初に修正すべき点を確認できます。各 ✓ には、該当情報が見つかったページへのリンクが付いています。完全版レポートには、すべての情報源に加え、あなた自身の情報だけを使って作成した、そのまま使える LocalBusiness JSON-LD ブロックと llms.txt が含まれます。オンライン事業者には、種類（ソフトウェア、API / MCP、オンラインショップ、オープンソース、コンテンツ、マーケットプレイス）ごとの計算方法が適用され、事業者自身の説明と対象者に基づいて、都市名を含まない質問が作成されます（マーケットプレイスには、どのソフトウェアを使うかではなく、どこで売買できるかを質問します）。また、SoftwareApplication / Organization のコードも作成されます。入力したアドレスがアプリまたはサインイン領域（app.…、dashboard.…、/login）の場合、同じ事業者の公開サイトも読み込まれ、レポートには読み込まれたページが記載されます。レポートは非公開で、インデックス登録されず、サイトマップにも掲載されません。現在のところ、チェックは無料で、1 日あたりの回数制限もありません。Google マップ、レビュー、ランキングはチェック対象に含まれません。
• versum.suverse.io でカードの所有権を申請できます。事業者を探し、自分の事業者であることを確認します（カードまたはウェブサイトにすでに記載されている連絡先へのコード、または Shopify / Square を使用）。その後、カードの掲載内容を編集して公開できます。各カードには公開ページがあります。例：versum.suverse.io/b/flowers-of-miami-miami。
• Telegram ボット「Versum for Business」（@VersumBusinessBot）：顧客やエージェントからのリクエストが届き、確認、辞退、返信のボタンを使えます。
• オーナーページから Shopify または Square を連携できます。連携すると、カードにストアの最新の商品、価格、在庫状況が表示され、エージェントが注文したり、オーナー自身のシステムで予約枠を予約したり（Square）できます。
• ビジネスを成長させる（オーナーページ、/grow、およびボット内の /grow）：カードの次のステップと、プロモーションを開始 — 公開基準に従って作成される独立したページです。18 項目すべてのチェックに合格した後にのみ公開され、オーナーの依頼による公開であることが明記されます。テスト期間中は無料です。事業者の確認を完了したオーナーのみ利用できます。
• 近日公開：Shopify App Store への掲載。

オーナー API とオーナー自身のサイト（2026-11-09）

オーナーがウェブ上、Versum アプリ（iPhone/Android、近日公開）またはアシスタントを通じて行うすべての操作は、ひとつの JSON API を使用します：https://versum.suverse.io/api/owner/v1（OpenAPI）。 メールコードでサインインします（有効期限の短いアクセストークンとリフレッシュトークンを使用します）。サインインで確認できるのは連絡先のみです。ビジネスを管理するには、そのビジネス自身が公開している連絡先（ウェブサイトまたは Google の掲載情報）、そのビジネス自身のウェブサイト上のファイルやタグ、または書類に対する人によるレビューを通じて確認された申し立てが必要です。オーナーがビジネスを追加した場合も同様です。

• ウェブサイトを持たないビジネスの追加： オーナー自身の言葉で名前と説明を入力 → 重複チェック（強い一致が見つかった場合は「申し立て」、似た名前は候補としてのみ表示） → ニッチ → ニッチごとの項目 → 公開。「オーナー提供」と表示されます。
• ウェブサイトの情報が不十分な場合： 管理画面に透明性の評価と追加すべき内容が具体的に表示されます。「自分のウェブサイトを改善」から、JSON-LD、llms.txt、およびサイトに不足している情報を補うためのすぐに使えるテキストを取得できます。オーナーの WordPress に下書きページを作成することもできます。
• オーナー自身の Versum サイト（versum.suverse.io/s/<name>）：オーナーが有効にした場合にのみ表示され、オーナーが承認したデータだけを掲載します。外観は設定のみで変更できます（コントラストチェック付きの色、フォント、レイアウト、セクション）。カスタムコードは使用できません。

エージェントは引き続き MCP を通じて同じカードを読み取ります。以下のツールに変更はありません。

仕組み

1. スキャンにより、地域内の業種ごとのビジネスが一覧表示されます。
2. アナライザーは各ビジネス自身のウェブサイトを読み取ります。メニュー、料金表、ショップカタログ、予約ページ、注文ページが対象です。 3.保持されるすべての情報には、読み取ったページと文言が付随します。情報を捏造することはありません。
3. ビジネスごとに1枚のカードが棚に掲載され、実際の連絡先へアクセスできます。
4. エージェントは MCP の窓口から問い合わせ、オーナーはカードを申し立て、修正し、接続できます。

flowchart LR
  A[Scan an area] --> B[Read the business website]
  B --> C[Card: offerings, prices, doors]
  C --> D[MCP door for agents]
  C --> E["/b/ page + owner site"]
  E -->|owner claims, edits, connects Shopify / Square| C

掲載先

• Official MCP Registry — io.suverse.versum/catalog（以前の登録 io.github.sudzikcoin/versum-agent-assistant は非推奨と表示され、こちらを案内しています）
• mcptry（2つ目の登録）
• Glama
• mcpub.dev
• wellknown.network
• ToolSDK MCP Registry

ロードマップ

完了：

• 共有キャッシュを備えたオープンなリーダー：reader/。
• カタログ専用の MCP 窓口 /mcp/catalog（15 個のツール、キー不要）。
• オーナーによる申し立て、Shopify と Square の接続、Telegram を通じたオーナーへのリクエスト。
• リード生成フィルター。
• 独立したプロモーションページと公開版の公開基準。
• オーナー向けの無料「AI があなたのビジネスについて把握していること」チェック。

次の予定：

• npm パッケージ @suverselabs/versum-mcp（stdio、ツール用の型付き関数）を公開します。ソースは npm/ にあります。
• WhatsApp のクリックしてチャットする窓口。
• スキャン対象地域の拡大（現在は一時停止中）。

ライセンスと連絡先

このリポジトリにあるスキーマ、タクソノミー、ドキュメント、オープンリーダー（reader/）は MIT ライセンスです。ホスト型カタログのサービスコードはクローズドです。 プライバシーポリシー · 利用規約 · 公開基準 · 評価方法（SuVerse LLC）。 連絡先：[email protected]。Versum のコンピューティング側はversum-nodeです。