用途:本技能是 Figma Context MCP(又称 Framelink)的使用指南,目标是让调用者以高效模式访问 Figma API,防止出现 429 限流锁定。
主要能力:覆盖两个工具——get_figma_data 用于获取文件或节点结构、布局与组件信息(属受限最严的 Tier 1);download_figma_images 用于导出指定节点的 PNG/SVG(Tier 2-3)。
使用方式(元数据优先流程):1. 从 Figma URL 提取 nodeId,只取目标节点而非整个文件;2. 设置最小 depth,depth=1 取顶层框架,depth=2 取框架及直接子级,depth=3 为推荐上限,省略 depth 会返回整个子树;3. 先在本地分析响应,识别真正需要细节的子节点,并直接提取颜色、间距、字体等设计令牌;4. 仅在必要时按子节点再取数据;5. 最后才下载图片,按 imageRef 去重、每次 5-10 个节点分批,pngScale 默认 1。
限流事实:Figma 按文件所有者套餐限流,包括 Starter、Pro、Org;Tier 1 为 10/15/20 每分钟,Tier 2 为 25/50/100,Tier 3 为 50/100/150;View/Collab 席位每月仅 6 次 Tier 1 调用。429 锁定可能持续 4-5 天。
限制与反模式:不应忽略 depth 或 nodeId、不应一次性批量下载全部图片、不应在 429 后立即重试(会延长锁定)。命中 429 时应停止所有 Figma API 调用,确认文件所有者套餐,必要时建议将文件复制到自己的空间,并按 Retry-After 等待后再以最小调用恢复。其余细节如完整恢复步骤,资料中指向 rate-limit-recovery.md,未在本页展开。