Metadata-Version: 2.4
Name: mfr24
Version: 0.1.0
Summary: Unofficial Python SDK for MyFlightRadar24 flight lists
Project-URL: Homepage, https://github.com/twangodev/mfr24
Project-URL: Repository, https://github.com/twangodev/mfr24
Project-URL: Issues, https://github.com/twangodev/mfr24/issues
Author-email: James Ding <james@twango.dev>
License: Apache-2.0
License-File: LICENSE
Keywords: adsb,aviation,flightradar24,flights,fr24,myflightradar24,scraper,sdk
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: >=3.12
Requires-Dist: airportsdata>=20260315
Requires-Dist: beautifulsoup4>=4.14
Requires-Dist: curl-cffi>=0.15.0
Requires-Dist: typer>=0.12
Provides-Extra: api
Requires-Dist: fastapi>=0.115; extra == 'api'
Requires-Dist: uvicorn[standard]>=0.30; extra == 'api'
Description-Content-Type: text/markdown

# mfr24

Unofficial Python SDK for [MyFlightRadar24](https://my.flightradar24.com): fetch any public profile's logged flights as typed data and globe-ready arcs.

> Not affiliated with Flightradar24. Reads public profile data; respect their Terms of Service.

## Install

```bash
pip install mfr24            # SDK + CLI
pip install "mfr24[api]"     # also the FastAPI server
```

## Usage

```python
from mfr24 import MyFlightRadar24Client, arcs, airports, to_globe

client = MyFlightRadar24Client()
flights = client.flights("johndoe")   # list[Flight], newest first
arcs(flights)                         # great-circle routes
airports(flights)                     # unique airports + visit counts
to_globe(flights)                     # {"arcs": [...], "airports": [...]}
```

## CLI

```bash
mfr24 export johndoe -o globe-arcs.json   # write the globe payload
mfr24 serve                               # run the HTTP API (needs the [api] extra)
```
