Cerul

The video search layer for AI agents.

Teach your AI agents to see. Search video by meaning — across speech, visuals, and on-screen text.

Docs · API Reference · Pricing ·

Web pages are easy for AI agents to search. Video is not.

Most video search today is limited to transcripts — what was said. Cerul goes further by indexing what is shown: slides, charts, product demos, code walkthroughs, whiteboards, and other visual evidence.

Install the official Cerul plugin in Claude Code:

/plugin marketplace add cerul-ai/cerul-plugin-cc
/plugin install cerul@cerul-plugin

Source: cerul-ai/cerul-plugin-cc.

Copy this and send it to your agent (Claude Code, Codex, Cursor, etc.):

Install the Cerul video search skill: mkdir -p ~/.claude/skills/cerul && curl -fsSL https://raw.githubusercontent.com/cerul-ai/cerul/main/skills/cerul/SKILL.md -o ~/.claude/skills/cerul/SKILL.md && cat ~/.claude/skills/cerul/SKILL.md

Your agent will install the CLI, set up credentials, and start searching videos as a tool.

Or install via the skills CLI:

npx skills add cerul-ai/cerul

# Claude Code
mkdir -p ~/.claude/skills/cerul && curl -fsSL https://raw.githubusercontent.com/cerul-ai/cerul/main/skills/cerul/SKILL.md -o ~/.claude/skills/cerul/SKILL.md

# Windsurf
mkdir -p ~/.codeium/windsurf/skills/cerul && curl -fsSL https://raw.githubusercontent.com/cerul-ai/cerul/main/skills/cerul/SKILL.md -o ~/.codeium/windsurf/skills/cerul/SKILL.md

# OpenCode
mkdir -p ~/.config/opencode/skills/cerul && curl -fsSL https://raw.githubusercontent.com/cerul-ai/cerul/main/skills/cerul/SKILL.md -o ~/.config/opencode/skills/cerul/SKILL.md

# Cline / Cursor
mkdir -p .claude/skills/cerul && curl -fsSL https://raw.githubusercontent.com/cerul-ai/cerul/main/skills/cerul/SKILL.md -o .claude/skills/cerul/SKILL.md

curl -fsSL https://cli.cerul.ai/install.sh | bash
cerul search "Sam Altman on AI video generation tools"

Inline video frame previews are supported in iTerm2, WezTerm, and Kitty. Enable with cerul config and toggle Images on. Other terminals show text-only results.

Connect any MCP-compatible client to the hosted endpoint (replace with your API key):

# Claude Code
claude mcp add --transport streamable-http "https://api.cerul.ai/mcp?apiKey=YOUR_API_KEY" cerul

# Codex
codex mcp add --url "https://api.cerul.ai/mcp?apiKey=YOUR_API_KEY" cerul

Also works with Claude Desktop, Cursor, Windsurf, and other MCP clients.

pip install cerul

from cerul import Cerul

client = Cerul(api_key="YOUR_API_KEY")
results = client.search(query="Sam Altman on AGI timeline", max_results=5)

for r in results:
    print(r.title, r.url)

npm install cerul

import { cerul } from "cerul";

const client = cerul({ apiKey: "YOUR_API_KEY" });
const result = await client.search({ query: "Sam Altman on AGI timeline", max_results: 5 });

for (const r of result.results) {
  console.log(r.title, r.url);
}

curl "https://api.cerul.ai/v1/search" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "Sam Altman on AGI timeline", "max_results": 5}'

Licensed under Apache 2.0.

Join our WeChat group to chat with the team and other users. Scan the QR code below (refreshes weekly):

Or join us on Discord for English discussion.