scrape-forvo 1.0.0

Add your description here

scrape-forvo

Download pronunciation MP3s from Forvo search pages.

Installation

uv run python -m pip install -e .

Usage

Only this command is confirmed to work reliably:

scrape-forvo egg --use-playwright --headed

Scriptable Usage

You can also import scrape_forvo and use it from Python:

from scrape_forvo import scrape

result = scrape(
    "egg",
    outdir="forvo_mp3",
    use_playwright=True,
    headed=True,
)

print(result.downloaded_count)
for candidate in result.candidates:
    print(candidate.url, "->", candidate.out_path)

The scrape() arguments map directly to CLI flags, so both interfaces share the same behavior without duplicated logic. Internally, the search URL is built as https://forvo.com/search/<word>/no/.

Development

Set up the project virtual environment with uv:

uv sync

Then run commands from the environment:

source .venv/bin/activate

Install dev dependencies:

python -m pip install -e .[dev]

Run tests:

pytest

Optional live test

Set FORVO_LIVE_TEST=1 to enable the live integration test.

TODO

edge cases

• when multiple pronunciation files come out. which one to pick?
• when there's no pronunciation available.

integration

• integration with the vocab repo