Trulia Search

Search real estate properties on Trulia by location, price, bedrooms, and property type.

Installation

npm install @framers/agentos-ext-trulia-search

Usage

import { createExtensionPack } from '@framers/agentos-ext-trulia-search';

const pack = createExtensionPack({
  config: {
    truliaRapidApiKey: process.env.TRULIA_RAPIDAPI_KEY,
    firecrawlApiKey: process.env.FIRECRAWL_API_KEY, // fallback
  },
});

Tool: trulia_search

Parameter	Type	Required	Description
location	string	Yes	City, state or zip code (e.g., "Austin, TX")
propertyType	string	No	house, apartment, condo, townhouse, land
minPrice	number	No	Minimum price filter
maxPrice	number	No	Maximum price filter
bedrooms	number	No	Minimum bedrooms
bathrooms	number	No	Minimum bathrooms
maxResults	number	No	Maximum results (default: 20)

Example

User: "Find 3-bedroom houses in Austin under $400k"
Tool call: trulia_search({
  location: "Austin, TX",
  propertyType: "house",
  bedrooms: 3,
  maxPrice: 400000
})

Data Sources

1. RapidAPI Trulia (preferred) — structured property data via TRULIA_RAPIDAPI_KEY
2. Firecrawl scrape (fallback) — scrapes trulia.com search results when no RapidAPI key is available. Requires FIRECRAWL_API_KEY.

Environment Variables

Variable	Required	Description
TRULIA_RAPIDAPI_KEY	No	RapidAPI key for structured Trulia data
FIRECRAWL_API_KEY	No	Firecrawl key for scrape fallback

At least one key is needed for results. Without either, the tool returns empty listings.

License

MIT