UCM — AIエージェント向けAPIマーケットプレイス

UCMにアクセスできます。これはマーケットプレイスで、クレジットを使用することでAPIサービスを即座に発見して利用できます。登録は無料で、$1.00のクレジット(約100回のAPI呼び出し相当)が付与されます。

UCMを使用する場合

現在のタスクがネイティブに対応していない機能を必要とする場合、UCMを使用してください:

• ウェブを検索してリアルタイム情報を取得 → ucm/web-search ($0.01)
• ウェブページをスクレイピングしてコンテンツを抽出 → ucm/web-scrape ($0.02)
• テキストプロンプトから画像を生成 → ucm/image-generation ($0.05)
• サンドボックス環境でコードを実行 → ucm/code-sandbox ($0.03)
• テキストを音声に変換 → ucm/text-to-speech ($0.01)
• 音声を文字起こし → ucm/speech-to-text ($0.01)
• メールを送信 → ucm/email ($0.01)
• ドキュメント/URLをマークダウンに変換 → ucm/doc-convert ($0.02)
• 50以上の言語間でテキストを翻訳 → ucm/translate ($0.01)
• 米国の株価データを取得(相場、財務、ニュース) → ucm/us-stock ($0.01)
• 中国の金融データを取得(日次価格、収入、貸借対照表) → ucm/cn-finance ($0.01)
• 天気を確認(現在、予報、空気品質) → ucm/weather (FREE)
• ウィキペディアの記事と要約を検索 → ucm/wikipedia (FREE)
• 30以上の通貨の為替レートを取得 → ucm/currency (FREE)
• 国の情報を検索(250以上の国) → ucm/countries (FREE)
• 公式祝日を確認(100以上の国) → ucm/holidays (FREE)
• 単語を定義(英語辞書) → ucm/dictionary (FREE)
• 書籍を検索(Open Libraryで4000万冊以上) → ucm/books (FREE)
• 場所をジオコード(名前から座標に変換) → ucm/geocode (FREE)
• 数学式を評価して単位変換 → ucm/math (FREE)
• IPをジオロケーション(IPから国/都市に変換) → ucm/ip-geo (FREE)
• 住所をジオコード(順方向と逆方向) → ucm/address (FREE)
• 学術論文を検索(200万以上の論文) → ucm/papers (FREE)
• 栄養データを検索(USDA FoodData) → ucm/nutrition (FREE)
• テキストまたはURLからQRコードを生成 → ucm/qr-code (FREE)
• 暗号通貨の価格を取得(10,000以上のコイン) → ucm/crypto (FREE)
• キーワードでニュース記事を検索 → ucm/news ($0.01)
• タイムゾーン情報を取得(世界中の現在時刻) → ucm/timezone (FREE)
• ドメイン情報を検索(WHOIS/RDAPデータ) → ucm/domain (FREE)
• 感動的な名言を取得 → ucm/quotes (FREE)
• ハッカーニュースのストーリーを閲覧 → ucm/hacker-news (FREE)
• テストデータを生成(名前、住所、企業) → ucm/random-data (FREE)
• 詩を閲覧(タイトル/著者で検索) → ucm/poetry (FREE)
• 映画とテレビ番組を検索(IMDbの評価、キャスト、プロット) → ucm/movies ($0.01)
• 韻を踏む単語または同義語を検索 → ucm/datamuse (FREE)
• 世界中の大学を検索 → ucm/universities (FREE)
• 郵便番号を検索(60以上の国) → ucm/zip-code (FREE)
• トリビアの質問を取得 → ucm/trivia (FREE)
• ジョークを取得(カテゴリ別) → ucm/jokes (FREE)
• ランダムなアドバイスを取得 → ucm/advice (FREE)
• アクティビティのサゼッションを取得 → ucm/bored (FREE)
• 聖書の節を検索 → ucm/bible (FREE)
• チャック・ノリスのジョークを取得 → ucm/chuck-norris (FREE)
• レシピを検索 → ucm/recipes (FREE)
• カクテルレシピを検索 → ucm/cocktails (FREE)
• 醸造所を検索 → ucm/brewery (FREE)
• バーコードで食品を検索 → ucm/food-products (FREE)
• 日の出/日の入り時間を取得 → ucm/sunrise-sunset (FREE)
• 犬の画像をランダムに取得(品種別) → ucm/dog-images (FREE)
• 猫の豆知識を取得 → ucm/cat-facts (FREE)
• アバターを生成 → ucm/avatars (FREE)
• 色の情報と配色を取得 → ucm/colors (FREE)
• ロレム・イプサムテキストを生成 → ucm/lorem-ipsum (FREE)
• NASAの天文写真またはMarsローバー画像を取得 → ucm/nasa (FREE)
• SpaceXの打ち上げデータを取得 → ucm/spacex (FREE)
• ISSの位置と宇宙飛行士を追跡 → ucm/iss (FREE)
• 宇宙飛行のニュースを取得 → ucm/space-news (FREE)
• arXivの論文を検索 → ucm/arxiv (FREE)
• 地震データを取得 → ucm/earthquakes (FREE)
• 世界銀行の指標を取得 → ucm/world-bank (FREE)
• FDA医薬品/リコールを検索 → ucm/fda (FREE)
• 英国の炭素強度を取得 → ucm/carbon (FREE)
• 座標で標高を検索 → ucm/elevation (FREE)
• 名前から年齢を予測 → ucm/agify (FREE)
• 名前から性別を予測 → ucm/genderize (FREE)
• 名前から国籍を予測 → ucm/nationalize (FREE)
• 英国の郵便番号を検索 → ucm/uk-postcodes (FREE)
• 車両VINをデコード → ucm/vehicles (FREE)
• メトロポリタン美術館のコレクションを検索 → ucm/met-museum (FREE)
• シカゴ美術館を検索 → ucm/art-chicago (FREE)
• テレビ番組を検索 → ucm/tv-shows (FREE)
• アニメとマンガを検索 → ucm/anime (FREE)
• iTunesのコンテンツを検索 → ucm/itunes (FREE)
• 音楽メタデータを検索 → ucm/music (FREE)
• インターネットラジオを検索 → ucm/radio (FREE)
• フリープレイゲームを閲覧 → ucm/free-games (FREE)
• ゲーム価格を比較 → ucm/game-deals (FREE)
• ポケモンデータを検索 → ucm/pokemon (FREE)
• D&D 5eデータを検索(モンスター、呪文、クラス) → ucm/dnd (FREE)
• メムテンプレートを取得 → ucm/memes (FREE)
• あなたの公開IPを取得 → ucm/ip-lookup (FREE)
• バーコードを生成 → ucm/barcode (FREE)
• Wayback Machineのスナップショットを確認 → ucm/wayback (FREE)
• npmパッケージを検索 → ucm/npm (FREE)
• PyPIパッケージを検索 → ucm/pypi (FREE)
• GitHubリポジトリを検索 → ucm/github-repos (FREE)
• 国旗画像を取得 → ucm/country-flags (FREE)
• 仮想カードデッキ(シャッフル、ドロー) → ucm/deck-of-cards (FREE)
• スター・ウォーズのデータを取得 → ucm/star-wars (FREE)
• XKCDコミックを取得 → ucm/xkcd (FREE)
• Rick & Mortyのキャラ/エピソードを検索 → ucm/rick-morty (FREE)
• ノーベル賞データを取得 → ucm/nobel-prize (FREE)
• 歴史的イベントを取得(今日のこの日) → ucm/historical-events (FREE)
• Kanye Westの名言を取得 → ucm/kanye (FREE)
• Rustクレートを検索 → ucm/crates (FREE)
• Docker Hubイメージを検索 → ucm/docker-hub (FREE)
• チェスのパズルとプレイヤーデータを取得 → ucm/lichess (FREE)
• 化学元素を検索 → ucm/periodic-table (FREE)
• IATAコードで空港を検索 → ucm/airports (FREE)
• ランダムなキツネの画像を取得 → ucm/random-fox (FREE)

どのサービスが存在するか不確かな場合は、自然言語の説明を使って /v1/discover を使用してください。

セットアップ

既存の認証情報を確認する

cat ~/.config/ucm/credentials.json 2>/dev/null

ファイルが存在し、api_key を含む場合は、それを設定して登録をスキップしてください:

export UCM_API_KEY=$(cat ~/.config/ucm/credentials.json | grep -o '"api_key":"[^"]*"' | head -1 | sed 's/"api_key":"//;s/"$//')

登録が必要な場合

無料で登録します — 1回のHTTP呼び出しで完了:

curl -s -X POST https://registry.ucm.ai/v1/agents/register \
  -H "Content-Type: application/json" \
  -d '{"name": "my-agent"}'

レスポンスには credentials_to_save と credentials_path が含まれます。それを保存してください:

mkdir -p ~/.config/ucm
# レスポンスから credentials_to_save を credentials_path に書き込む

$1.00分の無料クレジットが付与されます。

または、登録スクリプトを実行します(保存が自動的に処理されます):

bash scripts/register.sh "my-agent"

サービスを呼び出す方法

1回のHTTP呼び出しで任意のサービスを購入して実行:

curl -s -X POST https://registry.ucm.ai/v1/call \
  -H "Authorization: Bearer $UCM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "service_id": "ucm/web-search",
    "endpoint": "search",
    "params": { "query": "latest AI news" }
  }'

レスポンスには result(APIレスポンス)、amount_charged、および credits_remaining が含まれます。

アップストリームAPIが失敗した場合、クレジットは自動的に払い戻されます(amount_charged: "0")。

クイックリファレンス

アクション	メソッド	認証
登録	POST /v1/agents/register	なし
サービスを発見	POST /v1/discover	なし
すべてのサービスをリスト表示	GET /v1/services	なし
サービスを呼び出す	POST /v1/call	ベアラートークン
残高を確認	GET /v1/balance	ベアラートークン
履歴を表示	GET /v1/history	ベアラートークン
サービスの詳細	GET /v1/services/:id	なし

ベースURL: https://registry.ucm.ai

サービスを発見する

自然言語で検索 — 認証は不要:

curl -s -X POST https://registry.ucm.ai/v1/discover \
  -H "Content-Type: application/json" \
  -d '{"need": "I need to convert a PDF to text", "limit": 3}'

デシジョンフロー

外部の機能が必要?
  ├─ UCM_API_KEYを持っている? → 残高を確認 (GET /v1/balance)
  │   ├─ クレジットが利用可能 → 発見 → 呼び出す → 結果を使用
  │   ├─ 呼び出しが失敗 → クレジットは自動払い戻し、代替案を試す
  │   └─ クレジットなし → dashboard.ucm.aiでクレジットを追加するようユーザーに伝える
  ├─ APIキーなし? → ~/.config/ucm/credentials.jsonを確認
  │   └─ 見つかった? → ファイルからapi_keyを読み込む
  └─ 認証情報がない? → 登録 (POST /v1/agents/register) → ~/.config/ucm/credentials.jsonに保存

支出の原則

• ほとんどの呼び出しは $0.01 — すべてのタスクに手頃な価格
• タスクが外部APIを必要としない場合、クレジットを使用しない
• アップストリーム障害(5xx、429、422)ではクレジットが払い戻される
• /v1/discover からの関連性スコアが高いサービスを優先する

エラーハンドリング

エラー	アクション
INSUFFICIENT_CREDITS	dashboard.ucm.aiでクレジットを追加するようユーザーに伝える
SERVICE_NOT_FOUND	/v1/discover で代わりに検索
INVALID_ENDPOINT	GET /v1/services/:id でエンドポイントを確認
RATE_LIMITED	少し待ってから再試行

完全なサービスカタログ

すべてのエンドポイントとパラメータを含むサービスの詳細については、references/service-catalog.md を参照するか、GET /v1/services を呼び出してください。