# FASS

FASS is a lightweight FastAPI and Selenium server that scrapes JavaScript-rendered websites through a REST API, letting self-hosters extract data with regex patterns. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/2165/fass

## Description

FASS is a lightweight FastAPI and Selenium server that scrapes JavaScript-rendered websites through a REST API, letting self-hosters extract data with regex patterns.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

29/100 (Low), based on 4 of 5 factors.
- Maintained: 0 (last commit 743 days ago)
- Popular: 27 (22 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Security check: 85 (no serious findings, CI)

## Links

- Docker Hub: https://hub.docker.com/r/zerealfu/fass
- GitHub: https://github.com/fu/fass
- Unraid: https://ca.unraid.net/apps/fass-0iosrwp0br0c1p?q=FASS

## Common questions

### How do I send a scrape job to FASS?

POST a JSON array to the /parse endpoint. Each item needs url, name, delay, and patterns.

### Which port should I expose for FASS?

Run the container with port 8000 mapped to host port 8000. The parser is exposed on the /parse path.

### How does FASS handle pages that need JavaScript to load?

Use the delay field for each URL. It defines how many seconds the Selenium driver waits before scraping the page.

### What does FASS return when a regex matches?

Matched values are always returned as lists because all occurrences on the page are matched. If multiple regex groups are defined, the list contains tuples.

---
Source: Our Local Host (https://ourlocalhost.com/app/2165/fass), the self-hosted and open-source app directory.
