beautifulsoup4

Screen-scraping library

MIT License 54 个版本 Python >=3.7.0

安装

pip install beautifulsoup4

poetry add beautifulsoup4

pipenv install beautifulsoup4

conda install beautifulsoup4

描述

Beautiful Soup is a library that makes it easy to scrape information from web pages. It sits atop an HTML or XML parser, providing Pythonic idioms for iterating, searching, and modifying the parse tree.

Quick start

>>> from bs4 import BeautifulSoup
>>> soup = BeautifulSoup("<p>Some<b>bad<i>HTML")
>>> print(soup.prettify())
<html>
 <body>
  <p>
   Some
   <b>
    bad
    <i>
     HTML
    </i>
   </b>
  </p>
 </body>
</html>
>>> soup.find(string="bad")
'bad'
>>> soup.i
<i>HTML</i>
#
>>> soup = BeautifulSoup("<tag1>Some<tag2/>bad<tag3>XML", "xml")
#
>>> print(soup.prettify())
<?xml version="1.0" encoding="utf-8"?>
<tag1>
 Some
 <tag2/>
 bad
 <tag3>
  XML
 </tag3>
</tag1>

To go beyond the basics, comprehensive documentation is available.

Note on Python 2 sunsetting

Beautiful Soup's support for Python 2 was discontinued on December 31, 2020: one year after the sunset date for Python 2 itself. From this point onward, new Beautiful Soup development will exclusively target Python 3. The final release of Beautiful Soup 4 to support Python 2 was 4.9.3.

Supporting the project

If you use Beautiful Soup as part of your professional work, please consider a Tidelift subscription. This will support many of the free software projects your organization depends on, not just Beautiful Soup.

If you use Beautiful Soup for personal projects, the best way to say thank you is to read Tool Safety, a zine I wrote about what Beautiful Soup has taught me about software development.

Building the documentation

The bs4/doc/ directory contains full documentation in Sphinx format. Run make html in that directory to create HTML documentation.

Running the unit tests

Beautiful Soup supports unit test discovery using Pytest:

$ pytest

分类

Development Status :: 5 - Production/Stable Intended Audience :: Developers License :: OSI Approved :: MIT License Programming Language :: Python Programming Language :: Python :: 3 Topic :: Software Development :: Libraries :: Python Modules Topic :: Text Processing :: Markup :: HTML Topic :: Text Processing :: Markup :: SGML Topic :: Text Processing :: Markup :: XML

版本列表

4.15.0 2026-06-07

4.14.3 2025-11-30

4.14.2 2025-09-29

4.14.1 2025-09-29

4.14.0 2025-09-27

4.13.5 2025-08-24

4.13.4 2025-04-15

4.13.3 2025-02-04

4.13.2 2025-02-04

4.13.1 2025-02-03

4.13.0 2025-02-02

4.13.0b3 2025-01-06

4.13.0b2 2024-03-20

4.12.3 2024-01-17

4.12.2 2023-04-07

4.12.1 2023-04-05

4.12.0 2023-03-20

4.11.2 2023-01-31

4.11.1 2022-04-08

4.11.0 2022-04-07

4.10.0 2021-09-08

4.9.3 2020-10-03

4.9.2 2020-09-26

4.9.1 2020-05-17

4.9.0 2020-04-05

4.8.2 2019-12-24

4.8.1 2019-10-06

4.8.0 2019-07-20

4.7.1 2019-01-07

4.7.0 2018-12-31

4.6.3 2018-08-12

4.6.2 2018-08-12

4.6.1 2018-07-28

4.6.0 2017-05-07

4.5.3 2017-01-02

4.5.2 2017-01-02

4.5.1 2016-08-03

4.5.0 2016-07-20

4.4.1 2015-09-29

4.4.0 2015-07-03

4.3.2 2013-10-02

4.3.1 2014-01-21

4.3.0 2014-01-21

4.2.1 2014-01-21

4.2.0 2014-01-21

4.1.3 2014-01-21

4.1.2 2014-01-21

4.1.1 2014-01-21

4.1.0 2014-01-21

4.0.5 2014-01-21

4.0.4 2014-01-21

4.0.3 2014-01-21

4.0.2 2014-01-21

4.0.1 2014-01-21