> ## Documentation Index
> Fetch the complete documentation index at: https://nvd-54.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# BSHTMLLoader 集成

> 使用 LangChain Python 集成 BSHTMLLoader 文档加载器。

This guide provides a quick overview for getting started with BeautifulSoup4 [document loader](/oss/python/integrations/document_loaders). For detailed documentation of all BeautifulSoup4 features and configurations head to the [API reference](https://reference.langchain.com/python/langchain-community/document_loaders/html_bs/BSHTMLLoader).

## 概述

### 集成详情

| Class                                                                                                              | Package                                                                             | Local | Serializable | JS support |
| :----------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------- | :---: | :----------: | :--------: |
| [`BSHTMLLoader`](https://reference.langchain.com/python/langchain-community/document_loaders/html_bs/BSHTMLLoader) | [`langchain-community`](https://reference.langchain.com/python/langchain-community) |   ✅   |       ❌      |      ❌     |

### 加载器特性

|     Source     | Document Lazy Loading | Native Async Support |
| :------------: | :-------------------: | :------------------: |
| `BSHTMLLoader` |           ✅           |           ❌          |

## 设置

To access BSHTMLLoader document loader you'll need to install the `langchain-community` integration package and the `bs4` Python 包。

### 凭证

No credentials are needed to use the `BSHTMLLoader` class.

要启用模型调用的自动追踪，请设置你的 [LangSmith](/langsmith/home) API 密钥：

```python theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
os.environ["LANGSMITH_API_KEY"] = getpass.getpass("Enter your LangSmith API key: ")
os.environ["LANGSMITH_TRACING"] = "true"
```

### 安装

安装 **langchain-community** and **bs4**。

```python theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
pip install -qU langchain-community bs4
```

## 初始化

现在我们可以实例化模型对象并加载文档：

* TODO: Update model instantiation with relevant params.

```python theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
from langchain_community.document_loaders import BSHTMLLoader

loader = BSHTMLLoader(
    file_path="./example_data/fake-content.html",
)
```

## 加载

```python theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
docs = loader.load()
docs[0]
```

```text theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
Document(metadata={'source': './example_data/fake-content.html', 'title': 'Test Title'}, page_content='\nTest Title\n\n\nMy First Heading\nMy first paragraph.\n\n\n')
```

```python theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
print(docs[0].metadata)
```

```python theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
{'source': './example_data/fake-content.html', 'title': 'Test Title'}
```

## 惰性加载

```python theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
page = []
for doc in loader.lazy_load():
    page.append(doc)
    if len(page) >= 10:
        # do some paged operation, e.g.
        # index.upsert(page)

        page = []
page[0]
```

```text theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
Document(metadata={'source': './example_data/fake-content.html', 'title': 'Test Title'}, page_content='\nTest Title\n\n\nMy First Heading\nMy first paragraph.\n\n\n')
```

## Adding separator to BS4

我们可以also pass a separator to use when calling get\_text on the soup

```python theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
loader = BSHTMLLoader(
    file_path="./example_data/fake-content.html", get_text_separator=", "
)

docs = loader.load()
print(docs[0])
```

```python theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
page_content='
, Test Title,
,
,
, My First Heading,
, My first paragraph.,
,
,
' metadata={'source': './example_data/fake-content.html', 'title': 'Test Title'}
```

***

## API 参考

For detailed documentation of all `BSHTMLLoader` features and configurations head to the [API reference](https://reference.langchain.com/python/langchain-community/document_loaders/html_bs/BSHTMLLoader)

***

<div className="source-links">
  <Callout icon="terminal-2">
    [通过 MCP 将这些文档连接到](/use-these-docs) Claude、VSCode 等工具以获取实时答案。
  </Callout>

  <Callout icon="edit">
    [在 GitHub 上编辑此页面](https://github.com/langchain-ai/docs/edit/main/src/oss/python/integrations/document_loaders/bshtml.mdx) 或 [提交 issue](https://github.com/langchain-ai/docs/issues/new/choose)。
  </Callout>
</div>