scrape-forvo 0.1.0

Add your description here

scrape-forvo

Download pronunciation MP3s from Forvo search pages.

Installation

python -m pip install -e .

Usage

Only this command is confirmed to work reliably:

scrape-forvo https://forvo.com/search/egg/no/ --use-playwright --headed

Scriptable Usage

You can also import scrape_forvo and use it from Python:

from scrape_forvo import scrape

result = scrape(
    "https://forvo.com/search/egg/no/",
    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.

Development

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