🔍 AI-Powered Web Research in Google Sheets with Bright Data

📋 Overview

Transform any Google Sheets cell into an intelligent web scraper! Type =BRIGHTDATA("cell", "search prompt") and get AI-filtered result from every website in ~20 seconds.

What happens automatically:

• AI optimizes your search query
• Bright Data scrapes the web (bypasses bot detection)
• AI analyzes and filters result
• Returns clean data directly to your cell
• Completes in <25 seconds

Cost: ~$0.02-0.05 per search | Time saved: 3-5 minutes per search

---

👥 Who's it for

• Market researchers needing competitive intelligence
• E-commerce teams tracking prices
• Sales teams doing lead prospecting
• SEO specialists gathering content research
• Real estate agents monitoring listings
• Anyone tired of manual copy-paste

---

⚙️ How it works

1. Webhook Call - Google Sheets function sends POST request
2. Data Preparation - Organizes input structure
3. AI Query Optimization - GPT-4.1 Mini refines search query
4. Web Scraping - Bright Data fetches data while bypassing blocks
5. AI Analysis - GPT-4o Mini filters and summarizes result
6. Response - Returns plain text to your cell
7. Logging - Updates logs for monitoring

---

🛠️ Setup Instructions

Time to deploy: 20 minutes

Requirements

• n8n instance with public URL
• Bright Data account + API key
• OpenAI API key
• Google account for Apps Script

Part 1: n8n Workflow Setup

1. Import this template into your n8n instance
2. Configure Webhook node:
   • Copy your webhook URL: https://n8n.yourdomain.com/webhook/brightdata-search
   • Set authentication: Header Auth
   • Set API key: 12312346 (or create your own)
3. Add OpenAI credentials to AI nodes.
4. Configure Bright Data: Add API credentials
5. Configure Output Language: Manually edit the "Set Variables" Node.
6. Test workflow with manual execution
7. Activate the workflow

Part 2: Google Sheets Function

1. Open Google Sheet → Extensions → Apps Script
2. Paste this code:

function BRIGHTDATA(prompt, source) {
  if (!prompt || prompt === "") {
    return "❌ Must enter prompt";
  }
 
  source = source || "google";
 
  // Update with YOUR webhook URL
  const N8N_WEBHOOK_URL = "https://your-n8n-domain.com/webhook/brightdata-search";
  
  // Update with YOUR password
  const API_KEY = "12312346";
 
  let spreadsheetId, sheetName, cellAddress;
 
  try {
    const sheet = SpreadsheetApp.getActiveSheet();
    const activeCell = sheet.getActiveCell();
    spreadsheetId = SpreadsheetApp.getActiveSpreadsheet().getId();
    sheetName = sheet.getName();
    cellAddress = activeCell.getA1Notation();
  } catch (e) {
    return "❌ Cannot identify cell";
  }
 
  const payload = {
    prompt: prompt,
    source: source.toLowerCase(),
    context: {
      spreadsheetId: spreadsheetId,
      sheetName: sheetName,
      cellAddress: cellAddress,
      timestamp: new Date().toISOString()
    }
  };
 
  const options = {
    method: "post",
    contentType: "application/json",
    payload: JSON.stringify(payload),
    muteHttpExceptions: true,
    headers: {
      "Accept": "text/plain",
      "key": API_KEY
    }
  };
 
  try {
    const response = UrlFetchApp.fetch(N8N_WEBHOOK_URL, options);
    const responseCode = response.getResponseCode();
   
    if (responseCode !== 200) {
      Logger.log("Error response: " + response.getContentText());
      return "❌ Error " + responseCode;
    }
   
    return response.getContentText();
   
  } catch (error) {
    Logger.log("Exception: " + error.toString());
    return "❌ Connection error: " + error.toString();
  }
}

function doGet(e) {
  return ContentService.createTextOutput(JSON.stringify({
    status: "alive",
    message: "Apps Script is running",
    timestamp: new Date().toISOString()
  })).setMimeType(ContentService.MimeType.JSON);
}

3. Update N8N_WEBHOOK_URL with your webhook
4. Update API_KEY with your password
5. Save (Ctrl+S / Cmd+S) - Important!
6. Close Apps Script editor

---

💡 Usage Examples

=BRIGHTDATA("C3", "What is the current price of the product?")
=BRIGHTDATA("D30", "What is the size of this company?")
=BRIGHTDATA("A4", "Do this comapny is hiring Developers?")

---

🎨 Customization

Easy Tweaks

• AI Models - Switch to GPT-4o for better optimization
• Response Format - Modify prompt for specific outputs
• Speed - Optimize AI prompts to reduce time
• Language - Change prompts for any language

Advanced Options

• Implement rate limiting
• Add data validation
• Create async mode for long queries
• Add Slack notifications

---

🚀 Pro Tips

• Be Specific - "What is iPhone 15 Pro 256GB US price?" beats "What is iPhone price?"
• Speed Matters - Keep prompts concise (30s timeout limit)
• Monitor Costs - Track Bright Data usage
• Debug - Check workflow logs for errors

---

⚠️ Important Notes

• Timeout: 30-second Google Sheets limit (aim for <20s)
• Plain Text Only: No JSON responses
• Costs: Monitor Bright Data at console.brightdata.com
• Security: Keep API keys secret
• No Browser Storage: Don't use localStorage/sessionStorage

---

🔧 Troubleshooting

| Error | Solution | |-------|----------| | "Exceeded maximum execution time" | Optimize AI prompts or use async mode | | "Could not fetch data" | Verify Bright Data credentials | | Empty cell | Check n8n logs for AI parsing issues | | Broken characters | Verify UTF-8 encoding in webhook node |

---

📚 Resources

• Bright Data API Docs
• n8n Webhook Documentation
• Google Apps Script Reference

---

Built with ❤️ by Elay Guez