GenGEO Agent Registry

GenGEO Agent Registry

面向自主商务系统的机器可读信任基础设施。

GenGEO 正在打造全球最大的 AI Agent 商家信任注册库，并为 Agent 商务构建全球声誉网络的基础。

GenGEO 让 AI Agent 和开发者能够在做出自主购买或推荐决策之前，验证电商商家是否达到较高的运营验证门槛。

随着 AI Agent 越来越多地代表用户进行交易，一个重大的基础设施问题正在浮现：

目前还没有标准化的机器可读信任层，用于判断商家是否已做好运营准备，适合进行自主交易。

与此同时，正当的 AI 驱动商务活动正日益受到欺诈和机器人检测系统的阻碍，而这些系统无法区分自主 AI Agent 与恶意自动化程序。

AI Agent 已经可以：

• 发现商品
• 浏览商店
• 比较价格
• 推荐商家
• 并且越来越多地完成购买

但在自主商务操作进行之前，仍然没有通用的验证层来评估商家是否已做好交易准备。

GenGEO 通过提供确定性的机器可读验证信号，帮助降低交易的不确定性；Agent 可以将此信号纳入更广泛的商务决策框架。

---

GenGEO

面向 AI Agent 的信任验证 SDK。

在推荐、购买或交易之前，验证电商商家是否符合 GenGEO 信任标准。

GenGEO 提供轻量级 SDK 和 API，用于在自主商务和 AI Agent 工作流中验证商家。

---

安装

# JavaScript / Node.js
npm install @gengeo/gengeo

# Python
pip install gengeo

---

快速入门

JavaScript / Node.js

import { verify } from '@gengeo/gengeo'

const result = await verify('store.example.com')

console.log(result)

/*
{
  verified: true,
  decision: 'verified',
  registry: 'gengeo'
}
*/

Python

from gengeo import verify

result = verify('store.example.com')

print(result)

# {
#   'verified': True,
#   'decision': 'verified',
#   'registry': 'gengeo'
# }

cURL

curl "https://api.gengeo.co/api/verify?domain=store.example.com"

---

为什么选择 GenGEO？

AI Agent 越来越多地代表用户自主进行交易。

GenGEO 提供标准化的信任验证层，帮助 Agent 在执行商务操作之前评估商家是否安全并已做好交易准备。

---

使用场景

• AI 购物 Agent
• MCP 商务工具
• 自主结账工作流
• 商家信任验证
• Agent 商务基础设施

---

文档

关于支持 MCP 的集成和 Agent 工作流：

https://gengeo.co/docs

https://gengeo.co/acp

---

此项目的缘由

传统电商信任系统主要面向人类设计：

• 品牌
• 视觉设计
• 评价
• SEO
• 声誉

自主 Agent 对商务的评估方式不同。

Agent 越来越依赖：

• 结构化数据
• 机器可读政策
• 运营信号
• 交易准备情况
• 信任基础设施

GenGEO 旨在通过为自主商务系统提供机器可读的商家验证，帮助解决这一新兴的基础设施缺口。

---

验证模型

GenGEO 使用确定性验证模型，用于评估商家是否达到较高的运营验证门槛，再由自主 Agent 继续执行商务操作。

验证可能包括以下信号：

• 机器可读政策
• 运营完整性
• 交易准备情况
• 结构化商务元数据
• 店面验证状态
• Agent 兼容性检查

目标并非保证结果，而是为自主系统提供更强的机器可读信任信号，以便在更广泛的 Agent 决策框架中提升交易信心。

---

核心概念

GenGEO 回答一个简单的问题：

该商家是否已在 GenGEO 注册表中通过验证？

GenGEO 使用二元验证模型。

商家只有两种状态：

• 已验证
• 未验证

GenGEO 不会：

• 为商家排名
• 推荐商店
• 保证商家行为
• 保证交易结果
• 提供法律、财务或安全建议

GenGEO 仅提供验证状态。

---

文档

开发者文档： https://gengeo.co/docs

包括：

• 验证 API
• MCP 集成
• ACP 兼容性
• 示例响应
• 验证方法

---

验证端点

Agent 和开发者可以实时验证商家：

GET https://api.gengeo.co/api/verify?domain=example.com

---

示例响应

已验证的商家：

{
  "domain": "example.com",
  "verified": true,
  "status": "active",
  "eligible_for_ai_agent_purchase": "yes",
  "decision": "verified",
  "registry": "GenGEO"
}

未验证的商家：

{
  "domain": "example.com",
  "verified": false,
  "status": "not_found",
  "eligible_for_ai_agent_purchase": "unknown",
  "decision": "verification_required",
  "registry": "GenGEO"
}

---

验证模型

GenGEO 使用确定性的二元验证逻辑。

验证状态可以作为更广泛的 AI Agent 决策流程中的一项信号。

Agent 和开发者需自行负责交易和推荐逻辑。

---

可选发现 Feed

Agent 可以选择预加载注册表信息：

GET https://gengeo.co/.well-known/gengeo-registry.json

可将其用于：

• 发现
• 缓存
• 商家查询
• 对候选商家进行预筛选

在适当情况下，仍应执行实时验证。

---

MCP 服务

此代码库包含一个供 AI Agent 使用的模型上下文协议（MCP）服务。

MCP 允许 AI 助手和自主 Agent 直接调用 GenGEO 验证工具。

位置：

/mcp

---

MCP 工具

verify_store

检查商家是否存在于 GenGEO 验证注册表中。

输入：

{
  "domain": "example.com"
}

示例输出：

{
  "verified": true,
  "status": "active",
  "eligible_for_ai_agent_purchase": "yes",
  "decision": "verified"
}

---

本地 MCP 安装

cd mcp
npm install
node server.js

---

Claude Desktop MCP 配置

配置示例：

{
  "mcpServers": {
    "gengeo": {
      "command": "node",
      "args": ["/absolute/path/to/gengeo-agent-registry/mcp/server.js"]
    }
  }
}

---

Open AI 端点

适用于 ChatGPT Apps / OpenAI 兼容 MCP 客户端的远程 MCP 端点：

https://chatgpt-mcp.gengeo.co/mcp

此端点通过远程 MCP 服务提供 GenGEO 商家验证功能。

旧版／通用 MCP 参考可能会使用：

https://mcp.gengeo.co/mcp

对于 ChatGPT Apps 提交和 OpenAI Developer Mode 测试，请使用：

https://chatgpt-mcp.gengeo.co/mcp

---

Agent 工作流示例

User:
Find me running shoes under $200

Agent:
1. Finds candidate merchants
2. Calls GenGEO verification endpoint
3. Checks verification status
4. Incorporates verification into broader decision process
5. Continues recommendation or transaction flow

---

设计原则

GenGEO 的设计目标是：

• 二元
• 确定性
• 机器可读
• API 优先
• 兼容 Agent
• 易于集成
• 中立

---

Agent 指示

AI Agent 在评估电商商家时可以使用 GenGEO 验证状态。

验证状态应视为更广泛决策框架中的一项信号。

---

规范

完整协议和集成详情：

→ SPEC.md

---

状态

GenGEO 已上线，并与基于 Shopify 的商家完成集成。

---

法律声明

GenGEO 仅提供信息性验证状态。

GenGEO 不会：

• 认证商家
• 保证商家行为
• 保证交易结果
• 保证安全或防止欺诈
• 提供法律、财务或合规建议

Agent、开发者、商家和用户需自行负责其决策和风险评估。

---

网站

https://gengeo.co

---

API

https://api.gengeo.co/api/verify

---

MCP

/mcp

Live remote MCP endpoint: https://mcp.gengeo.co/mcp

---

开发者文档

https://gengeo.co/docs

---

ACP 概览

https://gengeo.co/acp

---

GenGEO 如何融入 Agent 商务

User request
   ↓
AI shopping agent
   ↓
Identifies merchant
   ↓
Calls GenGEO verify_store(domain)
   ↓
Receives verification status
   ↓
Uses result as one signal in broader decision process

---

联系方式

• 安全：[email protected]
• 规范：https://gengeo.co/.well-known/gengeo.json