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
/plugin marketplace add b44x/ai-polish-skills
/plugin install filmweb@polskie-skilleWhat 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-skilleThis installs the whole filmweb plugin with all its skills
2Skills CLI (Vercel)
npx skills add b44x/ai-polish-skills --skill filmweb -a claude-code3Manually: put the files in place
~/.claude/skills/filmweb/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/filmweb/
1Skills CLI (Vercel)
npx skills add b44x/ai-polish-skills --skill filmweb -a codex2Manually: put the files in place
.agents/skills/filmweb/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add b44x/ai-polish-skills --skill filmweb -a cursor2Manually: put the files in place
.cursor/skills/filmweb/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install b44x/ai-polish-skills skills/filmweb2Manually: put the files in place
.github/skills/filmweb/SKILL.md1Skills CLI (Vercel)
npx skills add b44x/ai-polish-skills --skill filmweb -a gemini-cli2Platform CLI
gemini skills install https://github.com/b44x/ai-polish-skills --path skills/filmwebManually: put the files in place
.devin/skills/filmweb/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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