Bring Solar Forecasting
to Pydantic AI

Use when you know your system's exact configuration for maximum forecast accuracy. USE WHEN: - User knows exact panel tilt and azimuth angles - User needs highly accurate forecasts for a specific system - User has detailed PV system specifications - User asks for precise solar output estimates PARAMETERS: - latitude (REQUIRED): Location latitude - longitude (REQUIRED): Location longitude - capacity (REQUIRED): System capacity in kW - tilt (REQUIRED): Panel tilt angle in degrees - azimuth (REQUIRED): Panel azimuth in degrees - loss_factor (OPTIONAL): System loss factor (0-1, default: 0.9) EXAMPLES: - "Detailed forecast for 6kW system, tilt 30°, azimuth 0° (north facing)" → call with latitude, longitude, capacity=6, tilt=30, azimuth=0 - "Precise PV estimate for my 8kW array at 25° tilt, 180° azimuth (south)" → call with capacity=8, tilt=25, azimuth=180 Get detailed PV power forecast with full system specifications

Requires Pro/Enterprise plan for full historical access. USE WHEN: - User asks about historical solar radiation data - User needs past solar irradiance values for analysis - User wants to validate solar models with historical data - User asks "what was the solar irradiance last week" PARAMETERS: - latitude (REQUIRED): Location latitude - longitude (REQUIRED): Location longitude - start (REQUIRED): Start date/time (ISO 8601 format) - end (OPTIONAL): End date/time (ISO 8601 format) EXAMPLES: - "Historical solar radiation for Sydney last week" → call with latitude=-33.87, longitude=151.21, start="2026-03-31" - "GHI data for my location for March 2026" → call with latitude, longitude, start="2026-03-01", end="2026-03-31" Get historical solar irradiance data for a location

Forecasts are derived from satellite cloud tracking and irradiance data. USE WHEN: - User asks about solar power generation forecasts - User needs PV output estimates for a specific location - User wants to know expected solar energy production - User asks "how much solar power will my panels generate" PARAMETERS: - latitude (REQUIRED): Location latitude (-90 to 90) - longitude (REQUIRED): Location longitude (-180 to 180) - capacity (REQUIRED): System capacity in kW (DC rating) - tilt (OPTIONAL): Panel tilt angle in degrees (0=flat, 90=vertical) - azimuth (OPTIONAL): Panel azimuth in degrees (0=north, 180=south) - hours (OPTIONAL): Number of hours to forecast (default: 48, max: 336 for 14 days) EXAMPLES: - "Solar forecast for my 5kW system in Sydney -33.87, 151.21" → call with latitude=-33.87, longitude=151.21, capacity=5 - "PV forecast for 10kW rooftop in LA 34.05, -118.24" → call with latitude=34.05, longitude=-118.24, capacity=10 - "How much solar will my 3kW system generate tomorrow?" → call with latitude, longitude, capacity=3, hours=24 Get rooftop PV power forecasts for a location

Essential for solar resource assessment. USE WHEN: - User asks about solar irradiance or solar radiation - User needs GHI, DNI, or DHI data for solar analysis - User is evaluating solar potential for a location - User asks "how much sunlight will there be" PARAMETERS: - latitude (REQUIRED): Location latitude - longitude (REQUIRED): Location longitude - hours (OPTIONAL): Number of hours to forecast (default: 48) EXAMPLES: - "Solar irradiance forecast for Sydney -33.87, 151.21" → call with latitude=-33.87, longitude=151.21 - "GHI and DNI forecast for my location 34.05, -118.24" → call with latitude=34.05, longitude=-118.24 - "How much solar radiation tomorrow?" → call with latitude, longitude, hours=24 Get solar irradiance forecasts (GHI, DNI, DHI) for a location

The API auto-estimates tilt and azimuth for reasonable default values. Perfect for quick estimates. USE WHEN: - User wants a quick solar estimate without exact system details - User doesn't know their panel tilt or azimuth - User needs a fast solar output estimate - User asks "roughly how much solar will I generate" PARAMETERS: - latitude (REQUIRED): Location latitude - longitude (REQUIRED): Location longitude - capacity (REQUIRED): System capacity in kW EXAMPLES: - "Quick solar estimate for -33.87, 151.21 with 5kW" → call with latitude=-33.87, longitude=151.21, capacity=5 - "Rough estimate for my 3kW system in LA" → call with latitude=34.05, longitude=-118.24, capacity=3 - "How much solar for a 10kW system here?" → call with latitude, longitude, capacity=10 Get quick PV power forecast with minimal parameters

Shows what your system likely produced recently. USE WHEN: - User wants to know what their solar system actually generated - User needs recent production estimates vs forecasts - User is analyzing system performance - User asks "how much did my solar panels actually produce" PARAMETERS: - site_id (REQUIRED): The site ID from your Solcast account - hours (OPTIONAL): Number of hours of historical data (default: 24) EXAMPLES: - "Estimated actuals for site abc-123 last 24 hours" → call with site_id="abc-123" - "What did my system produce yesterday?" → call with site_id="abc-123", hours=48 - "Recent solar production for my site" → call with site_id="your-site-id" Get estimated actual PV power output for a registered rooftop site

Uses the site's configured parameters (capacity, tilt, azimuth) for accurate forecasts. USE WHEN: - User asks about forecasts for a specific registered site - User has a site ID and wants forecasts for that system - User needs predictions for a known rooftop installation - User asks "what will my registered solar site generate" PARAMETERS: - site_id (REQUIRED): The site ID from your Solcast account EXAMPLES: - "Forecast for site abc-123" → call with site_id="abc-123" - "What will my registered system def-456 generate?" → call with site_id="def-456" - "Solar forecast for my home system" → call with site_id="your-site-id" Get PV power forecasts for a specific registered rooftop site

Requires the site to have real measurement integration. Shows exact production data. USE WHEN: - User has telemetry-enabled sites with real measurements - User needs exact measured production data (not estimates) - User is validating forecast accuracy - User asks "what was the exact measured output from my system" PARAMETERS: - site_id (REQUIRED): The site ID with telemetry enabled - hours (OPTIONAL): Number of hours of historical data EXAMPLES: - "Measured actuals for telemetry site xyz-789" → call with site_id="xyz-789" - "Exact production from my monitored system" → call with site_id="your-telemetry-site-id" - "Real production data last week" → call with site_id="xyz-789", hours=168 Get measured PV power output from a registered rooftop site with telemetry

Provides a complete picture of solar resources. USE WHEN: - User wants a complete solar overview for a location - User needs both irradiance and PV forecasts together - User asks for a solar resource assessment - User wants "complete solar data for my area" PARAMETERS: - latitude (REQUIRED): Location latitude - longitude (REQUIRED): Location longitude - capacity (OPTIONAL): System capacity in kW (for PV estimates) EXAMPLES: - "Complete solar summary for Sydney -33.87, 151.21" → call with latitude=-33.87, longitude=151.21 - "Solar resource assessment for my location 34.05, -118.24" → call with latitude=34.05, longitude=-118.24 - "Full solar data with 5kW system estimate" → call with latitude, longitude, capacity=5 Get a comprehensive solar summary including irradiance, weather, and PV forecasts

Useful for understanding conditions affecting solar output. USE WHEN: - User asks about weather conditions affecting solar panels - User needs temperature or cloud cover forecasts - User wants to understand weather impact on solar generation - User asks "what's the weather forecast for solar" PARAMETERS: - latitude (REQUIRED): Location latitude - longitude (REQUIRED): Location longitude - hours (OPTIONAL): Number of hours to forecast EXAMPLES: - "Weather forecast for solar panels in Sydney -33.87, 151.21" → call with latitude=-33.87, longitude=151.21 - "Cloud cover forecast for my location 34.05, -118.24" → call with latitude=34.05, longitude=-118.24 - "Temperature forecast for next week" → call with latitude, longitude, hours=168 Get weather forecasts including temperature, cloud opacity, and snow depth

Shows site IDs, capacities, and locations for managing multiple solar installations. USE WHEN: - User wants to see all their registered solar sites - User needs to find site IDs for other queries - User is managing multiple rooftop installations - User asks "what solar sites do I have configured" EXAMPLES: - "List all my solar sites" → call with no params - "Show my registered rooftop PV systems" → call with no params - "What sites do I have in Solcast?" → call with no params List all configured rooftop PV sites in your Solcast account