5.0 KiB
Connector Env Vars — when you're ready to upgrade the machine
v1 ships without paid connectors (LLM-native). Add these env vars in Railway → Variables to unlock each connector.
Google Custom Search API
Purpose: real-time web discovery of Saudi companies, press, job posts, partner pages.
| Env var | Where to get it | Notes |
|---|---|---|
GOOGLE_SEARCH_API_KEY |
https://console.cloud.google.com/apis/credentials → Create API key | Enable "Custom Search API" on the project first |
GOOGLE_SEARCH_CX |
https://programmablesearchengine.google.com → Create engine → copy the "cx" ID | Configure to search the entire web, enable "Image search" off |
Free tier: 100 queries/day. Paid: $5 per 1K queries after that (up to 10K/day).
Cost estimate for Dealix: with 5-10 queries per lead and 20 leads/day → 100–200 queries/day → mostly within free tier.
Technographics — Dealix native detector (FREE, no API key needed)
Purpose: detect which tools a target uses (HubSpot, Calendly, Shopify, Intercom, Meta Pixel, Moyasar, Salla, etc.) — the strongest intent signal.
Shipped: auto_client_acquisition/connectors/tech_detect.py — native detector that covers the ~45 tools that matter for Dealix (Saudi-tuned, B2B-focused).
Usage via API (public, no auth):
curl -X POST https://api.dealix.me/api/v1/prospect/enrich-tech \
-H "Content-Type: application/json" \
-d '{"domain":"foodics.com"}'
Usage via CLI:
python -m auto_client_acquisition.connectors.tech_detect foodics.com
Cost: 0 SAR · Lookup: ~2-5 seconds · API keys: none.
Categories covered
Booking (Calendly, HubSpot Meetings, Chili Piper, Cal.com) · CRM (HubSpot, Salesforce, Pipedrive, Zoho, ActiveCampaign, Marketo) · Payments MENA (Moyasar, Tap, PayTabs, HyperPay) + global (Stripe, PayPal, Checkout.com) · E-commerce MENA (Salla, Zid) + global (Shopify, WooCommerce, Magento, BigCommerce) · Chat (Intercom, Zendesk, Crisp, LiveChat, Tawk + WhatsApp Widget) · Analytics/Ads (GTM, GA4, Meta Pixel, TikTok Pixel, Snapchat Pixel, LinkedIn Insight, Hotjar, PostHog, Mixpanel, Segment, Google Ads) · Forms (Typeform, Jotform, HubSpot Forms, Formspree, Google Forms) · CMS (WordPress, Webflow, Wix, Next.js, Framer).
Why native over Wappalyzer
| Option | Cost | Coverage | Saudi focus | Dealix fit |
|---|---|---|---|---|
| Dealix native (shipped) | 0 | ~45 tools (the important ones) | ✅ Moyasar/Tap/Salla/Zid built-in | ✅ best |
| Wappalyzer hosted API | $100+/mo | 2500+ | ❌ no MENA specificity | overkill for v1 |
python-Wappalyzer (self-host) |
0 | 2000+ | ❌ generic rules | fine if want breadth |
webappanalyzer fork |
0 | 2000+ (2024 rules) | ❌ generic | fine if want breadth |
| BuiltWith API | $295+/mo | 70K+ | ❌ | enterprise only |
For Dealix v1: native is enough. Add python-Wappalyzer as a fallback later if broader coverage becomes important.
When to upgrade to hosted Wappalyzer
Only if:
- Crossing 500 lookups/day (native is CPU-cheap but hosted parallelizes better)
- Need technographics on domains the native misses (e.g. obscure eastern-European CRMs)
- Clients require a "third-party-verified" data provenance
Until then: native.
Apollo API
Purpose: find decision-makers by role + seniority + geography. Optional enrichment (email, phone) within plan.
| Env var | Where to get it |
|---|---|
APOLLO_API_KEY |
Apollo.io → Settings → API |
Pricing: Free tier limited; paid plans from $49/user/mo.
Dealix pattern: use People Search only (no email reveals) unless explicitly needed; stay within plan.
Moyasar (already wired)
| Env var | Status |
|---|---|
MOYASAR_SECRET_KEY |
⚠️ Sami to re-verify after KYC activation — see MOYASAR_HOSTED_CHECKOUT.md |
MOYASAR_WEBHOOK_SECRET |
✅ Set in Railway |
Optional: Saudi-specific sources
CR (Commercial Registration) lookup
Public SP portal: https://www.mc.gov.sa/ar/eservices/Pages/ShowServiceDetails.aspx — manual lookup only (no public API). Use for validation, not bulk.
Monsha'at / SME Authority
https://www.monshaat.gov.sa — public lists of SMEs that joined programs. Manual discovery.
GOSI (public-sector contractor list)
Public contractor directory. Only use for B2G pathway.
Wamda / MAGNiTT press
https://www.wamda.com , https://magnitt.com — public press and startup pages. Use site: queries via Google Custom Search.
Setup order recommendation
- First week: v1 LLM-native (no connectors) — validate product-market fit
- After 5 paying customers: add
GOOGLE_SEARCH_API_KEY+GOOGLE_SEARCH_CX(free tier covers you) - After 10 customers: add
WAPPALYZER_API_KEY($100/mo pays back with better targeting) - After 20 customers or partner launch: add
APOLLO_API_KEY(when volume justifies)
Do not pay for connectors until v1 proves value.