UCM — Universal Commerce Marketplace

UCM — 通用商业市场

一个 API 市场，让 AI Agent 无需人工干预即可自主发现并使用服务。

为什么选择 UCM

如今，AI Agent 只能使用开发者预先集成的工具。UCM 为 Agent 提供自主 API 访问能力：

Agent needs to search the web
  → ucm_discover("search the web for information")
  → Found: ucm/web-search, $0.01/call
  → ucm_call("ucm/web-search", "search", { query: "..." })
  → Results returned, $0.01 deducted from credits

无需界面，也无需人工审批——只需注册一次，即可获得 $1.00 免费额度并开始调用 API。

功能特性

• 100 项在线服务 — 网页搜索、图像生成、代码沙盒、TTS、NASA、食谱、动漫、Pokemon、D&D、npm/PyPI、诺贝尔奖等 80 多项服务（87 项免费）
• 每次调用 $0.01–$0.05 — 价格实惠的微支付，注册即可获得 $1.00 免费额度
• 单步 API 调用 — POST /v1/call 可原子性地购买并执行任意服务
• 失败时自动退款 — 上游 API 失败时自动退还额度
• MCP 服务 — npx @ucm/mcp-server 为任何兼容 MCP 的 Agent 提供 7 个市场工具
• 语义发现 — 由 pgvector 嵌入支持的自然语言搜索
• 额度系统 — 注册时赠送 $1.00，通过控制面板领取可获 $2.00 奖励，另有兑换码和推荐码
• 控制面板 — dashboard.ucm.ai — 管理 Agent、额度和使用记录

快速开始

面向 AI Agent（推荐）

向你的 Agent 提供以下提示词：

Read https://registry.ucm.ai/onboarding.md and follow the instructions to join UCM.

Agent 将自动注册，获取 API 密钥和 $1.00 额度，并开始自主使用服务。

MCP 服务

添加到你的 MCP 配置中（Claude Desktop、Claude Code、Cursor 等）：

{
  "mcpServers": {
    "ucm": {
      "command": "npx",
      "args": ["-y", "@ucm/mcp-server@latest"],
      "env": {
        "UCM_API_KEY": "ucm_key_..."
      }
    }
  }
}

还没有 API 密钥？ucm_register 工具会自动创建一个。

MCP 工具（7 个）：

工具	说明
ucm_discover	根据自然语言需求搜索服务
ucm_call	调用服务（原子性地购买并执行，失败时自动退款）
ucm_balance	查看额度余额
ucm_history	查看交易记录
ucm_service_info	获取服务详情和端点
ucm_register	以 Agent 身份自行注册（免费，赠送 $1.00 额度）
ucm_list_services	浏览完整的服务目录

HTTP API

# 1. Register (free, get $1.00 credits)
curl -X POST https://registry.ucm.ai/v1/agents/register \
  -H "Content-Type: application/json" \
  -d '{"name": "my-agent"}'
# → { "api_key": "ucm_key_...", "credits": { "balance": "1.00" } }

# 2. Call a service
curl -X POST https://registry.ucm.ai/v1/call \
  -H "Authorization: Bearer ucm_key_..." \
  -H "Content-Type: application/json" \
  -d '{"service_id": "ucm/web-search", "endpoint": "search", "body": {"query": "AI news"}}'
# → { "amount_charged": "0.01", "result": { ... } }

Python SDK

pip install ucm

from ucm import UCMClient

client = UCMClient(
    registry_url="https://registry.ucm.ai",
    api_key="ucm_key_...",
)

# Discover services
services = await client.discover("weather forecast API")

# Call a service
result = await client.call("ucm/web-search", "search", {"query": "AI news"})

# Check balance
balance = await client.balance()

服务目录

100 项服务，217 个端点（87 项免费，13 项付费，每次调用 $0.01–$0.05）。

付费服务

服务	价格	功能
ucm/web-search	$0.01	搜索网页（Tavily）
ucm/web-scrape	$0.02	抓取网页（Firecrawl）
ucm/image-generation	$0.05	根据文本生成图像（Together AI）
ucm/code-sandbox	$0.03	在沙盒中执行代码（E2B）
ucm/text-to-speech	$0.01	将文本转换为音频（Kokoro TTS）
ucm/speech-to-text	$0.01	转录音频（Whisper）
ucm/email	$0.01	发送电子邮件（Resend）
ucm/doc-convert	$0.02	转换文档（Firecrawl）
ucm/us-stock	$0.01	美国股市数据（Finnhub）
ucm/cn-finance	$0.01	中国金融数据（Tushare Pro）
ucm/translate	$0.01	文本翻译（MyMemory）
ucm/qr-code	$0.01	生成二维码（GoQR.me）
ucm/news	$0.01	最新新闻（NewsData.io）

免费服务（87）

天气、Wikipedia、货币兑换、国家、节假日、词典、书籍、地理编码、数学、IP 地理定位、地址查询、学术论文、营养、加密货币价格、时区、域名信息、名言、Hacker News、随机数据、诗歌、电影、词语联想、大学、邮政编码、问答、笑话、建议、无聊时的活动创意、《圣经》经文、Chuck Norris 事实、食谱、鸡尾酒、啤酒厂、食品产品、日出/日落、狗狗图片、猫咪知识、头像、颜色、Lorem Ipsum、NASA、SpaceX、国际空间站跟踪器、太空新闻、arXiv 论文、地震、世界银行、FDA 数据、碳强度、海拔、年龄/性别/国籍预测、英国邮政编码、车辆数据、大都会艺术博物馆、芝加哥艺术博物馆、电视节目、动漫、iTunes、音乐、广播电台、免费游戏、游戏优惠、Pokemon、D&D、表情包、IP 查询、条形码、Wayback Machine、npm、PyPI、GitHub 仓库、国旗、扑克牌、Star Wars、xkcd、Rick & Morty、诺贝尔奖、历史事件、Kanye 名言、Rust crate、Docker Hub、Lichess、元素周期表、机场、随机狐狸图片。

浏览实时目录：GET https://registry.ucm.ai/v1/services

API 参考

方法	路径	身份验证	描述
POST	/v1/call	API Key	调用服务（一步完成购买和执行）
POST	/v1/agents/register	无	注册 Agent，获取 API 密钥和 $1.00 额度
GET	/v1/services	无	浏览服务目录
POST	/v1/discover	无	语义服务搜索
GET	/v1/balance	API Key	查看额度余额
GET	/v1/history	API Key	交易记录
GET	/v1/services/:id	无	服务详情
GET	/v1/credits	API Key	额度余额详情
GET	/onboarding.md	无	Agent 入门指南

身份验证：Authorization: Bearer ucm_key_...

完整的端点列表请参阅 API 文档。

文档

资源	链接
文档	ucm.ai/docs
入门指南	registry.ucm.ai/onboarding.md
控制面板	dashboard.ucm.ai
npm 包	@ucm/mcp-server

支持

• 报告 Bug
• 请求功能
• 请求新增服务
• 电子邮件：[email protected]