blink-connectors

用途

blink-connectors 是一个 OAuth 连接器系统，用于连接并调用 38 个以上第三方服务的 API，涵盖 Google 系产品、Notion、Slack、Discord、GitHub、Stripe、Jira、HubSpot、Salesforce、LinkedIn 等。它让用户在完成一次浏览器授权后，即可通过 CLI、MCP 工具或 SDK 对这些服务发起 API 调用。

主要能力

连接器管理：列出可用提供商、查看指定提供商的连接状态。
API 调用执行：通过已连接的提供商执行 API 调用（GET/POST 等）。
MCP 工具：提供 blink_connector_exec（通过已连接提供商执行 API 调用）、blink_connector_linked（列出某项目当前已连接的全部 OAuth 提供商）、blink_connector_status（检查指定提供商的连接状态）。
SDK 支持：可检查状态、发起 GET 请求与 POST 请求。
令牌刷新由 Blink 后端自动处理。

使用方式

前置条件：初始 OAuth 连接必须在浏览器中完成，地址为 blink.new/settings?tab=connectors。用户对每个提供商授权一次后，CLI/MCP/SDK 即可发起 API 调用。

CLI 示例：

# 列出可用提供商
blink connector providers

# 检查连接状态
blink connector status slack

# 执行 API 调用
blink connector exec slack /conversations GET

CLI 语法为：blink connector exec <provider> <endpoint> [method] [params]。

SDK 示例：

// 检查状态
const status = await blink.connectors.status('slack')

// GET 请求
const channels = await blink.connectors.execute('slack', {
  method: '/conversations',
  http_method: 'GET',
  params: { types: 'public_channel,private_channel' }
})

// POST 请求
await blink.connectors.execute('slack', {
  method: '/chat/postMessage',
  http_method: 'POST',
  params: { channel: 'C1234', text: 'Hello from Blink!' }
})

可用提供商（部分）：Slack（slack）、Discord（discord）、Notion（notion）、Google Drive（google_drive）、Google Calendar（google_calendar）、Google Sheets（google_sheets）、Google Docs（google_docs）、Google Slides（google_slides）、LinkedIn（linkedin）、HubSpot（hubspot）、Salesforce（salesforce）、GitHub（github）、Stripe（stripe）、Jira（jira）、Microsoft（microsoft）、Airtable（airtable），另有 20 个以上，可通过 blink connector providers 查看完整列表。

路径规则：路径以 / 开头；动态 ID 放在路径中；提供商 ID 使用下划线；GET 参数会变为查询参数，POST 参数会变为 JSON 请求体。CLI 参数中若 JSON 无效会直接失败（退出码 1）。

Google Ads（composio_googleads）注意事项：每个路径必须以 API 版本开头，customer id 放在路径中而非请求体；不存在顶层 /search 资源。配额方面，rateScope 为 DEVELOPER 的 429 是 Composio 共享开发者令牌的限制（跨租户共享），需遵循 retryDelay 并反馈给用户；rateScope 为 ACCOUNT 则表示用户自身账户限流。写入 campaign 时，Composio 代理对 false、0、{}、[] 的丢弃问题已在上游修复，可正常发送 falsy 值；建议先用 partialFailure:true + validateOnly:true 做 dry-run，再改为 false 正式执行。v23 创建 campaign 需包含 containsEuPoliticalAdvertising 字符串枚举。调试时优先使用 connector exec（代理）而非 connector tool-execute（原生工具目录），后者会将 Google 错误折叠为不透明的错误信息。

错误码：CONNECTOR_NOT_CONNECTED（用户未授权该提供商）、CONNECTOR_DISABLED（该项目已禁用该提供商）、MISSING_SCOPE（需以额外权限重新连接）、*_API_ERROR（上游 API 错误，如 SLACK_API_ERROR）。

适用场景

需要在自动化流程、脚本或智能体/工具调用中，通过统一接口访问多个已授权第三方服务 API 的场景。

限制

初始授权必须在浏览器中完成；部分提供商的路径与配额规则有特殊要求（见 Google Ads 部分）；CLI 参数 JSON 无效会直接失败。定价、平台支持范围等其余细节暂未提供。

技能介绍

用途

主要能力

使用方式

适用场景

限制