Skip to content

README.md

Latest commit

 

History

History
102 lines (73 loc) · 3.37 KB

README.md

File metadata and controls

102 lines (73 loc) · 3.37 KB

Wunderground PWS - Home Assistant Integration

A Home Assistant integration for fetching weather data from Wunderground Personal Weather Stations.

Installation

  1. Copy the wunderground_scraper directory to your Home Assistant custom_components directory
  2. Restart Home Assistant
  3. Go to Settings > Devices & Services
  4. Click Add Integration and search for "Wunderground Scraper"
  5. Enter a station URL (e.g., https://www.wunderground.com/dashboard/pws/KTXHOUST4430) or just the station ID (KTXHOUST4430)

📊 Available Sensors

The integration creates sensors for weather data available from your station:

Temperature & Humidity

  • 🌡️ Temperature - Current temperature (°F and °C)
  • 🌡️ Feels Like - Apparent temperature (accounts for wind chill/heat index)
  • 💧 Dew Point - Dew point temperature (°F and °C)
  • 💧 Humidity - Relative humidity percentage

Wind

  • 💨 Wind Speed - Current wind speed (mph)
  • 💨 Wind Gust - Wind gust speed (mph)
  • 💨 Wind Direction - Wind direction (degrees 0-360)

Pressure & Precipitation

  • 🎈 Pressure - Barometric pressure (inHg)
  • 🌧️ Precipitation Rate - Current rain rate (in/hr)
  • 🌧️ Precipitation Accumulation - Total daily rainfall (in)

Solar & UV

  • ☀️ Solar Radiation - Solar radiation intensity (W/m²)
  • ☀️ UV Index - UV index

Note: Not all stations report all sensors. The integration automatically creates only the sensors that have data available. UV and Solar are typically 0 at night.

🧪 Testing & Debugging

Before adding to Home Assistant, test your station with the debug script:

cd debug
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

# Test with station ID
python test_sensors.py KTXHOUST4430

# Or with full URL
python test_sensors.py https://www.wunderground.com/dashboard/pws/KTXHOUST4430

The debug script will show:

  • ✅ All available sensors for your station
  • 🕐 Last update time
  • 📍 Station location
  • 📊 Success rate and data completeness

See debug/README.md for detailed debugging instructions.

❓ FAQ

Q: Do I need to create an API key? A: No! The integration uses the public Weather.com PWS API with a key found in Wunderground's source code.

Q: Can I monitor a station I don't own? A: Yes! You can monitor any public PWS on Wunderground.

Q: Why are some sensors showing "0" or "unavailable"? A: This depends on your station:

  • UV Index & Solar Radiation are 0 at night (normal)
  • Some stations don't have all sensors installed
  • Check the debug script output to see what's available

Q: Is my data sent to anyone? A: The integration only fetches data from Weather.com (same source Wunderground uses)

🔄 Version History

v0.2.0 (2025-11-23)

  • Complete rewrite to use Weather.com PWS API instead of HTML scraping
  • ✅ 100% sensor success rate (vs ~50% with HTML scraping)
  • Faster and more reliable data fetching
  • Removed BeautifulSoup4 dependency
  • Better error handling and logging
  • Automatic station ID extraction from URLs

v0.1.0

  • Initial release with HTML scraping

📝 License

This integration is provided as-is for personal use.

Author: Amit Serper 👋
Repository: github.com/aserper/wunderscraper 🔗
Last Updated: 2025-11-23