Search Node

The Search node enables web search capabilities in your workflows using Google Custom Search. It's perfect for research, information gathering, competitive analysis, and real-time data lookup.

Configuration

Input Schema

Field	Type	Required	Default	Description
`query`	`string`	Yes	-	Search query (minimum 1 character)
`maxResults`	`number`	No	`5`	Maximum results to return (1-10)
`safeSearch`	`string`	No	`"off"`	Safe search setting: "off" or "strict"
`language`	`string`	No	`"en"`	Search language code
`region`	`string`	No	`"US"`	Search region code

Configuration Schema

Field	Type	Required	Description
`googleApiKey`	`string`	No	Custom Google API key
`googleSearchEngineId`	`string`	No	Custom Search Engine ID

Output Schema

Field	Type	Description
`results`	`array`	Array of search results
`totalResults`	`number`	Total number of results found (optional)
`searchTime`	`number`	Time taken for search in seconds (optional)
`query`	`string`	The search query that was executed

Result Object Schema

Field	Type	Description
`title`	`string`	Page title
`url`	`string`	Page URL
`snippet`	`string`	Page description snippet
`displayUrl`	`string`	Display URL (shortened format)

Basic Usage

Simple Search

- id: basic_search
  type: search
  input:
    query: "workflow automation best practices"
    maxResults: 5

Localized Search

- id: localized_search
  type: search
  input:
    query: "restaurant recommendations"
    maxResults: 10
    language: "fr"
    region: "FR"
    safeSearch: "strict"

Advanced Examples

- id: primary_research
  type: search
  input:
    query: "{{ research_topic }} 2024 trends"
    maxResults: 5

- id: competitive_analysis
  type: search
  input:
    query: "{{ company_name }} competitors analysis"
    maxResults: 3

- id: compile_research
  type: ai
  input:
    prompt: |
      Based on this research data:
      Primary: {{ primary_research.output.results }}
      Competitive: {{ competitive_analysis.output.results }}
      
      Create a comprehensive research summary.

Perfect for academic research, market analysis, and comprehensive topic investigation combining multiple search angles.

- id: find_sources
  type: search
  input:
    query: "{{ content_topic }} authoritative sources"
    maxResults: 8
    safeSearch: "strict"

- id: filter_quality_sources
  type: ai
  input:
    prompt: |
      From these search results:
      {{ find_sources.output.results }}
      
      Identify the 3 most authoritative and relevant sources.
      Return as JSON array with reasoning.

- id: extract_content
  type: crawler
  input:
    url: "{{ filtered_source.url }}"

Ideal for content creation workflows where quality sources are critical for credibility and accuracy.

- id: market_trends
  type: search
  input:
    query: "{{ industry }} market trends {{ current_year }}"
    maxResults: 6

- id: competitor_news
  type: search
  input:
    query: "{{ competitor_name }} news announcements"
    maxResults: 4

- id: analyze_intelligence
  type: ai
  input:
    prompt: |
      Analyze this market intelligence:
      Trends: {{ market_trends.output.results }}
      Competitor: {{ competitor_news.output.results }}
      
      Provide strategic insights and opportunities.

Essential for business intelligence, competitive analysis, and strategic planning based on current market data.

- id: current_events
  type: search
  input:
    query: "{{ topic }} latest news today"
    maxResults: 3

- id: fact_check
  type: search
  input:
    query: "{{ claim }} fact check verification"
    maxResults: 5
    safeSearch: "strict"

Critical for staying current with breaking news, verifying information, and ensuring content accuracy.

Search Optimization

Query Strategies

Specific Queries:

input:
  query: "TypeScript best practices 2024 enterprise applications"

Quoted Phrases:

input:
  query: '"API security" OR "REST API" vulnerability assessment'

Site-Specific Search:

input:
  query: "site:github.com TypeScript workflow automation"

Time-Sensitive Queries:

input:
  query: "{{ topic }} after:2024-01-01"

Configuration Options

Using Custom API Keys

- id: custom_search
  type: search
  input:
    query: "{{ search_term }}"
  configuration:
    googleApiKey: "{{ secrets.google_api_key }}"
    googleSearchEngineId: "{{ secrets.search_engine_id }}"

Safe Search Settings

# Strict filtering for family-friendly content
- id: safe_search
  type: search
  input:
    query: "{{ user_query }}"
    safeSearch: "strict"

Error Handling

- id: search_with_fallback
  type: search
  input:
    query: "{{ primary_query }}"
  configuration:
    errorHandling: "continue"

- id: check_results
  type: condition
  input:
    if: "{{ search_with_fallback.output.results.length > 0 }}"
    then: ["process_results"]
    else: ["try_alternative_search"]

- id: try_alternative_search
  type: search
  input:
    query: "{{ fallback_query }}"

Search Node

On this page