html-imdbinfo 0.9.1__py3-none-any.whl

html_imdbinfo-0.9.1.dist-info/METADATA

@@ -0,0 +1,410 @@
+Metadata-Version: 2.4
+Name: html_imdbinfo
+Version: 0.9.1
+Summary: A Python service for querying IMDb data
+Author-email: "@tveronesi" <tveronesi+imdbinfo@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2025 Tiago Veronesi
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://tveronesi.github.io/imdbinfo/
+Keywords: imdb,movie,information,data
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: niquests
+Requires-Dist: lxml
+Requires-Dist: pydantic
+Requires-Dist: jmespath
+Requires-Dist: deprecated
+Requires-Dist: imdbinfo-aws
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: mypy; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+Requires-Dist: black; extra == "dev"
+Provides-Extra: build
+Requires-Dist: build; extra == "build"
+Requires-Dist: twine; extra == "build"
+Provides-Extra: test
+Requires-Dist: pytest>=7.0; extra == "test"
+Dynamic: license-file
+
+[![PyPI Downloads](https://static.pepy.tech/badge/imdbinfo)](https://pepy.tech/projects/imdbinfo)
+[![PyPI Version](https://img.shields.io/pypi/v/imdbinfo?style=flat-square)](https://pypi.org/project/imdbinfo/)
+[![Build Status](https://github.com/tveronesi/imdbinfo/actions/workflows/pypi-publish.yml/badge.svg)](https://github.com/tveronesi/imdbinfo/actions/workflows/pypi-publish.yml)
+[![Python Versions](https://img.shields.io/pypi/pyversions/imdbinfo?style=flat-square)](https://pypi.org/project/imdbinfo/)
+
+[//]: # (![PyPI - Daily Downloads]&#40;https://img.shields.io/pypi/dm/your-package-name?label=PyPI%20downloads&logo=pypi&#41;)
+
+# imdbinfo
+
+**Your personal gateway to IMDb data**. Search for movies, series and people and get structured information in seconds.
+
+## Features
+
+- 🔍 **Search movies, series, miniseries and people** by name or title
+- 🎬 **Detailed movie info** including cast, crew, ratings and more
+- 👥 **Detailed person info** with biography, filmography and images
+- 📺 **TV series and miniseries** support with seasons and episodes
+- 🌐 **Localized results** in multiple languages (set globally or per request)
+- 📅 **Release dates** and **box office** information
+- 🌍 **International titles** and **alternate titles (AKAs)** via `get_akas`
+- 📸 **Poster images** and **backdrops**
+- 📊 **Ratings** from IMDb and other sources
+- 📝 **User reviews and ratings** via `get_reviews`
+- 🎭 **Movie trivia and interesting facts** via `get_trivia`
+- 🗂️ **Full filmography** for actors, directors and writers via `get_filmography`
+- 🛡️ **Parental guide** including content advisories via `get_parental_guide`
+- 📝 **Typed Pydantic models** for predictable responses
+- ⚡ **Built-in caching** for faster repeated requests
+- 🛡️**AWS WAF** solver in CPython for better performance
+- ✅ **No API keys required**
+
+## Installation
+
+```bash
+pip install imdbinfo
+```
+
+## Quick Start
+
+```python
+from imdbinfo import search_title, get_movie, get_name, get_season_episodes, get_reviews, get_trivia
+
+# Search for a title
+results = search_title("The Matrix")
+for movie in results.titles:
+    print(f"{movie.title} ({movie.year}) - Rating: {movie.rating} - {movie.imdb_id}")
+
+# Get movie details
+movie = get_movie("0133093")  # or 'tt0133093'
+print(movie.title, movie.year, movie.rating)
+
+# Get movie kind:
+print(movie.kind)  # movie, tvSeries, tvMiniSeries, tvMovie, tvEpisode, tvSpecial, tvShort, short, videoGame, video, musicVideo, podcastEpisode, podcastSeries
+print(movie.is_series())  # False
+
+# Get person details
+person = get_name("nm0000206")  # or '0000206' 
+print(person.name, person.birth_date)
+```
+#### Working with Series and Episodes
+
+The `movie` object provides helpful methods to identify its type:
+
+- `movie.is_series()` — Returns `True` if the movie is a series.
+- `movie.is_episode()` — Returns `True` if the movie is an episode.
+
+Depending on the type, you can access additional information:
+
+- For series: use `movie.info_series` to get series details (creators, seasons, episodes, ...)
+- For episodes: use `movie.info_episode` to get episode details 
+
+#### Example: Working with Series and Episodes
+
+```python
+from imdbinfo import get_movie, get_season_episodes
+
+# Fetch a TV series as a Movie object
+walking_dead_serie = get_movie("tt1520211")  # Walking Dead
+
+# Check if the object is a series
+print(walking_dead_serie.is_series())  # True
+
+# Access series-specific information
+print(f"Series Info: {walking_dead_serie.info_series}")
+
+# Retrieve episodes for the series season 1
+walking_dead_episodes = get_season_episodes(walking_dead_serie.imdb_id, season=1)
+
+# Print details for the first 3 episodes from the season 1
+for episode_info in walking_dead_episodes[:3]:
+    print(episode_info)
+
+# Fetch a single episode as a Movie object and check its type
+episode_detail = get_movie(episode_info.imdb_id)
+print("Is Episode:", episode_detail.is_episode())  # True
+
+# Access episode-specific information: series imdbid, season and episode number ...
+print(f"Episode Info: {episode_detail.info_episode}")
+```
+
+#### All episodes in a series
+You can now retrieve all episodes in a series with a single call:
+```python
+from imdbinfo import get_all_episodes
+# Fetch all episodes for a series
+all_episodes = get_all_episodes("tt1520211")  # Walking Dead
+for episode in all_episodes:
+    print(f"Title: {episode.title} - ({episode.imdbId})")
+    print(f"Plot: {episode.plot[:100]}...")
+    print(f"Release Date: {episode.release_date}")
+    print(f"Rating: {episode.rating}")
+    print(f"Duration: {episode.duration/60}min")
+    print("" + "="*50)
+```
+
+#### Company Credits
+
+* distribution companies, 
+* production companies, 
+* sales companies, 
+* special effects companies, 
+* miscellaneous companies
+
+You can now extract information about the companies involved in a movie or series:
+
+```python
+from imdbinfo import get_movie
+
+movie = get_movie("tt0133093")  # The Matrix
+
+# Distribution companies
+for company in movie.company_credits["distribution"]:
+    print(f"Distribution: {company.name} ({company.country})")
+
+# Sales companies
+for company in movie.company_credits["sales"]:
+    print(f"Sales: {company.name}")
+
+# Production companies
+for company in movie.company_credits["production"]:
+    print(f"Production: {company.name}")
+
+# Special effects companies
+for company in movie.company_credits["specialEffects"]:
+    print(f"Special Effects: {company.name}")
+
+# Miscellaneous companies
+for company in movie.company_credits["miscellaneous"]:
+    print(f"Miscellaneous: {company.name}")
+```
+
+#### Alternate titles (AKAs)
+Fetch international and alternate titles for any movie or series:
+```python
+from imdbinfo import get_akas
+akas = get_akas("tt0133093")  # The Matrix
+for aka in akas["akas"][:5]:
+    print(f"{aka.title} ({aka.country_name})")
+```
+
+#### Reviews and User Ratings
+Get user reviews and ratings for any movie or series:
+```python
+from imdbinfo import get_reviews
+reviews = get_reviews("tt0133093")  # The Matrix
+for review in reviews[:3]:
+    print(f"Rating: {review['authorRating']}/10")
+    print(f"Summary: {review['summary']}")
+    print(f"Helpful votes: {review['upVotes']} up, {review['downVotes']} down")
+    print(f"Spoiler: {review['spoiler']}")
+    print("---")
+```
+
+#### Movie Trivia and Facts
+Discover interesting trivia and behind-the-scenes facts:
+```python
+from imdbinfo import get_trivia
+trivia = get_trivia("tt0133093")  # The Matrix
+for fact in trivia[:3]:
+    print(f"Interest Score: {fact['interestScore']}")
+    print(f"Fact: {fact['body'][:200]}...")
+    print("---")
+```
+
+#### Parental Guide
+Get parental guide information including content advisories, severity level, spoiler flags, and content descriptions:
+
+```python
+from imdbinfo import get_parental_guide
+
+pg = get_parental_guide("tt0133093")  # The Matrix
+for cat in pg.categories:
+    print(cat)  # e.g. NUDITY - MILD (6 descriptions)
+    for txt in cat.category_texts_list(spolier=True):
+        print(f" - {txt.text} (SPOILER: {txt.is_spoiler})")
+```
+
+#### Awards
+
+The package groups award-related counts in the `MovieDetail.awards` object (an `AwardInfo` instance). The model currently exposes:
+
+- `wins` — number of award wins
+- `nominations` — number of nominations (excluding wins)
+- `prestigious_award` — optional dict containing details of a prestigious award (may include `wins` and `nominations` keys)
+
+Example showing how to safely read `MovieDetail.awards` using the current model shape:
+
+```python
+from imdbinfo import get_movie
+
+movie = get_movie("tt0133093")  # The Matrix
+aw = movie.awards
+if not aw:
+    print("No award information available for this title")
+else:
+    # basic counts
+    print("wins:", aw.wins)
+    print("nominations:", aw.nominations)
+
+    # prestigious award (may be None or a dict)
+    if aw.prestigious_award:
+        pa = aw.prestigious_award
+        print("prestigious wins:", pa.get("wins"))
+        print("prestigious nominations:", pa.get("nominations"))
+    else:
+        print("No prestigious award summary available")
+```
+
+Notes:
+- The JSON parser maps page data into `movie.awards` (a dict turned into an `AwardInfo` instance). Depending on the source data, `prestigious_award` can be None or a dict with `wins` and `nominations`.
+- Use `if movie.awards:` to check presence before reading attributes.
+
+
+### Localized results in multiple languages (set globally or per request)
+
+Added support for locales in `search_movie`, `get_movie`, `get_episodes`, `get_all_episodes`, `get_name`
+```python
+from imdbinfo import get_movie, search_title
+# Fetch movie details in Italian
+movie_it = get_movie("tt0133093", locale="it")  # The Matrix
+
+# Search for titles in Spanish (although IMDb search is mostly in all languages)
+results_es = search_title("La Casa de Papel", locale="es")
+```
+
+Localized data can be set globally, dont need to pass `locale` every time in the functions:
+```python
+from imdbinfo import get_movie
+from imdbinfo.locale import set_locale
+set_locale("it")  # Set default locale to Italian
+movie_it = get_movie("tt0133093")  # The Matrix in Italian
+```
+
+#### MovieInfoBrief.title_localized
+The `MovieInfoBrief` object (e.g., items in `results.titles` from `search_title`) now includes the `title_localized` property. This property contains the title in the requested locale, if available, and falls back to the default `title` when a localized version is not present.
+
+Example:
+```python
+from imdbinfo import search_title
+
+# Search for a title with a specific locale
+results = search_title("The Matrix", locale="it")
+for item in results.titles:
+    # Print the localized title if available, otherwise the default title
+    print(item.title, "->", getattr(item, "title_localized", item.title))
+```
+
+### Filtering results based on type (e.g. Movies, Series, Episodes etc.) 🔽 
+You can filter results from `search_title`, done server-side.
+```python
+from imdbinfo import search_title, TitleType
+
+# Search for single type: movies
+results = search_title("The Matrix", title_type=TitleType.Movies)
+for movie in results.titles:
+    print(f"{movie.title} ({movie.year}) - {movie.imdb_id}")
+
+# Search for multiple types: movies, shorts and videos.
+results = search_title("The Matrix", title_type=(TitleType.Movies, TitleType.Shorts, TitleType.Video))
+for movie in results.titles:
+    print(f"{movie.title} ({movie.year}) - {movie.imdb_id}")
+
+```
+
+### Get filmography with images 🎬🖼️
+You can now get filmography for actors, directors and writers and all credits with images:
+```python
+from imdbinfo import get_filmography
+
+filmography = get_filmography("nm0000206")  # Brad Pitt
+if filmography:
+    for role, films in filmography.items():
+        print(f"\nRole: {role}")
+        for film in films:
+            print(f" - {film.title} ({film.year}) [{film.imdbId}]")
+
+```
+
+#### Get all interests for a title
+
+_Fetch all interests for a title using the provided IMDb ID. Most time it returns the same as genres. 
+    It requires a new request and parsing. Use it only if you really need it._
+
+```python
+from imdbinfo import get_all_interests
+
+movies = ["tt1490017", "tt0133093"]
+
+for imdb_id in movies:
+    interests = get_all_interests(imdb_id)
+    print(f"Interests for {imdb_id}: {interests}")
+```
+
+
+📝 For more examples see the [examples](examples/) folder.
+
+> 💡 **Looking for a ready-to-use API based on this package? Check out [qdMovieAPI](https://github.com/tveronesi/qdMovieAPI) — a fast and simple way to access IMDb data via REST!**
+
+## Why choose imdbinfo?
+
+- Easy to use Python API
+- Returns clean structured data
+- Powered by niquests and lxml
+- Uses Pydantic for type safety
+- No external dependencies or API keys required
+- Ideal for quick scripts and data analysis
+
+## Disclaimer
+This project and its authors are not affiliated in any way with IMDb Inc. or its affiliates. 
+For more information, please refer to the [DISCLAIMER](DISCLAIMER.txt) file.
+
+## Contributing
+
+Contributions are welcome! Open an issue or pull request on GitHub.
+
+If you find this project useful, please consider giving it a ⭐ on GitHub!
+
+Please read our [Contributing Guidelines](CONTRIBUTING.md) and [Code of Conduct](CODE_OF_CONDUCT.md) before contributing.
+
+## Star History
+
+<a href="https://www.star-history.com/?repos=tveronesi%2Fimdbinfo&type=date&legend=top-left">
+ <picture>
+   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=tveronesi/imdbinfo&type=date&theme=dark&logscale&legend=top-left" />
+   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=tveronesi/imdbinfo&type=date&logscale&legend=top-left" />
+   <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=tveronesi/imdbinfo&type=date&logscale&legend=top-left" />
+ </picture>
+</a>
+
+## License
+
+imdbinfo is released under the MIT License.
+See the [LICENSE](LICENSE) file for details.
+

html_imdbinfo-0.9.1.dist-info/RECORD

@@ -0,0 +1,14 @@
+html_imdbinfo-0.9.1.dist-info/licenses/LICENSE,sha256=rSm7MgM5XqJCkDsSPqByHUApT-v-Lexw314AZsnyPdg,1071
+imdbinfo/__init__.py,sha256=Wxn4-M8RYwRrHBbciAd5DXN12QRQujY2i12_ILsHVDo,1995
+imdbinfo/cli.py,sha256=jshdYSSp2j2b48CH1ZUy5h4xpviSEmfwrHwzdjwefOc,3404
+imdbinfo/exceptions.py,sha256=VLXxHTZ0qEO6w3OWvyHPDbO7eeFb83GqNsaBEKk68Lk,5065
+imdbinfo/locale.py,sha256=KfiEpWqC6aATKWKS7Gwa8pkpCiSQ5vfQ-wyunxICY9w,2924
+imdbinfo/models.py,sha256=LC71OOYsUzAnGuB8LUGky8YUR-1UT3b_cs9YAcnt1tE,26305
+imdbinfo/parsers.py,sha256=DxBH9-SmP_lyCJsh5VMq3zD0YLctFWxz7wwbxYXA6e4,33942
+imdbinfo/services.py,sha256=SNfIXkaQ2LU3KqLzcYTbAP8uAZjDvihrkugDit-UOcg,24600
+imdbinfo/transformers.py,sha256=cPhx5mY7fNccDPMrjjAVdN0jge_JbKLg8Clvc8DJPeY,3355
+html_imdbinfo-0.9.1.dist-info/METADATA,sha256=xrjJd_Li-VQzidG4Geho5kC0Vjp2VbpcK5z1o3Dlm-M,15331
+html_imdbinfo-0.9.1.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+html_imdbinfo-0.9.1.dist-info/entry_points.txt,sha256=QETfNv-2hupV4PK_e0SBeOVEQljTyVX0vWsaFyUcFvo,53
+html_imdbinfo-0.9.1.dist-info/top_level.txt,sha256=1204ZLnfhCdCzFCOnxCX3kFFbXKWtHzuKD9Pg5e_14g,9
+html_imdbinfo-0.9.1.dist-info/RECORD,,

html_imdbinfo-0.9.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

html_imdbinfo-0.9.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+imdbinfo-fetch = imdbinfo.cli:main

html_imdbinfo-0.9.1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Tiago Veronesi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

html_imdbinfo-0.9.1.dist-info/top_level.txt

@@ -0,0 +1 @@
+imdbinfo

imdbinfo/__init__.py

@@ -0,0 +1,70 @@
+# MIT License
+# Copyright (c) 2025 tveronesi+imdbinfo@gmail.com
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+
+import logging
+
+from .services import (
+    get_movie,
+    search_title,
+    get_name,
+    get_episodes,
+    get_all_episodes,
+    get_season_episodes,
+    get_akas,
+    get_reviews,
+    get_trivia,
+    get_parental_guide,
+    get_filmography,
+    get_all_interests,
+    TitleType,
+)
+from .exceptions import (
+    ImdbinfoError,
+    HTTPError,
+    WAFError,
+    GraphQLError,
+    ParseError,
+)
+
+__all__ = [
+    "get_movie",
+    "search_title",
+    "get_name",
+    "get_episodes",
+    "get_all_episodes",
+    "get_season_episodes",
+    "get_akas",
+    "get_reviews",
+    "get_trivia",
+    "get_parental_guide",
+    "get_filmography",
+    "get_all_interests",
+    "TitleType",
+    # exceptions
+    "ImdbinfoError",
+    "HTTPError",
+    "WAFError",
+    "GraphQLError",
+    "ParseError",
+]
+
+# setup library logging
+logging.getLogger(__name__).addHandler(logging.NullHandler())

imdbinfo/cli.py

@@ -0,0 +1,108 @@
+"""imdbinfo-fetch – minimal CLI that returns raw IMDb HTML to stdout.
+
+Usage
+-----
+    imdbinfo-fetch <url>
+
+The HTTP request goes through the same ``request_handler`` used internally by
+the library, so WAF cookie rotation and the browser-like headers are all
+handled automatically – exactly what lets the library scrape IMDb reliably.
+
+Your PHP app can then extract ``__NEXT_DATA__`` from the HTML however it likes,
+for example with a regex:
+
+    preg_match('/<script id="__NEXT_DATA__"[^>]*>(.*?)<\\/script>/s', $html, $m);
+    $data = json_decode($m[1], true);
+
+Exit codes
+----------
+    0  – success, HTML written to stdout
+    1  – bad arguments or non-200 HTTP response
+    2  – WAF blocked the request (HTTP 202)
+"""
+
+import sys
+import argparse
+
+from .services import request_handler
+from .exceptions import HTTPError, WAFError
+
+
+def _build_parser() -> argparse.ArgumentParser:
+    p = argparse.ArgumentParser(
+        prog="imdbinfo-fetch",
+        description=(
+            "Fetch a raw IMDb page and print its HTML to stdout.\n\n"
+            "The request uses the same WAF-aware headers as the imdbinfo library,\n"
+            "so the response is exactly what a real browser would receive."
+        ),
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog=(
+            "Examples:\n"
+            "  imdbinfo-fetch https://www.imdb.com/title/tt0166924/reference\n"
+            "  imdbinfo-fetch https://www.imdb.com/lists/tt0166924\n"
+            "  imdbinfo-fetch https://www.imdb.com/name/nm0000338/\n\n"
+            "Pipe to a file:\n"
+            "  imdbinfo-fetch https://www.imdb.com/title/tt0133093/reference > matrix.html\n"
+        ),
+    )
+    p.add_argument(
+        "url",
+        help="Full IMDb URL to fetch (must start with https://www.imdb.com/)",
+    )
+    p.add_argument(
+        "--check-domain",
+        action="store_true",
+        default=True,
+        help="Warn (but do not abort) when the URL is not an IMDb domain (default: on)",
+    )
+    p.add_argument(
+        "--no-check-domain",
+        dest="check_domain",
+        action="store_false",
+        help="Skip the IMDb domain warning",
+    )
+    return p
+
+
+def main() -> None:
+    parser = _build_parser()
+    args = parser.parse_args()
+
+    url: str = args.url
+
+    if not url.startswith(("http://", "https://")):
+        parser.error(f"URL must start with http:// or https://  – got: {url!r}")
+
+    if args.check_domain and "imdb.com" not in url:
+        print(
+            f"Warning: URL does not look like an IMDb URL: {url!r}",
+            file=sys.stderr,
+        )
+
+    try:
+        resp = request_handler(url)
+    except WAFError as exc:
+        print(f"Error: WAF blocked the request – {exc}", file=sys.stderr)
+        sys.exit(2)
+    except HTTPError as exc:
+        print(f"Error: HTTP {exc.status_code} – {exc}", file=sys.stderr)
+        sys.exit(1)
+    except Exception as exc:  # network error, DNS, etc.
+        print(f"Error: {exc}", file=sys.stderr)
+        sys.exit(1)
+
+    if resp.status_code != 200:
+        print(
+            f"Error: received HTTP {resp.status_code} from {url}",
+            file=sys.stderr,
+        )
+        sys.exit(1)
+
+    # Write raw bytes to stdout so the encoding is preserved faithfully.
+    # PHP reads bytes too, so this is the safest approach.
+    sys.stdout.buffer.write(resp.content)
+
+
+if __name__ == "__main__":
+    main()