Clypmint B-Roll

Clypmint B-Roll

为 Agent 提供 B-roll。 一次调用即可返回与你的脚本内容完全对应的真实照片和视频素材：人物、公司、应用、地点、瞬间。每个镜头都经过视觉模型检查，评分为 0–10，并标注其许可证。

claude mcp add --transport http clypmint-broll https://clypmint.com/mcp/broll \
  --header "Authorization: Bearer $CLYPMINT_API_KEY"

然后向你的 Agent 提问：“为这份脚本中的每个名称查找 B-roll。”

获取密钥（每月可免费搜索 100 次） · 在浏览器中试用 · 文档

为什么选择它

AI 视频 Agent 擅长编写脚本和生成语音，却不擅长找图。它们会使用库存素材（“一个男人在用笔记本电脑”），或抓取图片搜索结果，结果却得到带水印的图片、同人作品和错误的人物。

Clypmint B-Roll 为 Agent 提供剪辑师会选用的镜头：

在 Clypmint 客户剪辑中提到的 69 个真实对象中，它有 62% 的搜索结果能找到评分为 7+/10 的镜头，而我们之前使用的网页图片搜索流程只有 23%。一次搜索约需 5 秒。

工作原理

1. 规划。 发送对象，并尽可能提供与镜头对应的台词。台词可以确定你指的是哪个“Claude”或“Apple”。
2. 查找。 我们会查询名称的含义（Wikidata），然后搜索允许重复使用的来源：Wikimedia Commons、NASA、Internet Archive 公共领域影片、对象的官方网站及其官方 YouTube 频道。
3. 检查。 通过一次视觉模型调用，按照镜头必须呈现的内容对每个候选素材评分。人物错误、有水印、拼贴图、书籍封面：一律剔除。
4. 插入。 每张图片都有一个可用的 download_url，提供适用尺寸（最大 1920 px）。每段视频都有一条命令，可在你的电脑上剪取所需片段，或录制实时网站。

使用方法

MCP（Claude Code、Cursor、Codex，以及任何 MCP 客户端）

服务地址：https://clypmint.com/mcp/broll · 工具：find_broll、plan_broll、broll_usage · 已在官方 MCP 注册表中列出，名称为 com.clypmint/broll

{
  "mcpServers": {
    "clypmint-broll": {
      "url": "https://clypmint.com/mcp/broll",
      "headers": { "Authorization": "Bearer cm_live_YOUR_KEY" }
    }
  }
}

[mcp_servers.clypmint-broll]
url = "https://clypmint.com/mcp/broll"
bearer_token_env_var = "CLYPMINT_API_KEY"

REST

curl https://clypmint.com/api/v1/broll/search \
  -H "Authorization: Bearer $CLYPMINT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "Sam Altman", "context": "Sam Altman just walked on stage", "type": "image", "limit": 1}'

{
  "request_id": "2b9d7f0e-6c1a-4f53-9d0e-6a1f3c8e2b41",
  "query": "Sam Altman",
  "interpreted": {
    "subject": "Sam Altman",
    "kind": "person",
    "entity": {
      "id": "Q7407093",
      "label": "Sam Altman",
      "description": "American entrepreneur and investor (born 1985)",
      "url": "https://www.wikidata.org/wiki/Q7407093"
    },
    "look_for": "Sam Altman walking onto a stage at a conference or event"
  },
  "verified": true,
  "results": [
    {
      "id": "commons:File:Sam Altman speaking at TED.jpg",
      "type": "image",
      "title": "Sam Altman speaking at TED",
      "shows": "Full shot of Sam Altman seated on stage at TED",
      "score": 9,
      "url": "https://upload.wikimedia.org/wikipedia/commons/0/06/Sam_Altman_speaking_at_TED.jpg",
      "thumbnail_url": "https://thumb.wikimedia.org/wikipedia/commons/thumb/0/06/Sam_Altman_speaking_at_TED.jpg/500px-Sam_Altman_speaking_at_TED.jpg",
      "width": 2184,
      "height": 2633,
      "orientation": "portrait",
      "duration_seconds": null,
      "source": {
        "name": "Wikimedia Commons",
        "page_url": "https://commons.wikimedia.org/wiki/File:Sam_Altman_speaking_at_TED.jpg"
      },
      "license": {
        "name": "CC BY 2.0",
        "url": "https://creativecommons.org/licenses/by/2.0",
        "commercial_use": true,
        "attribution": "Steve Jurvetson / CC BY 2.0 / https://commons.wikimedia.org/wiki/File:Sam_Altman_speaking_at_TED.jpg"
      },
      "official": false,
      "delivery": "direct"
    }
  ],
  "considered": 14,
  "sources_used": [
    "Wikimedia Commons"
  ],
  "took_ms": 7578,
  "cached": false,
  "usage": {
    "billed_searches": 0,
    "free_searches_left_this_month": 99,
    "price_per_search_usd": 0.02
  }
}

一次处理完整脚本（每个片段都会返回其开头对应的确切文字；如果你提供了单词时间戳，也会返回对应时间）：

curl https://clypmint.com/api/v1/broll/plan \
  -H "Authorization: Bearer $CLYPMINT_API_KEY" -H "Content-Type: application/json" \
  -d '{"transcript": "Last week I flew to Tokyo to meet the Figma team...", "max_beats": 8}'

JavaScript

import { createClient } from '@clypmint/broll';

const broll = createClient(); // reads CLYPMINT_API_KEY
const { results } = await broll.search({ query: 'Figma', context: 'we design everything in Figma' });

Python

pip install "git+https://github.com/nuttallp/clypmint-broll#subdirectory=python"

from clypmint_broll import Broll

broll = Broll()  # reads CLYPMINT_API_KEY
shots = broll.search("Eiffel Tower", type="video")["results"]

OpenAPI

https://clypmint.com/api/v1/broll/openapi.json：将其导入 Postman 或 Insomnia，或据此生成任意语言的客户端。

CLI

export CLYPMINT_API_KEY=cm_live_...
npx -y github:nuttallp/clypmint-broll search "Eiffel Tower" --type video
npx -y github:nuttallp/clypmint-broll get "Notion" --type video --out notion.mp4   # records the live site
npx -y github:nuttallp/clypmint-broll cut "https://www.youtube.com/watch?v=..." --start 12 --duration 4 --aspect 9:16
npx -y github:nuttallp/clypmint-broll capture https://stripe.com --duration 5

cut 需要 ffmpeg（处理 YouTube、X 或 TikTok 页面时还需要 yt-dlp）。capture 使用你已有的 Chrome、Edge、Brave 或 Chromium。所有命令都支持供 Agent 使用的 --json。

Agent 技能

skills/broll/SKILL.md 会教 Agent 如何有效获取 B-roll：搜索什么、跳过什么、如何将镜头与台词对应，以及如何标注素材来源。将它放入你的技能文件夹（Claude Code：~/.claude/skills/broll/SKILL.md）。

素材来源

仅使用条款允许再利用的来源，并且每个镜头都会注明来源：

• Wikidata（CC0）提供名称对应的人物或事物、官方照片、徽标、网站和 YouTube 频道等信息。
• Wikimedia Commons：采用自由许可的照片和视频。每个文件都附带许可和作者信息。
• NASA 图片和视频库（通常不受版权保护）。
• Internet Archive：仅使用公有领域和 CC0 影片。
• 主体自己的官方网站和官方 YouTube 频道：以链接和命令的形式返回。在你的设备上剪辑片段或录制网站。我们绝不托管这些内容。

license.commercial_use 的值为 true（根据其条款可免费用于商业用途）、false（仅限非商业用途；排序靠后）或 null（权利归所有者持有；适用于官方频道和网站）。如有提供 attribution 行，请务必使用。你需对发布内容的使用方式负责。

定价

• 每月免费搜索 100 次。 无需银行卡。
• 之后，每找到一个镜头的搜索收费 $0.02。 未找到任何内容的搜索绝不收费。
• 按量付费，每月结算。默认月度限额为 $50，可在控制面板中调整。

常见问题

这是素材库吗？ 不是。素材库提供的是某个 CEO，而这里提供的是脚本中点名的那个 CEO。对于通用场景，它会查找真实且采用自由许可的照片和素材。

为什么不直接抓取图片搜索结果？ 搜索引擎的 API 条款禁止转售搜索结果，抓取的图片没有许可，也没人会检查图片中是否是正确的人物。

“已验证”是什么意思？ 视觉模型会在一张带编号的汇总图上查看每个候选素材，并根据镜头必须呈现的内容进行评分。verified: false 表示无法执行检查，结果仅按来源排序。

适用于竖屏视频吗？ 传入 "orientation": "portrait" 可优先排列竖屏镜头，使用 cut --aspect 9:16 可适配任意片段（默认完整容纳；使用 --fit cover 可裁剪）。

许可证

本仓库中的客户端、CLI 和技能均采用 MIT 许可证。API 是由 Clypmint 托管的服务。