Clypmint B-Roll

Clypmint B-Roll

エージェント向けのBロール。 1回の呼び出しで、スクリプトに書かれた内容そのもの（人物、企業、アプリ、場所、瞬間）の写真や映像を取得できます。すべてのショットはビジョンモデルで確認され、0～10点で採点され、ライセンスが記載されています。

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

あとはエージェントにこう頼むだけです：「このスクリプトに出てくる名前すべてのBロールを探して。」

キーを取得（月100回まで無料検索） · ブラウザーで試す · ドキュメント

その理由

AI 動画エージェントは、スクリプトや音声の作成は得意です。映像素材を探すのは苦手です。ストック映像（「ノートパソコンを使う男性」）に頼ったり、画像検索からスクレイピングしたりするため、透かしやファンアート、別人の画像を拾ってしまいます。

Clypmint B-Roll は、編集者が選ぶようなショットをエージェントに提供します。

Clypmint の顧客による編集で実際に名前が挙がった69の対象では、7点以上のショットが見つかった割合は**62％でした。以前使用していたウェブ画像検索のパイプラインでは23％**でした。検索にかかる時間は約5秒です。

仕組み

1. 計画します。 対象を送り、できればその映像が流れるセリフも添えてください。そのセリフによって、どの「Claude」や「Apple」を指しているかが決まります。
2. 検索します。 名前の意味を調べ（Wikidata）、再利用可能なコンテンツを公開しているソースを検索します。Wikimedia Commons、NASA、Internet Archive のパブリックドメイン映像、対象自身のウェブサイト、公式 YouTube チャンネルが対象です。
3. 確認します。 1回のビジョン呼び出しで、各候補がショットに必要な内容と一致するかを採点します。別人、透かし、コラージュ、書籍の表紙は除外します。
4. 配置します。 各画像には、利用可能なサイズ（最大1920 px）の download_url があります。各動画には、必要な秒数だけを切り出すコマンド、またはお使いのマシンで稼働中のサイトを録画するコマンドが1つずつ用意されています。

使い方

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 を使用します。エージェント向けに、すべてのコマンドで --json を指定できます。

エージェントスキル

skills/broll/SKILL.md では、Bロールの適切なソースの探し方をエージェントに教えます。何を検索するか、何を除外するか、語句に合わせてショットを配置する方法、クレジットを記載する方法を説明しています。スキルフォルダーに配置してください（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回まで無料で検索できます。 カード情報は不要です。
• それ以降は、ショットが見つかった検索1回につき $0.02 です。何も見つからなかった検索に料金は発生しません。
• 従量課金制で、月ごとに請求されます。デフォルトの上限額は月額$50で、ダッシュボードで変更できます。

FAQ

ストック素材ライブラリですか？ いいえ。ストック素材が表示するのは「ある」CEOです。このサービスが表示するのは、スクリプトで名前が指定された「あの」CEOです。一般的なシーンについては、実際の自由にライセンスされた写真や映像を探します。

画像検索をスクレイピングするだけではだめなのですか？ 検索エンジンのAPI利用規約では検索結果の再販が禁止されており、スクレイピングした画像にはライセンスがなく、写真に正しい人物が写っているかを確認する人もいません。

「検証済み」とはどういう意味ですか？ ビジョンモデルが、番号付きシートに並んだ候補をすべて確認し、ショットに必要な内容との一致度を評価しています。verified: false は確認を実行できなかったことを示し、その場合、結果はソースのみを基準に順位付けされます。

縦型動画にも対応していますか？ 縦型ショットを優先するには "orientation": "portrait" を指定し、任意のクリップのサイズを合わせるには cut --aspect 9:16 を実行してください（デフォルトでは全体が収まるように配置されます。切り抜くには --fit cover を指定します）。

ライセンス

このリポジトリのクライアント、CLI、スキルはMITライセンスです。APIはClypmintがホストするサービスです。