SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场api-integration

api-integration

编程与开发

查看项目

更新于 10-30 18:19

技能介绍

该技能用于帮助开发者从「我想集成 X」推进到可以开始写代码的状态，主要覆盖 Meta 旗下各类 API 的接入准备工作。

用途 面向需要接入 Meta 平台的开发者，梳理某一具体产品的官方文档信息，输出结构化的集成指南，而不是直接替代编码。技能中列出的常见集成对象包括：WhatsApp Business API（收发消息、模板、媒体）、Instagram Graph API（发布内容、读取洞察、管理评论）、Messenger Platform（聊天机器人、发送 API、Webhook）、Pages API（发布内容、读取洞察、管理主页）、Marketing API（创建广告系列、管理广告、读取分析）、Login with Facebook / Login with Instagram、Facebook Login for Business。

前置条件 该技能需要 Meta Social Technologies MCP 服务器 devtools（https://mcp.facebook.com/devtools，streamable-http）。通过插件方式安装时会一并捆绑；仅安装技能的方式（例如 npx skills add）不会包含，需要单独完成服务器设置。如果 mcp__devtools__* 工具不可用，技能要求停止操作，不得编造工具输出（包括第一步的跟踪调用），并请用户添加服务器、完成其 OAuth 流程（不索取访问令牌），之后再继续。

使用方式与流程

  1. 在开展其他工作前，先调用 devtools_skill_invocation，action 为 start，skill_name 为 api-integration；后续每个 devtools_* 调用都需带上该 skill_name。
  2. 明确集成目标：若用户未说明想构建什么，则询问。
  3. 研究集成：执行多次检索而非一次，覆盖概览与入门、认证与访问令牌、所需权限与应用审核、核心 API 端点、Webhook 设置、速率限制与配额、代码示例与 SDK。建议先并行执行前 5 项检索，再按需执行后 2 项；使用 max_results 为 10 并通过 offset 分页获取更完整结果，必要时细化查询。若提供 app_id，还可检查应用审核中的要求与权限。
  4. 检查应用就绪度（若用户有应用）：若用户以名称指代或不确认 ID，先通过 devtools_app_list（action 为 list）解析出 app_id；若存在歧义，展示候选（名称、ID、查看者角色）请用户选择。然后用 devtools_app 的 basic_settings 确认应用类型与状态，用 devtools_app_review 的 privileges 查看已获批权限，用 requirements 查看所需条件。
  5. 汇总为集成指南：从检索结果中提取关键信息而非直接堆砌原始结果，按固定格式组织，包括概览（API 作用与可构建的内容、官方文档链接）、前置条件（Meta 开发者账号、所需应用类型如 Business 或 Consumer、产品特定前置条件如 WhatsApp Business Account、Facebook 主页）、认证（所需令牌类型如 User、Page、System User，令牌生成方式，所需权限范围，过期与刷新流程）、所需权限（每项权限的作用、哪些需应用审核、哪些自动批准；若提供 app_id 则对比已授予与仍缺少的权限）、搭建步骤（从零到首次 API 调用的分步流程，含 Webhook 设置）、关键 API 端点（方法、URL 模式、关键参数、示例响应，聚焦用户需求）、代码示例（用用户偏好的语言，含认证、基本调用与错误处理；有官方 SDK 则用 SDK，否则用原始 HTTP 如 curl/fetch；Webhook 型集成附处理代码）、速率限制与配额（产品特定限制与吞吐层级，如 WhatsApp 消息层级 1K/10K/100K/无限；若适用则给出按端点的限制；建议使用 /api-health 持续监控）、常见陷阱（文档指出的产品特定易错点、权限错误、令牌类型混淆、Webhook 验证问题）。
  6. 提供后续建议：若权限需要应用审核，建议 /app-review-prep；若集成使用 Webhook，建议 /webhook-setup；上线后用 /api-health 监控使用情况。
  7. 结束：完成上述步骤后调用 devtools_skill_invocation，action 为 end，skill_name 为 api-integration。

使用提示（来自资料） 始终用不同查询多次检索，单次检索很少能覆盖认证、权限、端点与示例。代码示例优先使用用户声明的语言/框架，未指定时默认 Node.js/JavaScript。若用户有 app_id，将其当前权限与集成所需权限对照，可节省时间。部分集成（WhatsApp、Instagram）需要 Business 类型应用，若用户应用类型不符应尽早指出。Webhook 型集成（Messenger、WhatsApp）没有回调 URL 无法工作，应主动建议 /webhook-setup。

限制 该技能本质是文档检索与指南整理工具，不具备代写生产代码或代替官方文档的能力；其运行强依赖 devtools MCP 服务器及 OAuth 完成。资料未提供该技能的具体收费、价格、可用平台版本、效果数据等，暂未提供。