facrawlio

Easy one-function web scraping — pull data from any page and save it straight to CSV or JSON.

Install

pip install -e .

(or, once published: pip install facrawlio)

Quick start

from facrawlio import scrape

# Scrape into CSV
data = scrape(
    url="https://example.com/products",
    selector=".product-card",      # the repeating element for each item
    fields={
        "title": "h2",
        "price": ".price",
        "link": "a::attr(href)"    # use ::attr(x) to grab an attribute
    },
    output="products.csv"
)

# Same call, just change the output filename to get JSON instead
data = scrape(
    url="https://example.com/products",
    selector=".product-card",
    fields={"title": "h2", "price": ".price"},
    output="products.json"
)

print(data)  # list[dict] — also written to the output file

No fields? Just grab text

from facrawlio import scrape

headlines = scrape(
    url="https://example.com/news",
    selector="h2.headline",
    output="headlines.json"
)
# [{"text": "..."}, {"text": "..."}, ...]

Parameters

Notes

• Respect robots.txt and each site's terms of service before scraping.
• Add a delay when scraping multiple pages in a loop to be polite to servers.
• This library only fetches static HTML — it does not execute JavaScript. For JS-heavy sites you'll need a browser-based tool like Selenium or Playwright.

License

MIT