Case study

API SPFC Calendar

Web Scraping API to extract matches from the São Paulo FC calendar using Firecrawl.

API SPFC CalendarPreview

Problem

I wanted São Paulo FC's matches in my calendar without adding them one by one, and the official schedule has no API.

What was built

A FastAPI service that extracts the schedule from the club's website with Firecrawl.

  • Endpoints for all matches, this week's matches and the next match
  • Tracking of matches already synced to Google Calendar, designed for n8n automation
  • Cache with status and manual clearing

What sets it apart

It was built to be safely exposed on the internet: Bearer token authentication, a rate limit of 30 requests per minute per IP, security headers, configurable CORS and compatibility with the Cloudflare proxy. The documentation is public on ReDoc.

Outcome

Live and used by Catálogo BR and by my calendar automation.

Gallery

01 / 01