Korean Agriculture Market Data

韩国农产品市场 MCP 服务

用于获取韩国农产品批发市场拍卖数据的 MCP 服务。

通过 data.go.kr 开放 API，获取韩国 32 个以上公共批发市场的实时拍卖价格。

工具（6 个）

工具	描述
get_realtime_auction	实时拍卖数据（全国每日 63,000 条以上记录）
search_product_price	按产品关键词搜索价格，并查看市场级汇总
compare_market_prices	比较各市场同一产品的价格
get_price_trend	最近 N 天的价格趋势
get_market_list	所有批发市场及类别代码列表
get_auction_summary	按产品和市场查看每日拍卖统计数据

数据覆盖范围

• 韩国各地 32 个批发市场（首尔、釜山、大邱、大田、光州等）
• 22 个产品类别：水果、蔬菜、蘑菇、谷物、畜禽、水产等
• 每日 63,000 条以上拍卖记录
• 字段：拍卖时间、市场、公司、产品、品种、单价、数量、包装、原产地

快速开始

# 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 密钥

从 data.go.kr 获取免费的 API 密钥：

1. 在 data.go.kr 注册
2. 搜索「전국 공영도매시장 실시간 경매정보」
3. 申请使用 API（即时获批）
4. 将 API 密钥复制到 .env

Claude Desktop 配置

{
  "mcpServers": {
    "korean-agriculture": {
      "command": "python",
      "args": ["path/to/korean-agriculture-mcp/server.py"],
      "env": {
        "DATA_GO_KR_API_KEY": "your_api_key"
      }
    }
  }
}

示例查询

• “显示今天首尔 Garak 市场的苹果拍卖价格”
• “比较所有市场的草莓价格”
• “过去一周大白菜的价格趋势如何？”
• “提供大田 Noeun 市场的拍卖汇总”

数据来源

• data.go.kr - 韩国农产品批发市场实时拍卖信息
• API：https://apis.data.go.kr/B552845/katRealTime2/trades2

许可证

MIT