Unif API Docsクイックスタート
UnifAPI をエージェントに接続し、製品化するときに同じ公開データ呼び出しを HTTP 経由で行います。
ほとんどのユーザーが必要とする順序で UnifAPI を使用します。AI クライアントを公開データ MCP サーバーに接続し、エージェントやスキルを実行し、ライブな公開データツールがワークスペースのクレジットを必要としたときにサインインし、ワークフローを製品化したいときに HTTP を使用します。
オプション A: エージェントを接続する
公開データ MCP サーバー（読み取り専用、OAuth、API キー不要）を追加し、npx skills add でエージェントスキルを追加します。オープンソースのエージェントとスキルは github.com/unifapi-agent/agents にあります。
エージェントを接続する
お使いのクライアント向けのパスを使用します。それぞれがライブデータ用にホスト型 MCP サーバーを接続します。
エージェントスキルは npx skills add unifapi-agent/agents で追加します。
プロンプトを 1 つ貼り付ける（Claude Code、Codex、Cursor、OpenClaw、Goose、Hermes — 自身の MCP サーバーを管理するあらゆるエージェント）。これを貼り付けると、サーバーが追加され OAuth サインインが実行されます：
Install the UnifAPI MCP server for me at https://mcp.unifapi.com — a remote
(streamable HTTP) MCP server. It uses OAuth, read-only public data, no API key.Web コネクタ（Claude、ChatGPT、Perplexity、Grok）：
https://mcp.unifapi.com を指すカスタムコネクタを追加し、OAuth で認可します。ChatGPT では Developer Mode（Plus/Pro/Team/
Enterprise）が必要です：Settings -> Connectors -> Advanced -> enable Developer Mode -> Create。
Codex は MCP とスキルを別々に接続します。MCP サーバーを ~/.codex/config.toml に追加します：
[mcp_servers.unifapi]
url = "https://mcp.unifapi.com"その後 codex mcp login unifapi を実行し、スキル用に npx skills add unifapi-agent/agents を実行します。
Claude 互換のプラグインホスト（Claude Code、Claude Desktop、OpenClaw）は、スキルと MCP をワンショットでまとめてインストールできます：
/plugin marketplace add unifapi-agent/agents
/plugin install unifapi@unifapi完全なリファレンスと高度な手動 MCP セットアップについては エージェントを接続する を参照してください。
タスク結果を依頼する
新しいチャットやスレッドを開始し、欲しい成果物を説明します。例えば：
Analyze these Twitter/X KOLs for an AI developer-tool campaign: @vercel, @shadcn, @rauchg.
Use UnifAPI public data and return price ranges, evidence, confidence, and follow-up questions.エージェントから求められたら認証する
OAuth は、エージェントが UnifAPI MCP ツールを呼び出す必要があるときにのみ開きます。利用は UnifAPI ワークスペースのクレジットに課金され、モデルの実行はすでに使用しているエージェント製品の内部で行われます。
オプション B: HTTP API を呼び出す
製品コード、テスト、またはカスタムエージェントランタイムを構築する場合は、直接 HTTP を使用します。
ワークスペースと API キーを作成する
api.unifapi.com/sign-in でサインインし、API キーを作成して、パスワードのように扱います。
export UNIFAPI_KEY="unif_..."公開データ呼び出しを行う
すべてのエンドポイントは HTTP + JSON です。1 つのキー、1 つのベース URL。
curl https://api.unifapi.com/tiktok/videos/7350810998023949599 \
-H "Authorization: Bearer $UNIFAPI_KEY"成功したレスポンスは UnifAPI の公開エンベロープを使用します：
{
"request_id": "req_...",
"data": {
"id": "7350810998023949599",
"title": "im so sick of being tired im so tired of being sick",
"video_description": "im so sick of being tired im so tired of being sick",
"duration": 6,
"author": {
"id": "MS4wLjABAAAA...",
"username": "jennmelon",
"display_name": "Jenn Melon"
},
"like_count": 2002496,
"comment_count": 4350,
"share_url": "https://www.tiktok.com/@jennmelon/video/7350810998023949599"
},
"billing": {
"credits_charged": 1,
"records_charged": 1,
"balance_remaining": 99,
"truncated_due_to_balance": false
}
}リストエンドポイントには data、オプションの pagination、billing が含まれます。エラーは HTTP 4xx/5xx と error オブジェクトで返ります — エラー を参照してください。