빠른 시작

UnifAPI를 에이전트에 연결한 다음, 제품화할 때 동일한 공개 데이터 호출을 HTTP로 수행하세요.

대부분의 사용자가 필요로 하는 순서대로 UnifAPI를 사용하세요: AI 클라이언트를 공개 데이터 MCP 서버에 연결하고, 에이전트나 skill을 실행하고, 실시간 공개 데이터 도구에 워크스페이스 credits가 필요할 때 로그인한 다음, 워크플로를 제품화하고 싶을 때 HTTP를 사용하세요.

옵션 A: 에이전트 연결하기

공개 데이터 MCP 서버(읽기 전용, OAuth, API 키 불필요)를 추가하고 npx skills add로 에이전트 skills를 추가하세요. 오픈소스 에이전트와 skills는 github.com/unifapi-agent/agents에 있습니다.

에이전트 연결하기

여러분의 클라이언트에 맞는 경로를 사용하세요. 각 방법은 실시간 데이터를 위해 호스팅된 MCP 서버를 연결합니다. npx skills add unifapi-agent/agents로 에이전트 skills를 추가하세요.

프롬프트 하나 붙여넣기 (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.

웹 커넥터 (Claude, ChatGPT, Perplexity, Grok): https://mcp.unifapi.com을 가리키는 커스텀 커넥터를 추가하고 OAuth로 인가하세요. ChatGPT는 Developer Mode가 필요합니다 (Plus/Pro/Team/ Enterprise): Settings -> Connectors -> Advanced -> Developer Mode 활성화 -> Create.

Codex는 MCP와 skills를 별도로 연결합니다. ~/.codex/config.toml에 MCP 서버를 추가하세요:

[mcp_servers.unifapi]
url = "https://mcp.unifapi.com"

그런 다음 codex mcp login unifapi를 실행하고, skills를 위해 npx skills add unifapi-agent/agents도 실행하세요.

Claude 호환 플러그인 호스트 (Claude Code, Claude Desktop, OpenClaw)는 skills + 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.

export UNIFAPI_KEY="unif_..."

공개 데이터 호출하기

모든 엔드포인트는 HTTP + JSON입니다. 키 하나, 베이스 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 객체로 반환됩니다 — 오류를 참고하세요.

빠른 시작

옵션 A: 에이전트 연결하기

에이전트 연결하기

작업 결과 요청하기

에이전트가 요청할 때 인증하기

옵션 B: HTTP API 호출하기

워크스페이스와 API 키 생성하기

공개 데이터 호출하기

다음 단계

Skills

에이전트 연결하기

API 레퍼런스

이 페이지에서