README.md
MCP server for Korean agricultural wholesale market auction data.
Korean Agriculture Market MCP Server
MCP server for Korean agricultural wholesale market auction data.
Real-time auction prices from 32+ public wholesale markets across South Korea, powered by data.go.kr Open API.
Tools (6)
| Tool | Description |
|---|---|
get_realtime_auction |
Real-time auction data (63,000+ daily records nationwide) |
search_product_price |
Search prices by product keyword with market-level summaries |
compare_market_prices |
Compare prices across markets for a product |
get_price_trend |
Price trends over recent N days |
get_market_list |
List of all wholesale markets and category codes |
get_auction_summary |
Daily auction statistics by product and market |
Data Coverage
- 32 wholesale markets across South Korea (Seoul, Busan, Daegu, Daejeon, Gwangju, etc.)
- 22 product categories: fruits, vegetables, mushrooms, grains, livestock, seafood, etc.
- 63,000+ auction records per day
- Fields: auction time, market, corporation, product, variety, unit price, quantity, packaging, origin
Quick Start
# Clone
git clone https://github.com/higheun/korean-agriculture-mcp.git
cd korean-agriculture-mcp
# Setup
python -m venv .venv
.venv/Scripts/pip install -r requirements.txt # Windows
# .venv/bin/pip install -r requirements.txt # Linux/Mac
# Configure API key
cp .env.example .env
# Edit .env with your data.go.kr API key
# Run (stdio mode for Claude Desktop)
python server.py
# Run (SSE mode for remote access)
MCP_TRANSPORT=sse PORT=8000 python server.py
API Key
Get a free API key from data.go.kr:
- Sign up at data.go.kr
- Search for "전국 공영도매시장 실시간 경매정보"
- Apply for API usage (instant approval)
- Copy the API key to
.env
Claude Desktop Configuration
{
"mcpServers": {
"korean-agriculture": {
"command": "python",
"args": ["path/to/korean-agriculture-mcp/server.py"],
"env": {
"DATA_GO_KR_API_KEY": "your_api_key"
}
}
}
}
Example Queries
- "Show me today's apple auction prices at Seoul Garak market"
- "Compare strawberry prices across all markets"
- "What's the price trend for Napa cabbage over the past week?"
- "Give me an auction summary for Daejeon Noeun market"
Data Source
- data.go.kr - Korean Agricultural Products Wholesale Market Real-time Auction Info
- API:
https://apis.data.go.kr/B552845/katRealTime2/trades2
License
MIT
Tools (6)
get_realtime_auctionRetrieves real-time auction data from over 63,000 daily records nationwide.search_product_priceSearches for prices by product keyword with market-level summaries.compare_market_pricesCompares prices across different markets for a specific product.get_price_trendRetrieves price trends over a specified number of recent days.get_market_listLists all wholesale markets and their corresponding category codes.get_auction_summaryProvides daily auction statistics categorized by product and market.Environment Variables
DATA_GO_KR_API_KEYrequiredAPI key obtained from data.go.kr for accessing the public wholesale market data.Configuration
claude_desktop_config.json
{"mcpServers": {"korean-agriculture": {"command": "python", "args": ["path/to/korean-agriculture-mcp/server.py"], "env": {"DATA_GO_KR_API_KEY": "your_api_key"}}}}Try it
→Show me today's apple auction prices at Seoul Garak market.
→Compare strawberry prices across all markets.
→What's the price trend for Napa cabbage over the past week?
→Give me an auction summary for Daejeon Noeun market.