Browserable is an open-source, self-hostable browser automation library designed for AI agents. It enables interaction with web pages, making it ideal for deep research and automation tasks in various applications.
claude install browserable/browserablehttps://docs.browserable.ai
[{"step":"Install and configure browserable. Run `pip install browserable` and set up a self-hosted instance or use a cloud-based browser automation service like Browserless. Ensure you have the necessary permissions to scrape the target website.","tip":"For websites with login walls, use browserable's session management to save and reuse cookies. Example: `browser.save_session('session.json')` and `browser.load_session('session.json')`."},{"step":"Define the target URL and data to extract. Use browserable's `navigate()` to load the page and `extract()` to pull specific elements. For dynamic content, use `wait_for_element()` to ensure the page is fully loaded.","tip":"Inspect the page structure using browser dev tools (F12) to identify the correct selectors for the data you need. Example: `browser.wait_for_element('div.job-listing')`."},{"step":"Handle edge cases. Implement retries for slow-loading pages, CAPTCHAs, or login prompts. Use browserable's built-in delays (`browser.delay(seconds=3)`) or custom error handling to manage interruptions.","tip":"For CAPTCHAs, consider using a CAPTCHA-solving service like 2Captcha, which can be integrated with browserable via API calls."},{"step":"Save and process the extracted data. Use Python's `json` or `csv` modules to save the results. For further analysis, import the data into tools like Pandas or Excel.","tip":"Add metadata to your output (e.g., timestamp, source URL) to make the data more useful for future reference. Example: `{'scraped_at': datetime.now().isoformat(), 'source_url': url}`."},{"step":"Automate the process. Schedule the script to run periodically using cron jobs, GitHub Actions, or a task scheduler. For example, set it to run every Monday at 9 AM to fetch the latest job postings.","tip":"Use environment variables to store sensitive data like login credentials or API keys. Example: `os.getenv('WEBSITE_USERNAME')`."}]
Automate the extraction of product pricing and specifications from e-commerce websites for market analysis.
Conduct competitive analysis by scraping competitor websites to gather insights on their offerings.
Test web applications by creating AI-driven scripts that simulate user interactions and validate functionality.
Gather insights for market research by automating the collection of data from various online sources.
claude install browserable/browserablegit clone https://github.com/browserable/browserableCopy the install command above and run it in your terminal.
Launch Claude Code, Cursor, or your preferred AI coding agent.
Use the prompt template or examples below to test the skill.
Adapt the skill to your specific use case and workflow.
Use the browserable library to automate a deep research task on [WEBSITE_URL]. Navigate to the [SPECIFIC_PAGE] and extract all [DATA_TYPE] (e.g., product prices, job listings, research papers). Save the results in a structured format like CSV or JSON. Include error handling for pages that load slowly or require login. Example: 'Use browserable to scrape all job postings from https://example.com/careers under the 'Software Engineer' category, including job titles, locations, and application deadlines. Save the data to a JSON file named jobs.json.'
```json
{
"scraped_data": [
{
"job_title": "Senior Frontend Engineer",
"location": "San Francisco, CA",
"application_deadline": "2023-12-15",
"salary_range": "$150,000 - $200,000",
"job_url": "https://example.com/careers/frontend-engineer-sf"
},
{
"job_title": "Backend Engineer (Remote)",
"location": "Anywhere",
"application_deadline": "2023-12-20",
"salary_range": "$130,000 - $180,000",
"job_url": "https://example.com/careers/backend-engineer-remote"
},
{
"job_title": "DevOps Engineer",
"location": "Austin, TX",
"application_deadline": "2023-12-10",
"salary_range": "$140,000 - $190,000",
"job_url": "https://example.com/careers/devops-engineer-austin"
}
],
"metadata": {
"total_jobs_found": 3,
"scraped_at": "2023-12-05T14:30:00Z",
"source_url": "https://example.com/careers",
"notes": "All job listings were under the 'Software Engineer' category. One listing required login; browserable handled authentication via saved session cookies."
}
}
```
**Execution Summary:**
- Successfully navigated to https://example.com/careers/software-engineer.
- Extracted 3 job postings by simulating clicks on 'Load More' buttons until no new jobs appeared.
- Handled a CAPTCHA challenge by waiting 5 seconds and retrying (browserable's built-in delay mechanism).
- Saved results to `jobs.json` in the current directory. The file includes all required fields and is ready for analysis in tools like Excel or Google Sheets.
**Potential Improvements:**
- Add a step to filter jobs by salary range (e.g., only include postings with salaries > $150,000).
- Include a screenshot of the final page state for debugging purposes (browserable supports `screenshot()`).
- Schedule this script to run weekly using a cron job or GitHub Actions.Take a free 3-minute scan and get personalized AI skill recommendations.
Take free scan