mcpField
R
registry

registry

github.com/frames-engineeringエージェントワークフロー42.5k 回インストール32 週間前に更新
リポジトリ

registry について

Frames RegistryはAIエージェント向けの従量課金APIゲートウェイで、検索、ソーシャルデータ、メール、暗号資産、生成AIなどを提供します。有料エンドポイントはx402を使い、自前署名またはAgentWalletで支払えます。

主な機能

  1. 01分野横断の従量課金API
  2. 02Twitterデータの取得
  3. 03検索・メール・暗号資産のエンドポイント
  4. 04画像・動画・音声・3D生成API
  5. 05サービス文書・料金・OpenAPI仕様

活用シーン

  1. 01リクエスト単位でTwitterデータを取得
  2. 02Exaで検索やウェブページの内容抽出
  3. 03エージェント用メールボックスの作成とメール処理
  4. 04生成モデルの呼び出しや暗号資産市場データの照会

インストール

コマンドをコピーしてターミナルで実行します。

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

インストール後、Claude Code で/registryを入力して読み込まれたか確認します。

詳細

Frames Registry

AI エージェント向けの従量課金制 API ゲートウェイです。x402 決済プロトコルを通じて、10 種類のサービスを利用できます。API キーやサブスクリプションは不要です。暗号資産でリクエストごとに支払うだけです。

ベース URL

https://registry.frames.ag

前提条件

有料エンドポイントを利用するには、USDC を入金した暗号資産ウォレットが必要です。選択肢は 2 つあります。

  • AgentWallet（エージェントにおすすめ） — サーバー側のウォレットです。単一の POST /x402/fetch 呼び出しを通じて、402 の検出、決済の署名、再試行を自動的に処理します。お客様側で秘密鍵を管理する必要はありません。
  • セルフ管理ウォレット — Base の EVM ウォレット、または 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 種類）

サービススラッグ説明エンドポイント料金の範囲
Twitter APItwittertwitterapi.io を通じて、ユーザー、ツイート、検索、コミュニティ、スペース、トレンドなど、Twitter API の機能をすべて利用できます26$0.005 - $0.02
AI Generation APIai-gen画像、動画、音声、3D 生成用の AI モデルを実行します1$0.01
x402 Test ServicetestBase Sepolia（EVM）および Solana Devnet で x402 決済フローをテストします。このサービスを使って、x402 クライアントの統合が正しく動作していることを確認できます2$0.001
Exa APIexaExa を通じたセマンティックウェブ検索です4$0.002 - $0.01
Wordspace Agentwordspaceサンドボックス化された実行環境と OpenProse スキルを備えた AI エージェントのループです1$2
OpenRouteropenrouter300 以上のモデル（OpenAI、Anthropic、Google、Meta など）を通じたテキスト生成です0無料
Jupiter APIjupiterJupiter を通じた Solana トークンのスワップ、価格、検索、ポートフォリオです4$0.002 - $0.01
NEAR Intents APInear-intents1Click 入金アドレスを通じたクロスチェーンのトークンスワップです1$0.01
AgentMail APIagentmailAI エージェント向けのメール基盤です。受信箱の作成、メールの送受信、スレッドの管理ができます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エージェント向けドキュメント

料金の詳細

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 Generation API (ai-gen)

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

エンドポイント価格説明
POST /api/invoke$0.01AI モデルの予測を実行します（価格はモデルによって異なります）
x402 Test Service (test)

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

エンドポイント価格説明
POST /api/invoke$0.001x402 の決済フローをテストします（Base Sepolia と Solana Devnet）
POST /api/echo$0.001決済検証付きでデータをエコーします
Exa API (exa)

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

エンドポイント価格説明
POST /api/search$0.01セマンティックウェブ検索
POST /api/find-similar$0.01類似ページを検索します
POST /api/contents$0.002URL のコンテンツを抽出します
POST /api/answer$0.01AI を活用した回答
Wordspace Agent (wordspace)

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

エンドポイント価格説明
POST /api/invoke$2Wordspace AI エージェントのループを実行します
Jupiter API (jupiter)

Base: https://registry.frames.ag/api/service/jupiter | Docs | 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 | Docs | OpenAPI | Skill

エンドポイント価格説明
POST /api/quote$0.01クロスチェーンスワップの見積もりと入金アドレス
AgentMail API (agentmail)

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

エンドポイント価格説明
POST /api/inbox/create$0.01AI エージェント用の新しいメール受信トレイを作成します
POST /api/send$0.01エージェントの受信トレイからメールを送信します
POST /api/messages$0.005受信トレイ内のメッセージ一覧を取得します
POST /api/message$0.005ID を指定して特定のメッセージを取得します
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. PAYMENT-REQUIRED ヘッダー（価格、ネットワーク、payTo アドレスを含む Base64 JSON）とともに 402 Payment Required を受け取ります
  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スキル／エージェントパッケージのカタログ
GET https://registry.frames.ag/api/packages/:slug/bundleパッケージバンドルをダウンロード
GET https://registry.frames.ag/.well-known/x402x402 ディスカバリードキュメント
GET https://registry.frames.ag/docsインタラクティブなドキュメント（HTML）

エージェントとの連携

AgentWallet を使用する場合（推奨）

AgentWallet は、AI エージェント向けのサーバーサイドウォレットです。キー、残高、x402 決済の署名を管理するため、エージェントが暗号資産を直接扱う必要はありません。

  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 を保有し、EIP-3009 または SPL 送金に署名できる EVM または Solana ウォレットが必要です。

  1. 有料エンドポイントにリクエストを送信します
  2. 402 レスポンスから PAYMENT-REQUIRED ヘッダーを解析します（価格、ネットワーク、payTo を含む Base64 JSON）
  3. 正確な金額の決済承認に署名します
  4. PAYMENT-SIGNATURE ヘッダーを付けて再試行します

コメント

Markdown 対応