mcpField
W
web-research-assistant

web-research-assistant

github.com/browser-actProductivity6.3k76 installsUpdated 9w ago
Repository

About web-research-assistant

web-research-assistant is a BrowserAct-powered skill for agents that need web research when direct access is restricted. It searches across sources, extracts and validates findings, and produces cited reports.

Key features

  1. 01Search with multiple engines and filters
  2. 02Automatic fallback when direct access fails
  3. 03Aggregate and cross-check sources
  4. 04Extract facts, statistics, and citations
  5. 05Generate structured research reports

Use cases

  1. 01Research topics blocked by website access controls
  2. 02Gather current information across sources
  3. 03Filter news or articles by date
  4. 04Compile cited findings for a report

MCP support

It uses BrowserAct MCP for web search and extraction.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/browser-act/skills --skill web-research-assistant

After installing, type/web-research-assistantin Claude Code to confirm it loaded.

Bundled filesscripts/research.py

Details

From the project README

Web Research Assistant

This skill leverages BrowserAct API to provide powerful web research capabilities. When primary web access is restricted or blocked, it automatically searches the internet to find and extract relevant information, ensuring your research tasks are completed successfully.

✨ OpenClaw & Claude Code Optimized

🚀 Works Seamlessly with OpenClaw and Claude Code

PlatformStatusInstallation
OpenClaw✅ Highly RecommendedCopy to ~/.openclaw/skills/
Claude Code✅ Highly RecommendedNative skill support
OpenCode✅ Fully SupportedCopy to ~/.opencode/skills/
Cursor✅ Fully SupportedCopy to ~/.cursor/skills/

Why This Skill?

  • 🎯 Purpose-built for OpenClaw and Claude Code
  • 🔄 Auto-recovery when web access is restricted
  • 🌐 Global access - no IP or geoblocking issues
  • 💰 Cost-effective - saves token usage
  • ⚡ Fast execution - BrowserAct powered

🎯 When to Use

Web Access Restricted? No Problem!

Use this skill when:

  • 🔒 Target websites block AI assistant access
  • 🌍 Geographic restrictions limit content access
  • 🔐 Paywalls prevent data extraction
  • ⏱️ Need quick supplemental information
  • 📊 Research requires multiple data sources
  • 🔍 Need current information beyond cached data

🔑 API Key Guidance

Before running, check the BROWSERACT_API_KEY environment variable. If not set, request the API key from the user:

Required Message:

"Please provide your BrowserAct API Key from BrowserAct Console to enable web research capabilities."

🛠️ Input Parameters

Configure research based on your needs:

ParameterTypeDefaultDescription
querystring-Research topic or question
enginestringgoogleSearch engine (google, bing, duckduckgo)
max_resultsnumber10Results to retrieve (1-50)
content_typestringallContent filter (all, news, articles, data)
time_rangestringpast_monthTime filter (anytime, past_day/week/month/year)

💻 Quick Start

# Basic research
python web-research-assistant/scripts/research.py "AI technology trends"

# Deep research with more results
python web-research-assistant/scripts/research.py "competitor analysis" --max-results 20

# Current news research
python web-research-assistant/scripts/research.py "market trends" --content-type news

# Save to file
python web-research-assistant/scripts/research.py "industry data" -o research_report.md

📊 Output

Structured Research Data:

  • Titles, URLs, snippets, and relevance scores
  • Key facts and statistics extraction
  • Source citations and references
  • Comprehensive research report

🎪 What This Skill Does

  1. 🔄 Auto-Supplement - When direct access fails, automatically searches the web
  2. 🌐 Global Search - Bypasses geographic restrictions via BrowserAct
  3. 📈 Multi-Source - Aggregates data from multiple search results
  4. ✅ Validation - Cross-references information for accuracy
  5. 📋 Report Generation - Creates comprehensive research reports

Features

  1. No hallucinations, ensuring stable and accurate data extraction: Pre-set workflows eliminate AI-generated hallucinations.

  2. No human verification challenges: Built-in bypass mechanisms eliminate the need to handle reCAPTCHA or other verification challenges.

  3. No IP access restrictions or geofencing: Overcomes regional IP limitations for stable global access.

  4. Faster execution speed: Tasks complete more rapidly than purely AI-driven browser automation solutions.

  5. Exceptional cost-effectiveness: Significantly reduces data acquisition costs compared to token-intensive AI solutions.


🔧 BrowserAct API Integration

Research Request → BrowserAct Search → Data Extraction → Validation → Final Report

Powered by BrowserAct MCP for reliable, unrestricted web access.


⚠️ Error Handling

  • Invalid API Key: Report to user, do not retry
  • Search Failed: Automatic retry with fallback engine
  • No Results: Return partial data with notification
  • Timeout: Extended timeout for large research tasks

📖 Best Practices

  1. Use specific queries for targeted results
  2. Apply time filters for current information
  3. Cross-reference key findings
  4. Choose appropriate content types for research goals
  5. Validate statistics with multiple sources

🔗 Related Skills

  • amazon-competitor-analyzer - Amazon competitive intelligence
  • google-maps-search-api-skill - Business data extraction
  • google-news-api-skill - News monitoring

Version: 1.0.0
Updated: 2026-03-27
API: BrowserAct MCP

Comments

Markdown supported