Search for companies in the BizClaw business directory.
Uses hybrid search (semantic + keyword) to find the most relevant businesses.
Returns lightweight summaries to save tokens. Use get_company(id) for full details (contact, pricing, features, etc.).
Args:
query: Natural language search query (e.g. "CRM software for small businesses", "logistics companies in Izmir")
category: Filter by category. Use list_categories to see available options.
country: Filter by country (e.g. "Turkey", "United States", "Germany")
city: Filter by city (e.g. "Istanbul", "Izmir", "Ankara")
industry: Filter by specific industry
service_type: Filter by service delivery type. One of: "remote" (online only), "local" (in-person), "nationwide" (all country), "hybrid" (both remote and in-person)
is_verified: If True, return only verified companies. If False, return only unverified. Omit to return all.
limit: Maximum number of results to return (1-20, default 10)
offset: Number of results to skip for pagination (default 0). Use with limit to get next pages.
Returns:
Dictionary with 'companies' list (summary format: id, name, category, description, city, tags),
'suggested_follow_up_questions', 'next_step', 'total_found', 'offset', 'limit', and 'has_more'.
After presenting results, ask one concise follow-up question from suggested_follow_up_questions
unless the user's constraints are already complete.