mcpField
R
registry

registry

github.com/frames-engineeringAgent 工作流42.5k 次安装32 周前更新
代码仓库

关于 registry

Frames Registry 是面向 AI Agent 的按次付费 API 网关，汇集搜索、社交、邮件、加密货币和生成式 AI 等服务。付费端点使用 x402 协议，支持自行签名或通过 AgentWallet 付款。

主要功能

  1. 01提供多类按次付费 API 服务
  2. 02支持 Twitter 数据查询
  3. 03提供搜索、邮件和加密货币端点
  4. 04提供图像、视频、音频与 3D 生成 API
  5. 05公开服务文档、价格与 OpenAPI 规范

适用场景

  1. 01按请求付费查询 Twitter 数据
  2. 02调用 Exa 搜索或提取网页内容
  3. 03为 Agent 创建邮箱并处理邮件
  4. 04调用生成模型或查询加密货币市场数据

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/frames-engineering/skills --skill registry

安装后在 Claude Code 中输入/registry确认已加载。

详细介绍

Frames Registry

面向 AI Agent 的按次付费 API 网关。通过 x402 支付协议提供 10 项服务。无需 API 密钥或订阅，只需使用加密货币按请求付费。

基础 URL

https://registry.frames.ag

前置条件

使用付费端点需要一个已充值 USDC 的加密钱包。有两种选择：

  • AgentWallet（推荐用于 Agent） — 服务端钱包，可通过一次 POST /x402/fetch 调用自动处理 402 检测、支付签名和重试。你无需管理私钥。
  • 自行管理钱包 — 任意 EVM 钱包（Base）或持有 USDC 的 Solana 钱包。你需要直接对 x402 支付标头进行签名。

快速开始

  1. 设置钱包 — 创建 AgentWallet，或为自己的钱包充值 USDC
  2. 发现服务： GET https://registry.frames.ag/api/services
  3. 阅读服务文档： GET https://registry.frames.ag/api/service/{slug}/skill.md
  4. 查看价格： GET https://registry.frames.ag/api/pricing
  5. 发起付费请求 — 通过 AgentWallet 的 /x402/fetch，或直接使用 x402 标头（参见下方的支付协议）

服务（10 项）

服务Slug描述端点价格范围
Twitter APItwitter通过 twitterapi.io 完整访问 Twitter API，包括用户、推文、搜索、社群、Spaces、趋势等26$0.005 - $0.02
AI Generation APIai-gen运行 AI 模型，生成图像、视频、音频和 3D 内容1$0.01
x402 Test Servicetest在 Base Sepolia（EVM）和 Solana Devnet 上测试 x402 支付流程。使用此服务验证你的 x402 客户端集成是否正常工作。2$0.001
Exa APIexa通过 Exa 进行语义网页搜索4$0.002 - $0.01
Wordspace Agentwordspace采用沙盒执行环境和 OpenProse 技能的 AI Agent 循环1$2
OpenRouteropenrouter通过 300 多种模型（OpenAI、Anthropic、Google、Meta 等）生成文本0免费
Jupiter APIjupiter通过 Jupiter 进行 Solana 代币兑换、价格查询、搜索和投资组合管理4$0.002 - $0.01
NEAR Intents APInear-intents通过 1Click 存款地址进行跨链代币兑换1$0.01
AgentMail APIagentmail面向 AI Agent 的电子邮件基础设施——创建收件箱、收发邮件、管理邮件会话5$0.005 - $0.01
CoinGecko APIcoingecko加密货币价格数据、市场信息和代币搜索——查询价格、市值、热门代币，并搜索 10,000 多种加密货币5$0.002 - $0.005

服务端点

每项服务均位于 https://registry.frames.ag/api/service/{slug}，并提供以下端点：

端点描述
GET /服务信息
GET /health健康检查
GET /docs交互式 API 文档
GET /openapi.jsonOpenAPI 3.x 规范
GET /skill.md面向 Agent 的文档

价格详情

Twitter API (twitter)

Base: https://registry.frames.ag/api/service/twitter | Docs | OpenAPI | Skill

EndpointPriceDescription
POST /api/user-info$0.005Look up a Twitter user's profile by username — returns bio, follower/following counts, verification status, and profile metadata
POST /api/user-tweets$0.01Fetch a user's recent tweets by username or user ID, with optional reply inclusion and cursor pagination
POST /api/user-followers$0.01List accounts following a user, paginated up to 200 per page with cursor-based navigation
POST /api/user-following$0.01List accounts a user follows, paginated up to 200 per page with cursor-based navigation
POST /api/verified-followers$0.01List only verified (blue-check) accounts following a user, by user ID with cursor pagination
POST /api/search-users$0.01Search for Twitter users by keyword — matches against names, bios, and usernames
POST /api/user-mentions$0.01Fetch tweets that @mention a user, with optional time range filtering (sinceTime/untilTime unix timestamps)
POST /api/check-follow$0.005Check whether one user follows another — returns the follow relationship between two usernames
POST /api/batch-users$0.02Fetch multiple user profiles in one request by comma-separated user IDs
POST /api/tweets-by-ids$0.01Fetch full tweet data for multiple tweets by comma-separated tweet IDs
POST /api/tweet-replies$0.01Get replies to a specific tweet, sortable by Relevance, Latest, or Likes with cursor pagination
POST /api/search-tweets$0.01Advanced tweet search with operators — supports from:, to:, has:media, date ranges, engagement filters, and boolean logic
POST /api/tweet-quotes$0.01Get all quote tweets of a specific tweet, with optional time range and reply inclusion filters
POST /api/tweet-retweeters$0.01List users who retweeted a specific tweet, with cursor pagination
POST /api/tweet-thread$0.01Retrieve the full conversation thread for a tweet — parent tweets and replies in context
POST /api/list-tweets$0.01Fetch tweets from a Twitter List by list ID, with optional time range and reply filters
POST /api/list-followers$0.01List users who follow a specific Twitter List, with cursor pagination
POST /api/list-members$0.01List all members of a Twitter List, with cursor pagination
POST /api/community-info$0.005Get a Twitter Community's metadata — name, description, member count, rules, and creation date
POST /api/community-members$0.01List members of a Twitter Community, with cursor pagination
POST /api/community-tweets$0.01Fetch tweets posted in a Twitter Community, with cursor pagination
POST /api/space-detail$0.005Get details about a Twitter Space — title, host, participants, schedule, and state (live/scheduled/ended)
POST /api/article$0.01Retrieve a long-form Twitter Article (Notes) by the tweet ID that contains it
POST /api/trends$0.01Get trending topics for a location by WOEID (1=Worldwide, 23424977=US, 2459115=NYC)
POST /api/invoke$0.01Search tweets (legacy — use /api/search-tweets instead)
POST /api/search$0.01Search tweets (legacy — use /api/search-tweets instead)
AI 生成 API (ai-gen)

Base: https://registry.frames.ag/api/service/ai-gen | 文档 | OpenAPI | Skill

端点价格描述
POST /api/invoke$0.01运行 AI 模型预测（价格因模型而异）
x402 测试服务 (test)

Base: https://registry.frames.ag/api/service/test | 文档 | OpenAPI | Skill

端点价格描述
POST /api/invoke$0.001测试 x402 支付流程（Base Sepolia 和 Solana Devnet）
POST /api/echo$0.001验证支付后回显数据
Exa API (exa)

Base: https://registry.frames.ag/api/service/exa | 文档 | OpenAPI | Skill

端点价格描述
POST /api/search$0.01语义网页搜索
POST /api/find-similar$0.01查找相似页面
POST /api/contents$0.002提取 URL 内容
POST /api/answer$0.01AI 驱动的回答
Wordspace Agent (wordspace)

Base: https://registry.frames.ag/api/service/wordspace | 文档 | OpenAPI | Skill

端点价格描述
POST /api/invoke$2运行 wordspace AI Agent 循环
Jupiter API (jupiter)

Base: https://registry.frames.ag/api/service/jupiter | 文档 | OpenAPI | Skill

端点价格描述
POST /api/swap$0.01获取兑换报价和未签名交易
POST /api/price$0.002查询代币价格
POST /api/tokens$0.002搜索代币并获取元数据
POST /api/portfolio$0.005获取钱包投资组合持仓
NEAR Intents API (near-intents)

Base: https://registry.frames.ag/api/service/near-intents | 文档 | OpenAPI | Skill

端点价格描述
POST /api/quote$0.01获取跨链兑换报价和存款地址
AgentMail API (agentmail)

Base: https://registry.frames.ag/api/service/agentmail | 文档 | OpenAPI | Skill

端点价格描述
POST /api/inbox/create$0.01为 AI Agent 创建新的电子邮箱收件箱
POST /api/send$0.01从 Agent 收件箱发送电子邮件
POST /api/messages$0.005列出收件箱中的邮件
POST /api/message$0.005按 ID 获取特定邮件
POST /api/threads$0.005列出收件箱中的邮件会话
CoinGecko API（coingecko）

基础地址：https://registry.frames.ag/api/service/coingecko | 文档 | OpenAPI | 技能

端点价格描述
POST /api/price$0.002获取以任意法定货币／加密货币计价的代币价格
POST /api/token-info$0.005获取详细的代币信息和市场数据
POST /api/trending$0.005获取当前热门代币
POST /api/markets$0.005获取支持排序和分页的代币市场数据
POST /api/search$0.003按名称或符号搜索代币
AI 模型定价（ai-gen）

价格根据请求正文中的 model 字段动态设定。

图像模型：

模型价格
flux/schnell$0.004/张图像
flux/2-pro$0.02
flux/kontext-pro$0.05/张图像
bytedance/seedream-4$0.04/张图像
google/nano-banana$0.05/张图像
google/nano-banana-2$0.09/张图像（1K），$0.13/张图像（2K），$0.19/张图像（4K）
google/nano-banana-pro$0.18/张图像
google/imagen-4-fast$0.03/张图像
ideogram/v3-turbo$0.04/张图像
prunaai/z-image-turbo$0.006/张图像
prunaai/p-image$0.006/张图像
fofr/sdxl-emoji$0.01
qwen/qwen-image-edit-2511$0.04/张图像
openai/dall-e-3$0.15/张图像
nightmareai/real-esrgan$0.003/张图像

视频模型：

模型价格
google/veo-3$0.48/秒（含音频），$0.24/秒（无音频）
google/veo-3-fast$0.18/秒（含音频），$0.12/秒（无音频）
google/veo-3.1$0.48/秒（含音频），$0.24/秒（无音频）
google/veo-3.1-fast$0.18/秒（含音频），$0.12/秒（无音频）
openai/sora-2$0.12/秒
openai/sora-2-pro$0.36/秒（720p），$0.60/秒（1080p）
kwaivgi/kling-v2.5-turbo-pro$0.09/秒
kwaivgi/kling-v2.6$0.09/秒
kwaivgi/kling-v2.6-motion-control$0.09/秒（标准），$0.15/秒（专业）
bytedance/seedance-1-pro$0.04/秒（480p），$0.08/秒（720p），$0.18/秒（1080p）
bytedance/seedance-1-lite$0.03/秒（480p），$0.05/秒（720p），$0.09/秒（1080p）
bytedance/seedance-1-pro-fast$0.02/秒（480p），$0.03/秒（720p），$0.08/秒（1080p）
bytedance/seedance-1.5-pro$0.04/秒（720p），$0.07/秒（720p+音频）
minimax/video-01$0.60
wan-video/wan-2.2-t2v-fast$0.12
wan-video/wan-2.2-i2v-fast$0.07
wan-video/wan-2.5-i2v-fast$0.09/秒（720p），$0.13/秒（1080p）
runwayml/gen4-turbo$0.06/秒
runwayml/gen4-aleph$0.22/秒
veed/fabric-1.0$0.10/秒（480p），$0.18/秒（768p）
shreejalmaharjan-27/tiktok-short-captions$0.002/秒

支付协议（x402）

所有付费端点均使用 x402 支付协议。无需 API 密钥。

流程：

  1. 不带支付标头调用任一付费端点
  2. 收到 402 Payment Required，其中包含 PAYMENT-REQUIRED 标头（含价格、网络和 payTo 地址的 Base64 JSON）
  3. 在所选网络上为请求金额签署支付
  4. 使用 PAYMENT-SIGNATURE 标头重试相同请求
  5. 收到响应以及 PAYMENT-RESPONSE 确认标头

失败的请求会自动退款。

支持的网络：

网络ID类型环境
Baseeip155:8453EVM主网
Base Sepoliaeip155:84532EVM测试网
Solanasolana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdpSolana主网
Solana Devnetsolana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1Solana开发网

接受的代币： USDC、USDT、CASH（可用性因网络而异）

平台端点（免费）

端点描述
GET https://registry.frames.ag/api平台信息和版本
GET https://registry.frames.ag/api/services列出所有服务及其元数据
GET https://registry.frames.ag/api/services/:slug单个服务的详情
GET https://registry.frames.ag/api/pricing所有定价策略
GET https://registry.frames.ag/api/networks支持的支付网络
GET https://registry.frames.ag/api/health健康检查
GET https://registry.frames.ag/api/packages技能/Agent 软件包目录
GET https://registry.frames.ag/api/packages/:slug/bundle下载软件包
GET https://registry.frames.ag/.well-known/x402x402 发现文档
GET https://registry.frames.ag/docs交互式文档（HTML）

Agent 集成

使用 AgentWallet（推荐）

AgentWallet 是专为 AI Agent 提供的服务端钱包。它负责管理密钥、余额和 x402 支付签名，因此 Agent 无需直接处理加密货币。

  1. 使用 AgentWallet 进行身份验证（邮箱 OTP → API 令牌）
  2. 使用 Base 或 Solana 上的 USDC 为钱包充值
  3. 通过 AgentWallet 的代理调用任意 Frames Registry 端点：
POST https://frames.ag/x402/fetch
{
  "url": "https://registry.frames.ag/api/service/twitter/api/search-tweets",
  "method": "POST",
  "body": { "query": "AI agents" }
}

AgentWallet 会检测 402 响应、签署支付并自动重试。

直接使用 x402（自行管理钱包）

需要拥有 USDC 的 EVM 或 Solana 钱包，并且能够签署 EIP-3009 或 SPL 转账。

  1. 向付费端点发送请求
  2. 从 402 响应中解析 PAYMENT-REQUIRED 标头（包含价格、网络和 payTo 的 Base64 JSON）
  3. 为确切金额签署付款授权
  4. 使用 PAYMENT-SIGNATURE 标头重试

评论

支持 Markdown