BeautifulSoup Scraper
Pricing
Pay per usage
BeautifulSoup Scraper
Crawls websites using raw HTTP requests. It parses the HTML with the BeautifulSoup library and extracts data from the pages using Python code. Supports both recursive crawling and lists of URLs. This Actor is a Python alternative to Cheerio Scraper.
4.4 (5)
Pricing
Pay per usage
7
Monthly users
25
Runs succeeded
98%
Last modified
5 months ago
You can access the BeautifulSoup Scraper programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in Integrations settings in Apify Console.
1# Start Server-Sent Events (SSE) session and keep it running
2curl "https://actors-mcp-server.apify.actor/sse?token=<YOUR_API_TOKEN>&actors=apify/beautifulsoup-scraper"
3
4# Session id example output:
5# event: endpoint
6# data: /message?sessionId=9d820491-38d4-4c7d-bb6a-3b7dc542f1fa
Using BeautifulSoup Scraper via Model Context Protocol (MCP) server
MCP server lets you use BeautifulSoup Scraper within your AI workflows. Send API requests to trigger actions and receive real-time results. Take the received sessionId
and use it to communicate with the MCP server. The message starts the BeautifulSoup Scraper Actor with the provided input.
1curl -X POST "https://actors-mcp-server.apify.actor/message?token=<YOUR_API_TOKEN>&session_id=<SESSION_ID>" -H "Content-Type: application/json" -d '{
2 "jsonrpc": "2.0",
3 "id": 1,
4 "method": "tools/call",
5 "params": {
6 "arguments": {
7 "startUrls": [
8 {
9 "url": "https://crawlee.dev"
10 }
11 ],
12 "maxCrawlingDepth": 1,
13 "requestTimeout": 10,
14 "linkSelector": "a[href]",
15 "linkPatterns": [
16 ".*crawlee\\\\.dev.*"
17 ],
18 "pageFunction": "from typing import Any\\n\\n# See the context section in readme to find out what fields you can access \\n# https://apify.com/vdusek/beautifulsoup-scraper#context \\ndef page_function(context: Context) -> Any:\\n url = context.request['\''url'\'']\\n title = context.soup.title.string if context.soup.title else None\\n return {'\''url'\'': url, '\''title'\'': title}\\n",
19 "soupFeatures": "html.parser",
20 "proxyConfiguration": {
21 "useApifyProxy": true
22 }
23},
24 "name": "apify/beautifulsoup-scraper"
25 }
26}'
The response should be: Accepted
. You should received response via SSE (JSON) as:
1event: message
2data: {
3 "result": {
4 "content": [
5 {
6 "type": "text",
7 "text": "ACTOR_RESPONSE"
8 }
9 ]
10 }
11}
Configure local MCP Server via standard input/output for BeautifulSoup Scraper
You can connect to the MCP Server using clients like ClaudeDesktop and LibreChat or build your own. The server can run both locally and remotely, giving you full flexibility. Set up the server in the client configuration as follows:
1{
2 "mcpServers": {
3 "actors-mcp-server": {
4 "command": "npx",
5 "args": [
6 "-y",
7 "@apify/actors-mcp-server",
8 "--actors",
9 "apify/beautifulsoup-scraper"
10 ],
11 "env": {
12 "APIFY_TOKEN": "<YOUR_API_TOKEN>"
13 }
14 }
15 }
16}
You can further access the MCP client through the Tester MCP Client, a chat user interface to interact with the server.
To get started, check out the documentation and example clients. If you are interested in learning more about our MCP server, check out our blog post.
Pricing
Pricing model
Pay per usageThis Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage.