Discover Competitors

async def discover_competitors(
    business_url: str,
    business_name: str,
    entity_id: str,
    max_competitors: int = 10
) -> dict

{
  "status": "success",
  "count": 8,
  "competitors": [
    {
      "name": "Competitor A",
      "url": "https://competitor-a.com",
      "description": "A leading provider of..."
    },
    {
      "name": "Competitor B", 
      "url": "https://competitor-b.com",
      "description": "Enterprise solution for..."
    }
  ]
}

CREATE TABLE competitors (
  id UUID PRIMARY KEY,
  entity_id UUID REFERENCES entities(id),
  name TEXT NOT NULL,
  url TEXT NOT NULL,
  description TEXT,
  favicon_url TEXT,
  source TEXT DEFAULT 'firecrawl_agent',
  created_at TIMESTAMPTZ DEFAULT NOW()
);

GROUP 1a (Business Info) ████████████████████████████████████
GROUP 1b (Scrape)        ████████████████████████████████████
GROUP 1c (Competitors)   ████████████████████████████████████  ← Parallel, non-blocking
GROUP 1d (Products)      ████████████████████████████████████  ← Parallel, non-blocking
GROUP 2                  ─────────────────────────████████████  ← Starts when 1a+1b+1d complete

src/app/apis/onboarding/services/discover_competitors/
├── __init__.py
├── service.py              # Main discover_competitors function
└── children/
    ├── favicon_handler.py  # Fetches competitor favicons
    └── firecrawl_agent.py  # Firecrawl Agent API wrapper

{
  "status": "error",
  "error": "Firecrawl Agent API timeout"
}