ITADN
NangoHQ/nango
README.md
以下内容由 AI 翻译,如有问题请点此提交 issue 反馈

使用 AI 构建产品集成。

通过 900+ 个 API 连接您的产品与 AI 智能体。在专为规模化构建的基础设施上,使用代码中的 AI 构建、运行和维护集成。

网站 · 文档 · 900+ 个 API · Slack 社区

GitHub Stars License NPM Downloads

什么是 Nango?

Nango 是一个用于构建产品集成的开源平台。它支持 900+ APIs,并可与任何后端语言、AI 编码工具和 agent SDK 配合使用。

你可以将集成逻辑编写为 TypeScript 函数,或让 AI 为你生成,然后部署到 Nango 的生产运行时。Nango 负责处理认证、执行、扩展和可观测性。

已被 Replit、Ramp、Mercor 及数百家其他公司在生产环境中使用。

工作原理

Nango 提供三个原语,覆盖所有集成模式:

1. Auth

为 900+ APIs 提供托管的 OAuth、API 密钥和令牌刷新。在你的应用中嵌入白标认证流程。Nango 负责处理凭证、令牌存储和多租户连接管理。

// Embed auth in your frontend
nango.openConnectUI({ onEvent: (event) => { /* handle completion */ } });

2. Proxy

代表您的用户发起经过身份验证的 API 请求。通过 Nango 的代理发送请求:它会解析提供商、注入凭证、处理重试和速率限制,并返回响应。

import { Nango } from '@nangohq/node';

const nango = new Nango({ secretKey: '<NANGO-SECRET-KEY>' });

// Make an authenticated request to any API
const response = await nango.get({
    endpoint: '/v3/contacts',
    providerConfigKey: '<INTEGRATION-ID>',
    connectionId: '<CONNECTION-ID>'
});

3. 函数

将集成逻辑编写为 TypeScript 函数并部署到 Nango。函数在生产运行时上执行,内置 API 访问、重试、存储和可观测性。

使用 AI builder 根据用例描述生成它们。

export default async function run(nango: Nango) {
    const { owner, repo, title, body } = nango.input;
    
    const response = await nango.post({
        endpoint: `/repos/${owner}/${repo}/issues`,
        data: { title, body }
    });
    
    return response.data;
}

你可以构建什么

Nango 支持所有常见的集成模式:

用例描述
AI 工具调用 & MCP赋予 AI 智能体操作外部 API 的能力
数据同步用于 RAG 管道、索引和触发器的一向或双向同步
Webhook 处理可靠地接收和处理来自外部 API 的 Webhook
API 统一将 API 规范化为你自己的通用模式
操作代表用户写入数据并执行操作
按客户配置为每个客户定制集成行为

快速入门

在 5 分钟内开始运行:

1. 创建集成。 注册(免费,无需信用卡),然后在 Integrations 选项卡中配置一个新的集成。

2. 授权 API。 在 Connections 选项卡中,创建一个连接并完成授权流程。稍后,将此嵌入到你的产品中:

nango.openConnectUI({ onEvent: (event) => { /* handle completion */ } });

3. 访问 API。 获取凭据并发起经过身份验证的请求:

import { Nango } from '@nangohq/node';

const nango = new Nango({ secretKey: '<NANGO-SECRET-KEY>' });

const connection = await nango.getConnection('<INTEGRATION-ID>', '<CONNECTION-ID>');
console.log(connection.credentials);

Auth 流程嵌入您的产品,使用 Proxy 发起请求,或使用 Functions 构建自定义集成。

为什么选择 Nango?

AI 生成,人工控制的代码。 Nango 的 AI 构建器从自然语言生成 TypeScript 集成函数。与黑盒解决方案不同,您将获得可读的代码,可以对其进行审查、编辑和版本控制。具备完整的类型安全和内置的测试框架。

生产级基础设施。 Nango 处理数十亿次 API 请求。运行时提供租户隔离、弹性扩展、自动重试和速率限制处理。经过数百家公司的生产环境验证。

开箱即用的 900+ API 认证。 OAuth 流程、令牌刷新、凭证存储和多租户支持均由我们处理。无需从头构建认证即可连接任何 API。

开源且可自托管。 Nango 完全开源。您可以在 Nango Cloud 上运行,或在自己的基础设施上自托管。符合 SOC 2 Type II、HIPAA 和 GDPR 标准。

契合您的工作流。 完全可通过 CLI 和 API 操作。兼容任何后端语言或框架、AI 编码工具(Cursor、Codex、Claude Code)以及代理 SDK(MCP、LangChain)。

开源版与付费版

Nango 基于 Elastic License 提供。Cloud 版和企业自托管版根据您的 计划 提供所有功能的访问权限。您也可以 免费自托管,但功能集有限。

贡献

我们欢迎贡献 — 任何人都可以为新 API 添加支持

感谢所有贡献者 ❤️