firmadb_search_companies

com.firmadb/company-data · Verify this server

Search FirmaDB's European company index by name, registry identifier, or address fragment. Use this when you DON'T have a registry_id but you have a name, address, NACE code, or industry term. Returns ranked candidates with confidence scores and matched_fields. Use BEFORE firmadb_get_company when the user gave you a name like "Acme Holdings" rather than a registry number. Top result is usually correct for distinctive names; for common names ("ABC Trading") inspect scores and addresses to disambiguate. Filter by country when known — searches without a country filter scan all 19 partitions, are slower, and return max 10 results. Cross-country structured filters (NACE, employee_count) are not supported and return an error with the precise workaround. Returns a JSON list: `data[]` of company objects each with a `match` block (score 0..1, matched_fields, explanation), plus total_count, has_more, next_cursor.