s-creating-an-api-scraper

Implement API-based cinema scrapers that fetch showtimes into a TMDB-ready data model.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/gyarra/cine_medallo_2 --skill s-creating-an-api-scraper
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: s-creating-an-api-scraper
Source: https://github.com/gyarra/cine_medallo_2/tree/main/.claude/skills/s-creating-an-api-scraper
Command: npx skills add https://github.com/gyarra/cine_medallo_2 --skill s-creating-an-api-scraper

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This guide provides a standardized, scalable approach for building API-based scrapers that fetch cinema showtimes from REST endpoints and translate them into a consistent, TMDB-ready data model, reducing fragility and improving reliability over HTML parsing.

Core Features & Use Cases

  • API-driven showtime collection with an ApiClient + ShowtimeSaver architecture
  • API discovery, token extraction when required, and robust error handling
  • Management commands and Celery task patterns to automate multi-theater scrapes
  • Testing patterns and templates to validate parsing, merging across dates, and end-to-end flows

Quick Start

Create a new API scraper by implementing ApiClient and ShowtimeSaver following this pattern, configure a theater with scraper_config containing cinema_id, and run the Celery task to download showtimes.

Frequently Asked Questions about s-creating-an-api-scraper

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build a cinema API scraper to fetch showtimes from a REST endpoint?

Build a cinema API scraper by implementing a two-class ApiClient and ShowtimeSaver architecture that fetches showtimes from REST endpoints and translates them into a consistent, TMDB-ready data model for reliable data collection.

Why use an API scraper instead of HTML parsing for collecting cinema showtimes?

An API scraper reduces fragility and improves reliability over HTML parsing by directly fetching structured data from REST endpoints into a standardized data model, handling token extraction and date-merging across multiple days.

How do I automate multi-theater showtime scrapes with Celery tasks?

Automate multi-theater scrapes by configuring theater scraper_config with cinema_id, then running Celery tasks and management commands that orchestrate the ApiClient to download showtimes across multiple cinema chains.

What's the best way to test cinema API scrapers for parsing and merging showtimes?

The best way to test cinema API scrapers is using comprehensive testing patterns and templates that validate parsing logic, date-merging across multiple days, and end-to-end flows for multiple theaters.

Do I need a specific framework to scale API scrapers for multiple cinema chains?

You need a framework supporting modular design with Celery task integration and management commands to scale API scrapers, utilizing a template-based workflow that extends to future cinema chains.

Can I integrate movie metadata into a TMDB-ready data model with an API scraper?

Yes, you can integrate movie metadata into a TMDB-ready data model using the ShowtimeSaver class, which standardizes showtime data fetched from REST APIs into a consistent format for downstream use.