Skip to main content
skill CX Codex

filmweb — Claude Code skill: film data and installation

This Claude Code skill retrieves film and TV details from Filmweb. It activates for title or link searches and questions about cast, ratings, release dates, or VOD.

MIT ★ 60 updated 2026-11-15

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add b44x/ai-polish-skills
/plugin install filmweb@polskie-skille
Open on GitHub

What filmweb does

The skill searches Filmweb for films and TV series, then retrieves ratings, critics’ scores, genres, runtime, directors, cast, and plot details. It can also look up release dates, VOD services and prices, plus information about actors. It responds to questions about a Filmweb title or a filmweb.pl link.

A small Python CLI, scripts/filmweb.py, queries Filmweb’s unofficial JSON API and prints JSON. Its commands cover search, title details, full plot, cast, dates, VOD, person records, and extracting an ID from a link. For a series, use the film command; its duration field describes one episode.

Python 3.8+ and network access to www.filmweb.pl are required; no third-party Python packages are needed. The API can change or become blocked. If the script returns a network error, the instructions suggest fetching the public page with a web-fetch tool or curl.

What it helps with

  • search for a film or series by title
  • check a Filmweb rating and vote count
  • find a film’s director or cast
  • look up a release date or VOD price

Example prompts for the agent

  • Find “The Matrix” on Filmweb and give me its rating and vote count.
  • Who appeared in the TV series “Game of Thrones”?
  • Find where this film is available on VOD and its rental price.

How to install filmweb

1Plugin marketplace

/plugin marketplace add b44x/ai-polish-skills
/plugin install filmweb@polskie-skille

This installs the whole filmweb plugin with all its skills

2Skills CLI (Vercel)

npx skills add b44x/ai-polish-skills --skill filmweb -a claude-code

3Manually: put the files in place

~/.claude/skills/filmweb/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/filmweb/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about filmweb

How do I install filmweb in Claude Code?

Run /plugin marketplace add b44x/ai-polish-skills, then /plugin install filmweb@polskie-skille.

What does filmweb do?

It searches Filmweb for films and series and retrieves ratings, plot details, cast, release dates, and VOD offers. It can also fetch actor details.

What does filmweb need to run?

It requires Python 3.8+ and network access to www.filmweb.pl. The skill uses Filmweb’s unofficial JSON API and needs no third-party Python packages.

Source text

SKILL.md · MIT
---
name: filmweb
display_name: Filmweb
version: 1.0.0
description: >-
  Fetch film and TV series data from Filmweb.pl: search by title, rating and number
  of votes, critics rating, genres, duration, directors, cast, plot, premiere dates,
  where to watch (VOD providers and prices) and actor details. Use whenever the user
  asks about a movie or series on Filmweb, pastes a filmweb.pl link, or wants a Polish
  rating, opis, obsada or VOD info, e.g. "ile Matrix ma na Filmwebie", "kto grał w…",
  "kto wyreżyserował…", "o czym jest…", "gdzie obejrzę…", "kiedy premiera…",
  "jaki serial…", "ocena serialu…".
category: entertainment
language: pl
country: PL
license: MIT
author: Michell Hoduń (https://github.com/b44x)
repository: https://github.com/b44x/ai-polish-skills
network: true
authentication: none
source: Filmweb.pl
source_type: unofficial_api
official: false
homepage: https://www.filmweb.pl
documentation: none
rate_limit: fair use
last_verified: 2026-09-28
tags:
  - filmweb
  - filmy
  - seriale
  - kino
  - vod
  - recenzje
  - obsada
compatibility: Python 3.8+ (standard library only); network access to www.filmweb.pl.
---

# Filmweb

Fetches data from the JSON API behind www.filmweb.pl using a small dependency-free
Python CLI, `scripts/filmweb.py`, that always prints JSON.

## Running the script

Run from this skill's directory. Use whichever Python launcher exists:

| OS | Command |
|---|---|
| Linux / macOS | `python3 scripts/filmweb.py <command> …` |
| Windows | `py scripts/filmweb.py <command> …` (or `python`) |

No installation step is needed.

## Workflow

1. **Get the Filmweb ID.**
   - The user gave a link → `filmweb.py id "<url>"` (offline).
     The ID is the trailing number of the slug: `filmweb.pl/film/Matrix-1999-628` → `628`,
     `filmweb.pl/serial/Gra+o+tron-2011-476848` → `476848`.
   - The user gave a title → `filmweb.py search "<title>"`. Results are ordered by relevance.
     Add `--type=serial` when the user clearly means a TV series (or `--type=film` for a movie).
     If several titles plausibly match (remakes, sequels, film vs. series), check them with
     `film` and pick by year, or ask the user.
2. **Fetch only what the question needs.**
   - rating, genres, director, short plot → `film`
   - "who played in…" → `cast` (`film` already has the two main actors)
   - "where can I watch…" → `vod`
   - "when is the premiere…" → `dates`
   - full plot → `description`; details about a person → `person <personId>`
3. **Answer in the user's language** and cite the `url` from `film`. Round the rating to one
   decimal and mention the number of votes (e.g. "7,6/10 z 872 tys. ocen"). Give VOD prices in zł.

## Films and series

Films, TV series and games share one ID space on Filmweb, and **every command accepts
any of them** — use `film <id>` for a series too (e.g. `film 476848` for "Gra o tron").
Check `type` in the output (`film`, `serial`, …). For series, `year` is the first season
and `duration` is the length of one episode, not the whole series.

## Commands

| Command | Returns |
|---|---|
| `search "<query>" [--type=film\|serial\|game] [--limit=10]` | list of `{id, type, title, mainCast}` |
| `film <id\|url>` (film or series) | title, originalTitle, year, type, url, posterUrl, rating, votesCount, votesDistribution, criticsRating, genres, countries, duration, directors, mainCast, plot |
| `description <id\|url>` | full plot description |
| `cast <id\|url> [--limit=10]` | top-rated roles: personId, name, profession, roleRating |
| `dates <id\|url>` | worldPremiere, worldRelease, polandRelease, polandReissue |
| `vod <id\|url>` | where to watch: provider, link, availability, offers (subscription / free / rent / buy + price in PLN) |
| `person <personId>` | name, realName, birthDate, birthplace, height, profession, photoUrl, knownForIds, url |
| `id <url>` | `{"id": …}`, offline |

Field reference: [references/output.md](references/output.md).

## Exit codes

JSON goes to stdout; errors go to stderr as `{"error": "...", "type": "..."}`.

| Code | Meaning | What to do |
|---|---|---|
| `0` | success | use the JSON |
| `2` | not found | tell the user; double-check the ID |
| `64` | bad usage | fix the arguments |
| `69` | Filmweb / network error | retry once; if it persists, use the fallback |

## Fallback

The API is unofficial and may change or be blocked by the network. If the script keeps
failing with code `69`, or the user needs data it does not provide (character names, reviews,
comments, full crew), fetch the public page (`url` from `film`, or `https://www.filmweb.pl/film/<slug>-<id>`)
with a web-fetch tool or `curl` and read the data from it. Tell the user the data came from the web page.

## Rules

- Don't call `film` for every search hit "just in case"; check only the candidates you need.
- Don't invent data the script did not return.

© Michell Hoduń (https://github.com/b44x) · MIT · b44x/ai-polish-skills

Similar skills

SKILL.md skills catalog →
Spotify Automation Claude Office Skills Spotify Automation — a skill that drives Spotify playback, builds playlists and reads audio features, all from your agent chat. CX Codex +1 4,800installs media-info vikiboss media-info is a Claude Code skill that fetches music charts, song lyrics, movie box office figures, and TV and web series rankings. It answers questions about current entertainment listings. CX Codex +1 110installs entertainment vikiboss This skill fetches quotes, jokes, luck predictions, memes, and a leisure calendar from the 60s API. Use it when an agent needs ready-made entertainment content. CX Codex +1 102installs seatback-cinema len5ky seatback-cinema is a Claude Code plugin that picks films from your airline’s current in-flight catalogue. It skips titles you have rated on IMDb or Letterboxd. ★ 13repo stars find-skills vercel-labs find-skills is a Claude Code skill that locates agent skills for a task and helps assess the results. It activates when someone asks for a capability that may already be installable. CX Codex +1 4,400,000installs frontend-design official anthropics The frontend-design skill guides intentional visual design for new interfaces and redesigns. Use it when a generic generated UI is not enough. CX Codex +1 1,025,790installs agent-browser vercel-labs This Claude Code skill automates browser interaction for tasks like navigating sites, filling forms, and testing web apps. It also supports exploratory QA and Electron app automation. CX Codex +1 1,600,000installs design-taste-frontend Leonxlnx The design-taste-frontend Claude Code skill sets design rules and checks for websites. It activates for new pages, redesigns, and requests to fix a generic-looking site. CX Codex +1 802,600installs

From the same set52

The whole set →
przetargi The przetargi Claude Code skill searches Polish public procurement notices in BZP and retrieves notice details. Filter results by subject, contracting authority region, CPV code or publication date. CX Codex +1 ★ 60repo stars solid-jobs This Claude Code skill searches SOLID.Jobs listings and salary statistics. Filter results by keywords, city, experience, remote work, or pay range. CX Codex +1 ★ 60repo stars inpost This Claude Code skill tracks InPost parcels and finds parcel lockers and pickup points in Poland. It runs on requests about delivery status, a locker address, or nearby locations. CX Codex +1 ★ 60repo stars nbp The nbp skill for Claude Code retrieves Narodowy Bank Polski exchange rates and gold prices. It handles currency conversions and invoice tax calculations in PLN. CX Codex +1 ★ 60repo stars dzialki The dzialki Claude Code skill finds Polish cadastral parcels through ULDK. Search by a full EGiB identifier, cadastral district and parcel number, or a point’s coordinates. CX Codex +1 ★ 60repo stars odjazdy The odjazdy Claude Code skill finds stops and upcoming bus or tram departures in Gdańsk, Poznań, and Szczecin. Ask about a stop by name or ID to check its board. CX Codex +1 ★ 60repo stars biala-lista biala-lista is a Claude Code skill that checks Polish companies and VAT status by NIP or REGON. It runs on requests to verify a contractor, bank account, or Polish invoice. CX Codex +1 ★ 60repo stars terminy The terminy skill for Claude Code calculates Polish working days, public holidays and deadlines. It handles questions about payment dates, tax schedules and monthly working-time norms. CX Codex +1 ★ 60repo stars

Project sponsors

Companies that keep this analytics open