Back to Details

unifapi

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

UnifAPI

UnifAPI

Default Path: OAuth MCP

默认路径：OAuth MCP

Use the hosted MCP server first:
text
https://mcp.unifapi.com
Let the MCP client complete browser OAuth when it asks. Do not ask the user to paste OAuth tokens into chat. Do not ask for an API key unless the client cannot complete OAuth and the task genuinely needs live UnifAPI calls.
Read references/mcp.md for OAuth protected-resource metadata, client setup, and the API-key fallback.
优先使用托管的MCP服务器：
text
https://mcp.unifapi.com
当MCP客户端提示时，完成浏览器OAuth认证。请勿要求用户在聊天中粘贴OAuth令牌。除非客户端无法完成OAuth认证且任务确实需要调用实时UnifAPI，否则不要请求API密钥。
请阅读references/mcp.md以获取OAuth受保护资源元数据、客户端设置以及API密钥备选方案相关内容。

References

参考文档

  • references/mcp.md - OAuth protected-resource metadata, client setup, and API-key fallback.
  • references/public-data.md - when UnifAPI is the right data boundary.
  • references/http-api.md - direct HTTP integration guidance.
  • references/twitter-x.md - current X/Twitter route map and response shapes.
  • references/mcp.md - OAuth受保护资源元数据、客户端设置以及API密钥备选方案。
  • references/public-data.md - 何时选择UnifAPI作为合适的数据边界。
  • references/http-api.md - 直接HTTP集成指南。
  • references/twitter-x.md - 当前X/Twitter路由映射和响应结构。

Agent Workflow

Agent工作流

  1. Name the artifact the user wants: ranked table, creator brief, social listening report, market scan, SERP summary, scrape summary, or another decision output.
  2. Use MCP tools such as 
    list_operations
    and 
    get_operation
    to find exact public-data operations and schemas.
  3. Call live APIs through 
    call_api
    only for evidence you need.
  4. Return an artifact, not a raw dump. Include evidence, assumptions, confidence, operations used, and billing metadata when available.
  5. If a live call fails with 
    401 unauthorized
    , restart OAuth or use the documented API-key fallback if OAuth is unavailable.
  1. 明确用户需要的产物：排名表格、创作者简报、社交监听报告、市场扫描、SERP摘要、爬取摘要或其他决策输出。
  2. 使用
    list_operations
    和
    get_operation
    等MCP工具查找精确的public-data操作和模式。
  3. 仅在需要获取证据时，通过
    call_api
    调用实时API。
  4. 返回产物而非原始数据转储。若有可用信息，请包含证据、假设、可信度、使用的操作以及计费元数据。
  5. 如果实时调用返回
    401 unauthorized
    错误，请重新启动OAuth认证；若OAuth不可用，则使用文档中说明的API密钥备选方案。

Public-Data Boundary

公共数据边界

UnifAPI is for public data: social profiles and posts, search results, trends, web scrape outputs, news, comments, communities, videos, and public company or creator signals.
OAuth authorizes the UnifAPI workspace and credit balance. It does not grant access to a user's private Twitter/X, Google, CRM, email, or SaaS accounts. Use a connector platform when the workflow needs private user-authorized SaaS data.
Read references/public-data.md when choosing whether UnifAPI is the right data path.
UnifAPI适用于公共数据：社交资料与帖子、搜索结果、趋势、网页爬取输出、新闻、评论、社区、视频以及公开的企业或创作者信号。
OAuth用于授权UnifAPI工作区和信用余额，并不授予访问用户私人Twitter/X、Google、CRM、电子邮件或SaaS账户的权限。当工作流需要用户授权的私人SaaS数据时，请使用连接器平台。
在选择UnifAPI是否为合适的数据路径时，请阅读references/public-data.md。

Direct HTTP

直接HTTP调用

Prefer MCP for agent workflows. Use direct HTTP only when the user is building an integration, running scripts, or using a client that cannot call MCP tools.
Read references/http-api.md before writing direct HTTP calls.
Agent工作流优先使用MCP。仅当用户正在构建集成、运行脚本或使用无法调用MCP工具的客户端时，才使用直接HTTP调用。
在编写直接HTTP调用之前，请阅读references/http-api.md。