快速开始

将 UnifAPI 连接到你的智能体，在产品化时再通过 HTTP 发起同样的公开数据调用。

按多数用户最需要的顺序使用 UnifAPI：将你的 AI 客户端连接到公开数据 MCP 服务器，运行一个智能体或 Skill，在实时公开数据工具需要消耗工作区 credits 时登录，然后在你想把工作流产品化时使用 HTTP。

方式 A：连接你的智能体

添加公开数据 MCP 服务器——只读、OAuth、无需 API key——并通过 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.

Web 连接器（Claude、ChatGPT、Perplexity、Grok）：添加一个指向 https://mcp.unifapi.com 的自定义连接器并通过 OAuth 授权。ChatGPT 需要开发者模式（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，并用 npx skills add unifapi-agent/agents 添加 Skills。

兼容 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。一个 key，一个基础 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 key

发起公开数据调用

后续步骤

Skills

连接你的智能体

API 参考

本页内容