filmweb — скилл для Claude Code: данные о кино и установка
Скилл для Claude Code получает сведения о фильмах и сериалах с Filmweb. Агент включает его для поиска по названию или ссылке, вопросов об актёрах, оценках, премьерах и VOD.
MIT ★ 60 обновлён 2026-11-15
/plugin marketplace add b44x/ai-polish-skills
/plugin install filmweb@polskie-skilleЧто делает filmweb
Скилл ищет фильмы и сериалы на Filmweb и получает данные о рейтинге, оценках критиков, жанрах, длительности, режиссёрах, актёрском составе и сюжете. Он также находит даты премьер, варианты просмотра на VOD с ценами и сведения об актёрах. Срабатывает на вопросы о произведении с Filmweb или ссылку на filmweb.pl.
Внутри — Python CLI scripts/filmweb.py, который обращается к неофициальному JSON API Filmweb и выводит JSON. Команды охватывают поиск, данные о фильме, полный сюжет, актёрский состав, даты, VOD, карточку человека и извлечение ID из ссылки. Для сериалов используется команда film; продолжительность в ответе означает длину одной серии.
Нужны Python 3.8+ и доступ к сети для www.filmweb.pl; внешние Python-библиотеки не требуются. API может измениться или блокировать запросы. Если скрипт возвращает сетевую ошибку, инструкция предлагает попробовать публичную страницу через web-fetch или curl.
Какие задачи решает
- найти фильм или сериал по названию
- узнать рейтинг и число оценок на Filmweb
- выяснить, кто снялся или поставил фильм
- найти дату премьеры или цену просмотра на VOD
Примеры запросов агенту
- Найди на Filmweb фильм «Матрица» и сообщи рейтинг с числом оценок.
- Кто снимался в сериале «Игра престолов»?
- Где посмотреть этот фильм и сколько стоит аренда на VOD?
Как установить filmweb
1Через маркетплейс плагинов
/plugin marketplace add b44x/ai-polish-skills/plugin install filmweb@polskie-skilleКоманда ставит плагин filmweb целиком, со всеми его скиллами
2Через Skills CLI (Vercel)
npx skills add b44x/ai-polish-skills --skill filmweb -a claude-code3Вручную: положить файлы
~/.claude/skills/filmweb/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/filmweb/
1Через Skills CLI (Vercel)
npx skills add b44x/ai-polish-skills --skill filmweb -a codex2Вручную: положить файлы
.agents/skills/filmweb/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add b44x/ai-polish-skills --skill filmweb -a cursor2Вручную: положить файлы
.cursor/skills/filmweb/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install b44x/ai-polish-skills skills/filmweb2Вручную: положить файлы
.github/skills/filmweb/SKILL.md1Через Skills CLI (Vercel)
npx skills add b44x/ai-polish-skills --skill filmweb -a gemini-cli2Командой платформы
gemini skills install https://github.com/b44x/ai-polish-skills --path skills/filmwebВручную: положить файлы
.devin/skills/filmweb/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о filmweb
Как установить filmweb в Claude Code?
Выполни /plugin marketplace add b44x/ai-polish-skills и затем /plugin install filmweb@polskie-skille.
Что делает filmweb?
Ищет фильмы и сериалы на Filmweb и извлекает рейтинги, сюжет, актёрский состав, даты премьер и предложения VOD. Также умеет искать сведения об актёрах.
Что нужно для работы filmweb?
Нужен Python 3.8+ и сетевой доступ к www.filmweb.pl. Используется неофициальный JSON API; Python-библиотеки извне не требуются.
Исходный текст
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