FrameThrower

The track record of a brand, director, agency, production company, DP, editor or composer in FrameThrower's ads library: how many spots, which years, who they work with (clients, agencies, directors, production companies), awards by show, typical tones and genres, their best and most recent work — and, for directors / agencies / production companies with a public page, the researched profile (description, founded, HQ, website).

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "commercials_profile",
    "arguments": {
      "kind": "brand",
      "name": "..."
    }
  }
}

Count and rank the ads library: how many commercials match a filter, broken down by any of brand, director, agency, production, dp, editor, music, industry, market, year, genre, structure, format, tone, trope, award_show, season. E.g. "which agencies won the most Cannes Lions for car ads since 2015" = fields [agency], award_show Cannes Lions, industry Auto, year_min 2015.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "commercials_stats",
    "arguments": {
      "fields": []
    }
  }
}

Find animated SERIES and FILMS (animation library only — mostly anime, plus Western animation) that fit what the user is making — by a story brief in plain words ("a quiet coming-of-age story about two sisters in a seaside town, bittersweet, summer"), by a title it should be like (like: "Akira"), by a LOOK (an image or frame ids — titles whose frames look like it), and/or by genre, theme, style, studio, movie/series and year. Signals combine. Returns each title with studio, director, genres, themes, its look, a synopsis, a poster, and for a look search the frames that matched.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "find_animation_titles",
    "arguments": {}
  }
}

Find frames by specific cinematography craft attributes — lens character, shot size, visual style, setting, time of day, director, or year range. All optional; combine to narrow. Use this to refine a search precisely.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "find_by_craft",
    "arguments": {}
  }
}

Find frames visually/semantically similar to a given frame id (from a prior result). Use this to pull more references like one the user shortlisted.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "find_similar",
    "arguments": {
      "frameId": "..."
    }
  }
}

A frame in its sequence: the shots just before and after it in the same episode / film, in order, each with its still and caption — to see how a moment is built, or to lay a beat out across several canvas panels. With clips: true, each shot's clip plus the continuous "run" video that covers them (run_url, with from/to seconds).

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_animation_sequence",
    "arguments": {
      "frame_id": "..."
    }
  }
}

One anime series or film in depth, by slug or name: synopsis, studio and key credits, main characters, genres, themes, its look, the trailer, how many shots are indexed, titles with a similar look and a similar story, and sample frames spread across it (frames: 0–24, default 6).

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_animation_title",
    "arguments": {
      "title": "..."
    }
  }
}

The full breakdown of one commercial by id: idea, logline, tagline, product, audience, every credit by role (director, agency, production company, DP, editor, music, post, sound, VFX), every award (show, year, level, category), craft numbers (shots, average shot length, cuts per minute, when the product / brand / emotional peak / end card land), the script with timings, and the shot list (caption, tags and still per shot; with clips: true, each shot's clip too).

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_commercial",
    "arguments": {
      "id": "..."
    }
  }
}

Get the full metadata + preview thumbnail + full-resolution image URL + depth map URL + link for a single frame id. The depth map is precomputed and free — use it when the user is generating images and needs the composition or camera geometry of this frame.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_frame_details",
    "arguments": {
      "frameId": "..."
    }
  }
}

Find frames in FrameThrower's ANIMATION library — animated series and films only, never live-action (mostly anime, plus Western animation; the whole of every title, not a sample) for a scene, a moment or a CHARACTER LOOK, described in plain words: "a girl on a rooftop at dusk watching the city lights", "two kids running through a summer field", "a tall man with a scarred face and a long black coat, rain". Narrow by title, genre, theme, style (80s cel, watercolour, neon night…), studio, movie/series and year. Each frame has a caption of what is in it, a 640px still for looking at, the full-size still, the frame id and a link. At most 3 frames per title unless per_title says otherwise.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "search_animation_frames",
    "arguments": {
      "query": "..."
    }
  }
}

Find individual SHOTS inside commercials by what is in the frame ("hand pouring beer in slow motion", "car drifting at night in the rain", "family laughing at a kitchen table"), with shot tags (size, angle, setting, time of day, lighting, mood, people, product / logo visible) and any commercial-level filter (brand, director, agency, award show, year…). Each shot has its still, its tags and a link to the exact moment; with clips: true, also a short clip of just that shot.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "search_commercial_shots",
    "arguments": {
      "query": "..."
    }
  }
}

Find whole COMMERCIALS (TV / online spots) in FrameThrower's ads library by idea, story or brief ("two rival neighbours outdo each other at Christmas", "a product demo told as a heist") and/or by facts: brand, director, agency, production company, DP, editor, award show and level, year, industry, market, tone, genre, structure, season. Without a query it lists matching spots, award winners first. Returns each spot with brand, title, year, credits, best award, logline, a still and a link to watch it.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "search_commercials",
    "arguments": {}
  }
}

Search the FrameThrower cinematography reference library by concept, mood, color, composition, or scene. Returns reference frames with film/credits metadata, a preview thumbnail, the full-resolution image URL (use this one for slide decks and documents), a precomputed DEPTH MAP url (greyscale, same dimensions as the frame — pass it straight to a depth ControlNet or any image-to-image pipeline that wants geometry), and a link to view on FrameThrower.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "search_frames",
    "arguments": {
      "query": "..."
    }
  }
}

More ANIMATION frames (animation library only) like ones the user already has — frame ids from earlier results ("more like #2"), or ANY IMAGE: a generated frame on their canvas, an upload, a sketch (pass an http(s) URL or a data: URL, e.g. data:image/png;base64,… for a local file). by = look (composition, drawing and rendering — the default), colour (the palette) or content (what is in it). Same filters as search_animation_frames; other_titles: true keeps it to titles other than the seed frames'.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "similar_animation_frames",
    "arguments": {}
  }
}

More shots that look like the given shot ids (from earlier results or a shot list) — the refine loop: "more like #2". Takes the same shot tags and commercial filters to steer.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "similar_commercial_shots",
    "arguments": {
      "shot_ids": []
    }
  }
}

Commercials like a given one — by STORY (similar idea, tropes and tone) or by LOOK (similar shots: light, framing, palette). Accepts the same filters as search_commercials to narrow (e.g. only award winners, only another brand).

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "similar_commercials",
    "arguments": {
      "id": "..."
    }
  }
}