Companies: Advanced search (LLM + multi-source)

action_company_search · action · Utility · Available · v1.0.0

Description

Find URLs of REAL companies (not directories or blogs) for B2B cold outreach. Pipeline: LLM query expansion → multi-source search (Exa/Tavily/Brave/DDG) → anti-directory blocklist → HEAD validation → dedup. Output: array of {url, domain, title, boost_factors}. LLM-agnostic: works with Liara, Anthropic, OpenAI, Gemini.

⚙️ Configuration parameters

Fields shown in the editor when configuring the node. Generated directly from the NodeDefconfigFields.

Field	Type	Required	Default	Description
`seedPrompt` Cosa cercare (prompt seed)	`string`	yes	— yacht builder Italia, cantieri navali produttori	Descrizione di cosa cercare. L'LLM lo espanderà in N query DDG variate. PIÙ SPECIFICO = MIGLIORI RISULTATI: ✓ "cantieri navali yacht Italia produttori barche da diporto" ✗ "barche" (troppo generico) Suggerimenti: includi vertical + paese + ICP (es. "studi notarili Milano patrimonio", "officine meccaniche Brescia CNC").
`maxResults` Numero massimo aziende	`number`	no	`20`	Hard cap di company URL ritornati DOPO tutti i filtri. • 5 = test rapido (~5s) • 20 = default bilanciato (~15s, 1 campagna ridotta) • 50 = ampio (~30s, 1 campagna completa) • 100 = max raccomandato (~60s, costo Tavily/Exa più alto)
`queryExpansionCount` Query LLM-generate	`number`	no	`5`	Quante query variate l'LLM deve generare DA PARTIRE dal seed. • 0 = disabilita LLM (usa solo seed). Risparmia 1 token call ma minor copertura. • 3 = stretto, focus stretto sul vertical • 5 = default bilanciato (~50 risultati raw) • 10 = ampio, esplora più angoli (esempi: cantieri + officine + costruttori)
`resultsPerQuery` Risultati per query	`number`	no	`10`	Quanti risultati prendere da ogni search engine per ogni query. • 5 = veloce, top-tier • 10 = default (coverage decente) • 20 = max (più chance di trovare aziende non-top-ranked) Costo: lineare con questo valore × query_count × provider_costs.
`country` Codice paese ISO (TLD preference)	`string`	no	— it, de, fr, es, uk, ...	ISO country code. Aziende con dominio .{country} ricevono boost di ranking. L'LLM include automaticamente "site:.{country}" in alcune query. Esempi: "it" per Italia, "de" per Germania, "fr" per Francia. Lascia vuoto per discovery global.
`extraBlocklist` Domini da escludere (CSV)	`string`	no	— concorrente1.com, partner.it, marketplace-x.com	Domini da escludere AGGIUNTIVI rispetto alla blocklist default (60+ directory già esclusi: yachtall, yachtworld, inautia, linkedin, facebook, amazon, ebay, ecc.). CSV. Use case: escludere concorrenti diretti, partner già contattati, marketplace specifici.
`requireKeyword` Keyword OBBLIGATORIA nella homepage (avanzato)	`string`	no	— yacht, marine, naval	Se settato, dopo il search il nodo fetch-a la homepage di ogni candidate e verifica la presenza del keyword (case-insensitive) in <title>/<meta>/<h1>. Se assente, l'URL viene scartato. AGGRESSIVO: scarta ~30-50% candidate, ma garantisce focus stretto sul vertical. Use case: vuoi SOLO siti che parlano del tuo target (no false positivi da search engine).
`skipLLMExpansion` Salta LLM (usa solo seed query)	`boolean`	no	`false`	Se ON, NON chiama LLM per espandere il seed. Usa SOLO la query così com'è. Vantaggi: gratuito (0 token), più veloce (-2s), deterministico. Svantaggi: minor copertura, no variazione linguistica (italiano vs inglese). Use case: test rapidi, quando seedPrompt è già SuperOttimizzato.
`validateTimeoutMs` Timeout HEAD validation (ms)	`number`	no	`5000`	HEAD request per filtrare siti morti. Accetta 200/405. • 0 = disabilita validation (più veloce, meno qualità) • 3000 = stretto (solo siti rapidissimi) • 5000 = default bilanciato • 10000 = tollerante (server lenti accettati)

⬆️ Node output

Fields available to downstream nodes via $node.<alias>.json.<field>:

companies
urls
queries_used
queries_generated_by_llm
llm_provider
total_raw_results
filtered_directory
filtered_validation
took_ms
count

💡 Configuration example

JSON snippet of the node as it appears in the workflow. Values are derived fromdefaultValue and from required parameters.

{
  "id": "node-action_company_search-1",
  "defId": "action_company_search",
  "label": "Companies: Advanced search (LLM + multi-source)",
  "config": {
    "seedPrompt": "yacht builder Italia, cantieri navali produttori",
    "maxResults": 20,
    "queryExpansionCount": 5,
    "resultsPerQuery": 10,
    "skipLLMExpansion": false,
    "validateTimeoutMs": 5000
  }
}

🔗 Related nodes in the same category

Ready to use Companies: Advanced search (LLM + multi-source)?

Available now on all FlowForge plans. Try it free without a credit card.

Start free Browse all nodes