Crawlbase
Crawlbase provides APIs for crawling web pages, managing crawler queues, storing crawl results, and monitoring account usage.
Verdict
Common use cases
- Scrape competitor pricing pages daily
- Monitor job board listings for keywords
- Extract product specs from e-commerce sites
- Archive press releases into cloud storage
- Generate device-specific user agent strings
Integration
- Vendor
- Crawlbase
- Category
- other
- Auth
- API_KEY
- Tools
- 8
- Composio slug
crawlbase
Tools
- Crawl URL
Fetch a public HTTP or HTTPS URL through Crawlbase using the connected Normal token and return its content with separate target and Crawlbase statuses.
- Delete Stored Pagesdestructive
Irreversibly delete explicitly selected pages from Crawlbase Cloud Storage by request ID and return each page's deletion outcome.
- Generate User Agents
Generate one to ten realistic randomized User-Agent strings for a selected device class.
- Get Crawling Usage
Return current Crawling API usage and optionally previous-month statistics for the connected Crawlbase account.
- Get Storage Count
Return the number of pages currently held in Crawlbase Cloud Storage.
- Get Stored Page
Retrieve the latest Crawlbase Cloud Storage page by exactly one request ID or original URL.
- Get Stored Pages
Retrieve up to 100 Crawlbase Cloud Storage pages by request ID without deleting them. Returns decoded page content and identifies requested IDs that were not found.
- List Stored Page IDs
Return one page of Crawlbase Cloud Storage request IDs and a short-lived continuation cursor.
Setup
Setup guide
- 11. Open your Switchy workspace and navigate to Settings > Integrations > Add MCP Server. 2. Select Crawlbase from the catalog and click Connect. 3. Log into your Crawlbase account at crawlbase.com, go to Account > API Tokens, and copy your Normal Token (the one labeled for standard crawling). 4. Paste the token into the Switchy prompt and click Authorize—Switchy validates the token and confirms the connection. 5. Open any Project, type '@Crawlbase crawl https://example.com' in the chat, and send—the MCP returns the page HTML and both the target server status and Crawlbase proxy status. 6. Check the response for a request_id field; you can retrieve that page later from Cloud Storage using the Get Stored Page tool without re-crawling.
What teammates see: by default, memories from Crawlbase are scoped to the Project (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Projects have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
Crawl Product Page
@Crawlbase crawl https://example.com/product/12345 and parse out the product name, current price, and stock status from the HTML response.
Check Crawl Quota
@Crawlbase get my current crawling usage and tell me how many requests I have left this billing cycle.
Retrieve Archived Page
@Crawlbase get the stored page with request ID abc123xyz and show me the HTML content that was saved.
List Stored Pages
@Crawlbase list the request IDs of all pages currently in my Cloud Storage and display the first page of results.
Generate Mobile User Agents
@Crawlbase generate five realistic mobile user agent strings that I can use in my scraping scripts.
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@Crawlbase fetch the homepage of example.com and show me the page title and meta description
Crawlbase retrieved the page successfully. The target returned HTTP 200. Page title: 'Example Domain'. Meta description: 'Example Domain. This domain is for use in illustrative examples in documents.' The full HTML content is available if you need to extract additional elements. This example demonstrates a straightforward public URL crawl using the Normal token.
This read-heavy example shows Crawlbase's core crawling capability. Requires a valid Normal API token with sufficient credits. The MCP returns both the target site's HTTP status and Crawlbase's own status, so you can distinguish between a successful crawl of a 404 page versus a failed crawl attempt.
@Crawlbase I need to delete the stored pages with request IDs req_abc123 and req_def456 from cloud storage
Deletion complete. Request ID req_abc123: successfully deleted. Request ID req_def456: successfully deleted. Both pages have been irreversibly removed from Crawlbase Cloud Storage. Your storage count has decreased by 2. This example illustrates the destructive write operation for managing stored crawl results.
This write example demonstrates permanent storage management. Deletion is irreversible—there is no undo or recovery mechanism. Use cautiously in production workflows. You must provide exact request IDs; the MCP will report per-ID outcomes if some deletions fail while others succeed.
@Crawlbase retrieve the last 20 stored pages, then summarize which domains appear most frequently and flag any pages that returned non-200 status codes
Retrieved 20 stored pages. Domain frequency: example.com (8 pages), testsite.org (5 pages), demo.net (4 pages), sample.io (3 pages). Non-200 statuses flagged: 2 pages returned 404 (req_xyz789 from example.com/missing, req_uvw012 from demo.net/gone), 1 page returned 503 (req_rst345 from testsite.org/api). This synthesis pairs Crawlbase's storage retrieval with AI analysis to surface patterns across your crawl history.
This synthesis example combines the MCP's batch retrieval tool with the AI's reasoning to extract insights from stored crawl data. The MCP returns up to 100 pages per call; larger datasets require pagination using continuation cursors. Useful for auditing crawl campaigns or identifying problematic URLs before re-crawling.
Use-case deep-dives
When Crawlbase beats in-house scraping for weekly price checks
A three-person e-commerce team needs to track competitor pricing across 40 product pages every Monday morning. Building a scraper in-house means managing proxies, handling CAPTCHAs, and debugging when sites change their HTML. Crawlbase handles the infrastructure: the Crawl URL tool fetches pages through rotating IPs, the storage tools let you archive snapshots for trend analysis, and the user-agent generator keeps requests looking organic. The API key auth means anyone on the team can trigger crawls from Switchy without sharing credentials. This setup works until you hit 10,000+ pages per month—at that scale, the per-request cost adds up and you'll want to evaluate self-hosted alternatives. If your pricing check is under 2,000 pages monthly and you'd rather spend eng time on product than proxy rotation, Crawlbase is the faster path to reliable data.
Crawlbase for quarterly documentation snapshots at small SaaS
A five-person support team at a B2B SaaS company needs to keep internal runbooks synced with vendor documentation that lives on public sites. Every quarter, they crawl 15-20 integration partner docs to catch API changes before customers report broken workflows. The Get Storage Count and List Stored Page IDs tools let the team audit what's already archived, then Crawl URL fetches fresh versions and stores them for diff comparison. Delete Stored Pages cleans up obsolete snapshots after the review cycle. This scenario works because the volume is low (under 100 pages per quarter) and the cadence is predictable. If your team needs real-time monitoring or you're crawling hundreds of pages weekly, you'll outgrow this pattern and need a dedicated change-detection service. For quarterly syncs where the alternative is manual copy-paste into Notion, Crawlbase keeps the workflow in one place.
When Crawlbase isn't the right call for prospect enrichment
A four-person sales team wants to scrape LinkedIn profiles and company websites to build lead lists for cold outreach. Crawlbase can technically fetch public pages, but this scenario hits two hard limits: LinkedIn aggressively blocks scrapers (even through proxies), and the eight-tool set has no structured data extraction—you get raw HTML back, not parsed contact info. The Generate User Agents tool helps with basic anti-bot evasion, but you're still writing your own parsers and handling rate limits manually. For lead enrichment, a purpose-built tool like Apollo or ZoomInfo delivers structured records without the scraping overhead. Crawlbase makes sense when you need the raw page content for a custom workflow (say, archiving press mentions for a quarterly board deck), but if your goal is a CSV of emails and job titles, start with a data provider instead of a general-purpose crawler.
Frequently asked
What does the Crawlbase MCP do in Switchy?
It lets your AI agents fetch web pages through Crawlbase's proxy network, bypassing rate limits and bot detection. Agents can crawl URLs, store pages in Crawlbase Cloud Storage, retrieve stored content, and generate realistic user-agent strings. Useful when you need to scrape public data at scale without managing your own infrastructure.
Do I need a paid Crawlbase account to use this MCP?
Yes. You must provide a Crawlbase Normal token API key when connecting the MCP. Crawlbase charges per request, so every crawl your agents trigger counts against your Crawlbase plan. The MCP itself doesn't add extra fees, but you'll pay Crawlbase's usage rates for each URL fetched or stored.
Can this MCP scrape JavaScript-heavy sites like SPAs?
No. The Crawl URL tool uses Crawlbase's Normal token, which fetches raw HTML without executing JavaScript. If you need rendered content from React or Vue apps, you'd need to use Crawlbase's JavaScript token directly via their API—this MCP doesn't expose that endpoint yet.
Why use this MCP instead of calling Crawlbase's API directly?
The MCP wraps Crawlbase's API so your agents can crawl and retrieve pages in natural language without writing code. If you're already building custom scrapers in Python, stick with the API. If you want agents to autonomously fetch competitor pricing or monitor listings, the MCP is faster to deploy.
Who on the team should connect the Crawlbase account?
Whoever holds your Crawlbase API keys and understands your crawling budget. Each crawl costs credits, so you don't want every team member triggering expensive requests. Typically one ops or data person connects it, then shares the Switchy workspace with colleagues who need read-only access to stored pages.