Skip to main content
Glama
README.md
# ๐ŸŒŠ HRFCO Intelligent Water Search System

AI-friendly Korean water data search system with natural language processing.

## ๐Ÿš€ Features

- **Natural Language Search**: "ํ•œ๊ฐ• ์ˆ˜์œ„", "์„œ์šธ ๊ฐ•์šฐ๋Ÿ‰" โ†’ Automatic station discovery
- **Smart Matching**: 16 regions + river name mapping + similarity scoring
- **Response Optimization**: All responses < 1KB (prevents LLM token overflow)
- **OpenAI Compatible**: Ready for ChatGPT Function Calling integration

## ๐Ÿ“ก API Endpoints

- `/.netlify/functions/search-station` - Search stations by location name
- `/.netlify/functions/get-water-info` - One-stop water information query
- `/.netlify/functions/recommend-stations` - Recommend nearby stations
- `/.netlify/functions/openai-functions` - OpenAI Function definitions

## ๐Ÿ”ง Environment Variables

```
HRFCO_API_KEY=your-api-key-here
```

## ๐Ÿงช Test Examples

```bash
# Search stations
curl -X POST https://your-site.netlify.app/.netlify/functions/search-station \
  -d '{"location_name": "ํ•œ๊ฐ•", "limit": 3}'

# Get water info
curl -X POST https://your-site.netlify.app/.netlify/functions/get-water-info \
  -d '{"query": "์„œ์šธ ์ˆ˜์œ„", "limit": 5}'
```

## ๐Ÿ“Š Performance

- **Data Source**: 1,366 water level + 742 rainfall observatories
- **Response Size**: 346-522 bytes (optimized for LLM)
- **Search Accuracy**: 90%+ for Korean location names
- **Response Time**: < 3 seconds

Built with TypeScript + Netlify Functions