sindico-leads

Call the Tavily search API with targeted queries, then parse the returned titles, snippets, and raw content with regex patterns to extract phone numbers and WhatsApp contacts. The run function accepts a source, city, and max_results parameter.

Use a regex that matches keywords like whatsapp, wpp, or zap followed by a Brazilian phone pattern with area code and optional ninth digit. Deduplicate matches and normalize digits into the (XX) 9XXXX-XXXX format.

The Skill follows a cheap-first strategy: it tries the MCP mcp-leads server first, then falls back to direct Tavily web_search queries, and only uses a browser for JavaScript-heavy or login-protected sites.

No. The fetch script raises a RuntimeError if the TAVILY_API_KEY environment variable is not configured, since the Tavily search API is required to retrieve result pages for contact extraction.

Leads are matched by name plus at least one of email or phone. New matches trigger add_contact, existing leads with new fields trigger update_contact, and conflicting phone or email values are recorded as CRM notes.

The Skill is designed to return only aggregate counts such as new, updated, and divergent leads. This avoids exposing personally identifiable information like phone numbers and emails in chat responses.