plugin.json

{
  "version": 2,
  "uuid": "brightdata-web-fetcher",
  "id": "brightdata-web-fetcher", 
  "title": "BrightData Web Fetcher",
  "emoji": "🌐",
  "iconURL": "",
  "description": "Search Google web results or fetch web content. Two simple actions: 'search' for finding information (supports multiple queries), 'fetch' for opening URLs (supports multiple URLs). Let AI decide when to search vs fetch.",
  "userSettings": [
    {
      "name": "serpApiKey",
      "label": "BrightData SERP API Key",
      "description": "Your BrightData API key for Google search requests.",
      "type": "password",
      "required": true
    },
    {
      "name": "serpZone", 
      "label": "SERP Zone ID",
      "description": "BrightData zone identifier for SERP API requests. Leave default unless using a custom zone.",
      "defaultValue": "serp_api1_web_search",
      "required": false
    },
    {
      "name": "unlockerApiKey",
      "label": "BrightData Web Unlocker API Key", 
      "description": "Your BrightData API key for bypassing website protections when fetching webpages.",
      "type": "password",
      "required": true
    },
    {
      "name": "unlockerZone",
      "label": "Web Unlocker Zone ID",
      "description": "BrightData zone identifier for Web Unlocker API requests. Leave default unless using a custom zone.", 
      "defaultValue": "web_unlocker1",
      "required": false
    },
    {
      "name": "openaiApiKey",
      "label": "OpenAI API Key",
      "description": "Your OpenAI API key for content extraction and analysis.",
      "type": "password",
      "required": true
    },
    {
      "name": "openaiModel",
      "label": "OpenAI Model",
      "description": "OpenAI model for content analysis.",
      "type": "enum", 
      "values": [
        "gpt-4.1",
        "o4-mini",
        "gpt-4.1-mini", 
        "gpt-4.1-nano"
      ],
      "defaultValue": "gpt-4.1-mini",
      "required": false
    }
  ],
  "openaiSpec": {
    "name": "brightdata_web_fetcher",
    "description": "Search Google web results or fetch web content. Two actions: 'search' for finding information (returns headlines/links), 'fetch' for reading content from URLs. Strategy: search first to find relevant URLs, then fetch specific URLs to read full content. Both actions support multiple parallel requests.",
    "parameters": {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "enum": [
            "search", 
            "fetch"
          ],
          "description": "'search': Find information on Google web search (supports multiple queries in parallel). 'fetch': Read content from URLs (supports multiple URLs in parallel)."
        },
        "query": {
          "type": ["string", "array"], 
          "items": {
            "type": "string"
          },
          "maxItems": 5,
          "description": "For search action: Single search query or array of up to 5 different search queries to execute in parallel."
        },
        "url": {
          "type": ["string", "array"],
          "items": {
            "type": "string" 
          },
          "description": "For fetch action: Single URL or array of URLs to fetch content from in parallel."
        },
        "gl": {
          "type": "string",
          "enum": ["af","al","dz","as","ad","ao","ai","aq","ag","ar","am","aw","au","at","az","bs","bh","bd","bb","by","be","bz","bj","bm","bt","bo","ba","bw","bv","br","io","bn","bg","bf","bi","kh","cm","ca","cv","ky","cf","td","cl","cn","cx","cc","co","km","cg","cd","ck","cr","ci","hr","cu","cy","cz","dk","dj","dm","do","ec","eg","sv","gq","er","ee","et","fk","fo","fj","fi","fr","gf","pf","tf","ga","gm","ge","de","gh","gi","gr","gl","gd","gp","gu","gt","gn","gw","gy","ht","hm","va","hn","hk","hu","is","in","id","ir","iq","ie","il","it","jm","jp","jo","kz","ke","ki","kp","kr","kw","kg","la","lv","lb","ls","lr","ly","li","lt","lu","mo","mk","mg","mw","my","mv","ml","mt","mh","mq","mr","mu","yt","mx","fm","md","mc","mn","ms","ma","mz","mm","na","nr","np","nl","nc","nz","ni","ne","ng","nu","nf","mp","no","om","pk","pw","ps","pa","pg","py","pe","ph","pn","pl","pt","pr","qa","re","ro","ru","rw","sh","kn","lc","pm","vc","ws","sm","st","sa","sn","rs","sc","sl","sg","sk","si","sb","so","za","gs","es","lk","sd","sr","sj","sz","se","ch","sy","tw","tj","tz","th","tl","tg","tk","to","tt","tn","tr","tm","tc","tv","ug","ua","ae","uk","gb","us","um","uy","uz","vu","ve","vn","vg","vi","wf","eh","ye","zm","zw","gg","je","im","me"],
          "description": "Country targeting for search. Examples: 'us' (United States), 'jp' (Japan), 'de' (Germany), 'fr' (France), 'uk' (United Kingdom). Defaults to 'us'."
        },
        "num": {
          "type": "integer",
          "enum": [10, 20, 30, 40, 50, 60, 70, 80, 90, 100],
          "description": "Number of search results to return. Must be between 10-100 in steps of 10. Defaults to 10."
        },
        "tbs": {
          "type": "string",
          "enum": ["qdr:h", "qdr:d", "qdr:w", "qdr:m", "qdr:y"],
          "description": "Time-based search filter. 'qdr:h' (past hour), 'qdr:d' (past 24 hours), 'qdr:w' (past week), 'qdr:m' (past month), 'qdr:y' (past year). Use for recent/current events."
        }
      },
      "required": [
        "action"
      ]
    }
  },
  "implementationType": "javascript",
  "implementation": "implementation.js"
}