kurtmckee/feedparser

Parse feeds in Python

2,421

stars

891

commits

Python

primary language

Sep 7, 2026

updated

feedparser.readthedocs.io
atom
json
python
rdf
rss

README

..
    This file is part of feedparser.
    Copyright 2010-2026 Kurt McKee <contactme@kurtmckee.org>
    Copyright 2002-2008 Mark Pilgrim
    Released under the BSD 2-clause license.

..  image:: https://raw.githubusercontent.com/kurtmckee/feedparser/ad8e98ea352cc71cb159b55b976e31a1b041a6c8/docs/_static/banner.png
    :alt: feedparser: Parse RSS/Atom/JSON feeds in Python.

----


Installation
============

feedparser can be installed by running pip:

..  code-block:: console

    $ pip install feedparser


Documentation
=============

The feedparser documentation is available on the web at:

    https://feedparser.readthedocs.io/en/latest/

It can also be built and browsed locally using `tox`_:

..  code-block:: console

    $ tox run -e docs

This will produce HTML documentation in the ``build/docs/`` directory.


Testing
=======

Feedparser has an extensive test suite, powered by `tox`_:

..  code-block:: console

    $ tox run-parallel


..  Links
..  =====
..
..  _tox: https://tox.wiki/

Not written in Markdown, so it's shown here as plain text β€” view it formatted on GitHub.

Contributors

(top 30 of 49)

kurtmckee

724 commits

dependabot[bot]

27 commits

twm

9 commits

kurtmckee/feedparser

Parse feeds in Python

2,421

stars

891

commits

Python

primary language

Sep 7, 2026

updated

feedparser.readthedocs.io
atom
json
python
rdf
rss

README

..
    This file is part of feedparser.
    Copyright 2010-2026 Kurt McKee <contactme@kurtmckee.org>
    Copyright 2002-2008 Mark Pilgrim
    Released under the BSD 2-clause license.

..  image:: https://raw.githubusercontent.com/kurtmckee/feedparser/ad8e98ea352cc71cb159b55b976e31a1b041a6c8/docs/_static/banner.png
    :alt: feedparser: Parse RSS/Atom/JSON feeds in Python.

----


Installation
============

feedparser can be installed by running pip:

..  code-block:: console

    $ pip install feedparser


Documentation
=============

The feedparser documentation is available on the web at:

    https://feedparser.readthedocs.io/en/latest/

It can also be built and browsed locally using `tox`_:

..  code-block:: console

    $ tox run -e docs

This will produce HTML documentation in the ``build/docs/`` directory.


Testing
=======

Feedparser has an extensive test suite, powered by `tox`_:

..  code-block:: console

    $ tox run-parallel


..  Links
..  =====
..
..  _tox: https://tox.wiki/

Not written in Markdown, so it's shown here as plain text β€” view it formatted on GitHub.

Contributors

(top 30 of 49)

kurtmckee

724 commits

dependabot[bot]

27 commits

twm

9 commits

Languages

Python

100.0%