Boricua Connection: Real Estate Capital & Deal Matcher

The only Apify Actor that bridges U.S. capital with Puerto Rico real estate deals — powered by AI matching, live scraping, and Ley 60 tax analysis.

---

🏠 What Does This Actor Do?

Boricua Connection is a dual-mode intelligent platform for the Puerto Rico real estate market:

• DEAL_SCRAPER mode: Automatically extracts active real estate listings from PR portals (ClasificadosOnline, Redfin, Zillow PR), enriches them with AI-powered analysis (repair cost estimates, ROI projections, Ley 60 viability), and stores structured opportunities ready for matching.

• MATCH_ENGINE mode: Takes a list of investors with capital and a list of properties/contracts, then uses OpenAI (GPT-4o-mini) to generate optimal pairings — complete with Joint Venture structures, Hard Money loan proposals, or wholesale assignment strategies and a Match Confidence score (0–100%).

Whether you are a wholesaler with contracts but no funding, a U.S. investor seeking Ley 60 tax benefits in Puerto Rico, or a data researcher mapping the PR real estate market — this Actor is your unfair advantage.

---

👥 Who Is This For?

🔑 Persona 1 — Finders & Wholesalers (Puerto Rico)

You have a property under contract or a hot off-market deal, but need a capital partner fast. Feed your deal into MATCH_ENGINE and get a ranked list of compatible investors with a suggested deal structure in seconds.

💼 Persona 2 — Real Estate Investors Seeking Ley 60 (U.S. Mainland)

You want to deploy capital in Puerto Rico and benefit from Act 60 tax incentives (0–4% capital gains tax). Use DEAL_SCRAPER to discover current opportunities filtered by ROI threshold, deal type (Fix & Flip, JV, Hard Money), and location — with Ley 60 viability flagged automatically.

📊 Persona 3 — Data Researchers & PropTech Teams

You need structured, enriched Puerto Rico real estate data at scale. Run DEAL_SCRAPER on a schedule to build a dataset of market listings with AI-generated market value estimates, repair costs, deal types, and ROI ranges.

---

⚙️ Input Parameters

Parameter	Type	Description	Default
mode	Select	DEAL_SCRAPER or MATCH_ENGINE	Required
openaiApiKey	String (secret)	Your OpenAI API key	Required
dealType	Select	JV / Hard Money / Wholesale / Fix&Flip	JV
minROI	Integer	Minimum ROI % to include a deal	12
targetLocations	Array	PR/US cities to target	["San Juan", "Condado", "Dorado", "Rincón", "Orlando", "Miami"]
maxItems	Integer	Max results to return	50
proxyConfiguration	Proxy	Apify proxy settings	useApifyProxy: true
investors	Array	Investor profiles (MATCH_ENGINE only)	[]
properties	Array	Property/contract objects (MATCH_ENGINE only)	[]

---

📦 Example Output

DEAL_SCRAPER Output

{
  "dealId": "pr-deal-00142",
  "propertyAddress": "Calle Loíza 214, Santurce, PR 00911",
  "listPrice": 185000,
  "estimatedMarketValue": 220000,
  "repairCostEstimate": 28000,
  "estimatedROI": "18.5%",
  "dealType": "Fix & Flip",
  "ley60Viable": true,
  "targetInvestorType": "U.S. Mainland Investor — Act 60",
  "suggestedStrategy": "Acquire, renovate, and sell within 18 months for capital gain exempt under Act 60",
  "matchConfidence": 87,
  "sourceUrl": "https://clasificadosonline.com/listing/00142",
  "scrapedAt": "2025-01-15T14:30:00Z"
}

MATCH_ENGINE Output

{
  "dealId": "match-0023",
  "propertyAddress": "Urb. Dorado Beach Este, Dorado, PR 00646",
  "investorTypeTarget": "Hard Money Lender — Short Term",
  "suggestedStrategy": "Bridge loan at 10% interest, 12-month term, secured by first-position lien",
  "estimatedROI": "22%",
  "matchConfidence": "91%",
  "legalStructureProposal": "Hard Money Loan Agreement with Option to Convert to JV if ARV exceeds $480,000",
  "investorId": "inv-007",
  "matchedAt": "2025-01-15T15:00:00Z"
}

---

💰 Pricing & Cost Estimate

This Actor uses Pay-per-event monetization:

Event	Cost
Actor start	$0.20 per run
Per result stored	$0.005 (i.e., $5.00 per 1,000 results)

Example: Scraping 100 properties with AI enrichment ≈ $0.70 total (start fee + 100 results).

Running MATCH_ENGINE on 50 investor–property pairs ≈ $0.45 total.

Note: OpenAI API costs are separate and billed directly to your OpenAI account. GPT-4o-mini processes batches of 15 items, making it highly cost-efficient (~$0.002 per batch).

---

🔗 Webhook Integrations (Make / Zapier → Telegram / WhatsApp)

Use Case: Instant Deal Alerts to Telegram

1. Run Actor on a daily schedule in DEAL_SCRAPER mode
2. Set up a webhook in Apify to POST results to Make.com or Zapier
3. Configure the automation to filter results where matchConfidence > 80
4. Send a formatted Telegram message with deal address, ROI, and Ley 60 flag

Sample Make.com Scenario:

[Apify Webhook] → [Filter: matchConfidence > 80] → [Telegram Bot: Send Message]

Use Case: WhatsApp Deal Digest (via Twilio)

[Apify Schedule — Daily 8AM] → [Webhook POST to Zapier] → [Twilio WhatsApp: Daily digest of top 5 deals]

---

🛡️ Technical Features

• Hybrid Scraping: Axios for fast API calls + PlaywrightCrawler for JS-heavy portals with anti-bot protection
• AI Batch Processing: Processes up to 15 items per OpenAI call to avoid token limit errors
• Apify Proxy Integration: Built-in residential proxy support to bypass geo-restrictions
• TypeScript / ESM: Fully typed, production-grade code with strict TypeScript
• Ley 60 Analysis: Automatically flags properties eligible for Puerto Rico Act 60 tax incentives
• Structured Output: All results stored in Apify Dataset, ready for export to CSV/JSON/Excel

---

🚀 Quick Start

1. Get an OpenAI API key at platform.openai.com
2. Select your mode: DEAL_SCRAPER to find deals, MATCH_ENGINE to match investors
3. Set your target locations (default: San Juan, Condado, Dorado, Rincón, Orlando, Miami)
4. Run the Actor — results appear in your Apify Dataset within minutes
5. Export or webhook results to your CRM, spreadsheet, or messaging app

---

📋 Frequently Asked Questions

Q: Do I need an OpenAI API key? Yes. The Actor uses GPT-4o-mini for deal analysis and investor matching. You need your own OpenAI key (very low cost — typically under $0.05 per run).

Q: What sites does DEAL_SCRAPER target? Primarily ClasificadosOnline.com (PR's #1 classifieds), Redfin PR listings, and Zillow Puerto Rico. The hybrid scraper adapts to both static and JavaScript-rendered pages.

Q: Can I use this for other Caribbean markets? Currently optimized for Puerto Rico. The targetLocations field supports custom inputs, and U.S. mainland cities (Orlando, Miami) are included for diaspora investor matching.

Q: What is Ley 60 / Act 60? Puerto Rico's Act 60 (formerly Acts 20 and 22) offers U.S. residents who relocate to PR a 0–4% capital gains tax rate. This Actor automatically flags properties where this incentive is most relevant.

---

🤝 Support & Custom Development

For custom integrations, bulk licensing, or white-label versions for real estate brokerages, contact us through the Apify platform.

---

Built with ❤️ for the Puerto Rico real estate community — connecting island deals with mainland capital.