Korean produce wholesale reference prices, buy-or-wait signals and deal price checks with sources.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
단일 품목의 원가(직납가)와 판매가로부터 원가율·마진율·마진액·자연어 평가를 반환합니다. 마트 영업 미팅·발주서 작성·B2AI 자동 발주 권고에 활용. ## 파라미터 - `cost_price` (query, required): 직납가 / 원가 (KRW) - `sell_price` (query, required, >0): 판매가 (KRW) - `item_name` (query, optional): 품목명 (한글, 응답에 echo) ## assessment 임계값 - ≥30% → '양호' - 15-30% → '보통' - <15% → '낮음 — 가격 재검토 권장' Returns single-item margin/cost rate with natural-language assessment.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http farmtempo https://app.farmtempo.com/mcp/public/
단일 품목의 원가(직납가)와 판매가로부터 원가율·마진율·마진액·자연어 평가를 반환합니다. 마트 영업 미팅·발주서 작성·B2AI 자동 발주 권고에 활용. ## 파라미터 - `cost_price` (query, required): 직납가 / 원가 (KRW) - `sell_price` (query, required, >0): 판매가 (KRW) - `item_name` (query, optional): 품목명 (한글, 응답에 echo) ## assessment 임계값 - ≥30% → '양호' - 15-30% → '보통' - <15% → '낮음 — 가격 재검토 권장' Returns single-item margin/cost rate with natural-language assessment.
| Argument | Type | Description |
|---|---|---|
| item_name | any | |
| cost_price* | number | |
| sell_price* | number |
{
"type": "object",
"required": [
"cost_price",
"sell_price"
],
"properties": {
"item_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Item Name"
},
"cost_price": {
"type": "number",
"title": "Cost Price"
},
"sell_price": {
"type": "number",
"title": "Sell Price"
}
}
}여러 품목의 매입·판매 행을 일괄로 계산해 행별·총계 결과를 반환합니다. HTML 원가율 계산기 탭의 calcRow + totals 와 동일 출력. ## Body 스키마 ```json {"rows": [{"item": "배추", "buyPrice": 1000, "sellPrice": 1500, "qty": 1}]} ``` Returns per-row + aggregated totals for bulk margin calculation.
| Argument | Type | Description |
|---|---|---|
| rows* | array | 품목별 매입·판매 행 |
{
"type": "object",
"required": [
"rows"
],
"properties": {
"rows": {
"type": "array",
"items": {
"type": "object",
"title": "_BulkRow",
"required": [
"item",
"buyPrice",
"sellPrice"
],
"properties": {
"qty": {
"type": "number",
"title": "Qty",
"default": 1,
"description": "수량 (기본 1)",
"exclusiveMinimum": 0
},
"item": {
"type": "string",
"title": "Item",
"description": "품목명 한글 (예: 배추)"
},
"buyPrice": {
"type": "number",
"title": "Buyprice",
"minimum": 0,
"description": "직납가 / 원가 (원)"
},
"sellPrice": {
"type": "number",
"title": "Sellprice",
"description": "판매가 (원)",
"exclusiveMinimum": 0
}
}
},
"title": "Rows",
"minItems": 1,
"description": "품목별 매입·판매 행"
}
}
}거래 직전에 부르는 도구. 최근 10거래일 aT 도매 정산가 범위(±5%)와 템포 기준 시세 v1 대비 차이를 준다. role=buyer|seller 면 그쪽 관점의 한 줄. 참고 판정이며 가격 결정·확정은 당사자.
| Argument | Type | Description |
|---|---|---|
| item* | string | 품목명 (예: 오이) |
| role | string | buyer 또는 seller (선택) |
| price* | number | 검토할 단가(원/kg) |
{
"type": "object",
"required": [
"item",
"price"
],
"properties": {
"item": {
"type": "string",
"title": "Item",
"maxLength": 20,
"minLength": 1,
"description": "품목명 (예: 오이)"
},
"role": {
"type": "string",
"title": "Role",
"default": "",
"maxLength": 10,
"description": "buyer 또는 seller (선택)"
},
"price": {
"type": "number",
"title": "Price",
"maximum": 1000000,
"description": "검토할 단가(원/kg)",
"exclusiveMinimum": 0
}
}
}등록된 직납가와 현재 도매가를 비교하여 품목별 절감율을 계산. 마트 영업 미팅용 비교표 생성에 사용. Compares direct-supply prices against current wholesale prices.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}오늘 시세, 7일 뒤 범위(템포 레인지), 평년 대비, 세 예측 의견, 변동 주의, 과거 성적(어제 가격 대비), 대체 품목을 한 번에 묶어 '1주 기다리기 / 지금 사기 / 필요한 만큼만 / 모름' 참고 신호를 줍니다. 숫자마다 출처·기준일(receipts). 판단 규칙(rule)을 응답에 싣고, 그 규칙의 성과는 아직 검증 전입니다. 사용자에게 '확정은 사람'임을 밝히세요. qty(kg)를 주면 지금 살 때와 7일 뒤 예상 금액을 함께 줍니다.
| Argument | Type | Description |
|---|---|---|
| qty | any | 살 양(kg) — 선택 |
| item | any | 품목명 (예: 상추) |
| item_key | any | 시세 계열 키(예: 상추|01) — item 대신 쓸 수 있음 |
{
"type": "object",
"required": [],
"properties": {
"qty": {
"anyOf": [
{
"type": "number",
"maximum": 1000000,
"exclusiveMinimum": 0
},
{
"type": "null"
}
],
"title": "Qty",
"description": "살 양(kg) — 선택"
},
"item": {
"anyOf": [
{
"type": "string",
"maxLength": 40,
"minLength": 1
},
{
"type": "null"
}
],
"title": "Item",
"description": "품목명 (예: 상추)"
},
"item_key": {
"anyOf": [
{
"type": "string",
"maxLength": 60,
"minLength": 1
},
{
"type": "null"
}
],
"title": "Item Key",
"description": "시세 계열 키(예: 상추|01) — item 대신 쓸 수 있음"
}
}
}aT 도매 정산가 기준 26품목. 필요량(kg)과 기한(오늘~7일)을 주면 세 가지 사는 방법의 예상 금액(중앙값·80% 범위, 신선도 손실 가정 포함)과 묶음별 과거 성적(과거 자료 검증·가상 구매 계산: 평균 절감·나쁜 5% 날·손해 본 날 비율)을 줍니다. 팜템포는 고르거나 주문하지 않습니다. 금액은 예측 기반 예시이며 약속이 아님을 사용자에게 밝히세요.
| Argument | Type | Description |
|---|---|---|
| qty* | number | 필요량(kg) |
| days | integer | 며칠 안에 필요한가(0=오늘, 최대 7 · 저장성 9품목은 14) |
| item* | string | 품목명 (예: 상추) — aT 기준판 26품목 |
| weekly | boolean | 매주 같은 양이 필요하면 true — 저장성 품목에 '다음 주 몫 미리 사기' 안을 함께 냄 |
| loss_rate | any | 하루 신선도 손실 가정(예: 0.015). 없으면 묶음 기본값 |
{
"type": "object",
"required": [
"item",
"qty"
],
"properties": {
"qty": {
"type": "number",
"title": "Qty",
"maximum": 1000000,
"description": "필요량(kg)",
"exclusiveMinimum": 0
},
"days": {
"type": "integer",
"title": "Days",
"default": 7,
"maximum": 14,
"minimum": 0,
"description": "며칠 안에 필요한가(0=오늘, 최대 7 · 저장성 9품목은 14)"
},
"item": {
"type": "string",
"title": "Item",
"maxLength": 40,
"minLength": 1,
"description": "품목명 (예: 상추) — aT 기준판 26품목"
},
"weekly": {
"type": "boolean",
"title": "Weekly",
"default": false,
"description": "매주 같은 양이 필요하면 true — 저장성 품목에 '다음 주 몫 미리 사기' 안을 함께 냄"
},
"loss_rate": {
"anyOf": [
{
"type": "number",
"maximum": 0.1,
"minimum": 0
},
{
"type": "null"
}
],
"title": "Loss Rate",
"description": "하루 신선도 손실 가정(예: 0.015). 없으면 묶음 기본값"
}
}
}경락 조회에 사용할 수 있는 전국 공영도매시장 코드(예: 110001=서울가락)와 한글명 목록. /api/auction/price 의 market 파라미터에 코드·한글명 모두 사용 가능.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}특정 품목의 경락(낙찰) 요약을 반환한다. 단위는 원/kg(거래중량 가중평균). - market 지정: 해당 시장 1곳의 평균 낙찰가·총물량·거래건수·가격범위 + KAMIS 정산 도매가 비교(기준 상이: 경락=낙찰가, KAMIS=정산 도매가). - market 생략: 전 시장을 평균가 오름차순(어디가 싼지)으로 반환. - date 생략: 최신 수집일 자동. - market 매칭: 코드(110001)·한글명(서울가락)·부분일치(가락) 모두 허용. 부분일치 복수 시 후보 목록 반환. - 미존재 품목·시장·날짜는 404 아닌 200 + {found:false, hint}.
| Argument | Type | Description |
|---|---|---|
| date | any | 거래정산일 YYYY-MM-DD. 생략 시 최신 수집일. |
| item* | string | 품목 한글명. 예: 양파, 마늘, 배추, 사과, 복숭아 |
| market | any | 도매시장 코드(110001)·한글명(서울가락)·부분일치(가락). 생략 시 전 시장. |
{
"type": "object",
"required": [
"item"
],
"properties": {
"date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Date",
"description": "거래정산일 YYYY-MM-DD. 생략 시 최신 수집일."
},
"item": {
"type": "string",
"title": "Item",
"description": "품목 한글명. 예: 양파, 마늘, 배추, 사과, 복숭아"
},
"market": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Market",
"description": "도매시장 코드(110001)·한글명(서울가락)·부분일치(가락). 생략 시 전 시장."
}
}
}**특허 #1 추천 시스템의 사용자 인터페이스 출력.** 현재 월에 해당하는 기상 민감 품목별 경보를 자연어 메시지로 반환. AI 에이전트가 그대로 사용자에게 전달 가능한 형태. ## action 값 4단계 - `즉시매입` / `선매입권고` / `정상발주` / `매입지연` Monthly weather alerts for current month, with natural language messages.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}오늘 기준 향후 horizon_days(기본 14일=D-14 경보) 내 도래하는 명절(설날·추석)과 김장철(11/1~12/15) 이벤트, 그리고 27년 실측 기반 영향 품목 신호를 반환한다. 각 품목 신호는 두 가지로 분리된다: - price: 명절/김장 가격급등 → 선매입(발주 권고 제안) 대상 - demand: 수요폭증인데 가격하락(공급폭증) → '매수 적기' 플래그 강도(강/중/약)와 일관성(consistency %)을 함께 노출한다.
| Argument | Type | Description |
|---|---|---|
| horizon_days | integer | 조회 범위 일수 (기본 14=D-14 경보 윈도우, 최대 200=장기 카운트다운) |
{
"type": "object",
"required": [],
"properties": {
"horizon_days": {
"type": "integer",
"title": "Horizon Days",
"default": 14,
"maximum": 200,
"minimum": 1,
"description": "조회 범위 일수 (기본 14=D-14 경보 윈도우, 최대 200=장기 카운트다운)"
}
}
}특정 품목의 명절·김장 이벤트 신호를 반환한다. signal_type=price(가격급등 선매입) 또는 demand(가격하락 매수적기). order_plan_suggestion 은 방식 A '제안형' — 기존 suggest_order_plan (POST /api/predictive-orders/suggest-trigger) 호출용 payload 를 생성만 하며, AI 는 발주를 실행하지 않는다(사람 승인 게이트, 특허 정합).
| Argument | Type | Description |
|---|---|---|
| item* | string | 품목 한글명. 예: 사과, 대파, 배추, 생고추 |
{
"type": "object",
"required": [
"item"
],
"properties": {
"item": {
"type": "string",
"title": "Item",
"description": "품목 한글명. 예: 사과, 대파, 배추, 생고추"
}
}
}특정 품목의 최근 N일간 일자별 도매가 시계열을 반환합니다. `days` 파라미터로 조회 기간 조정(기본 14일). ## 파라미터 - `item_name` (path, required): 품목명 한글. 예: 배추, 양파, 대파 - `days` (query, optional): 조회 일수 (1~365, 기본 14) Returns daily wholesale price time series for a single item.
| Argument | Type | Description |
|---|---|---|
| days | integer | |
| item_name* | string |
{
"type": "object",
"required": [
"item_name"
],
"properties": {
"days": {
"type": "integer",
"title": "Days",
"default": 14,
"maximum": 365,
"minimum": 1
},
"item_name": {
"type": "string",
"title": "Item Name"
}
}
}품목별 12개월 평년 가격 흐름입니다. 월값 = 올해 그 달 평일마다 구한 KAMIS 평년(지난 5년 같은 시기 ±3일 평일 평균 중 최고·최저를 뺀 3년 평균)의 평균. 단위는 계열 unit(원/kg 또는 원/개). 평년이 잡힌 평일이 10일 미만인 달은 null. 품목 매핑은 승인된 별칭만 쓰고, C등급 계열은 내지 않습니다(available=false, reason). 매입 시점 권고가 아니라 지난 5년의 계절 흐름입니다. 12-month KAMIS 5-year normal (trimmed mean of 3 of 5 years) per item; low/high month of the normal.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}최근 N일간(기본 3일) 실관측 기상 데이터와 가격 변동을 결합한 단기 분석. scatter plot용 데이터 포인트와 자연어 해석(`interpretation`) 포함. Combines recent weather observations with price movements for short-term analysis.
| Argument | Type | Description |
|---|---|---|
| days | integer | |
| station_id | integer |
{
"type": "object",
"required": [],
"properties": {
"days": {
"type": "integer",
"title": "Days",
"default": 3,
"maximum": 7,
"minimum": 1
},
"station_id": {
"type": "integer",
"title": "Station Id",
"default": 108
}
}
}**특허 #1 기상×가격 매입 타이밍 추천 시스템의 핵심 데이터.** 11년치(2015~2025) KAMIS 가격 + 기상청 ASOS 데이터로 산출한 품목별·월별 피어슨 상관계수 매트릭스. ## 핵심 필드 - `yearly_corr[품목][기상변수]`: `{r, p, n, significant}` 객체 - `r`: 피어슨 상관계수 (-1 ~ +1) - `p`: p-value (0.05 미만이면 통계적 유의) - `significant`: p<0.05 + |r|>=0.7 동시 충족 - `alert_triggers`: 사전 정의된 경보 규칙 14개 Monthly weather-price Pearson correlation matrix (Patent #1 core data).
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}**v2 신설 — 5대 원칙 #4 데이터 정규화 핵심 엔드포인트.** 9개 핵심 품목(배추·무·양파·대파·마늘·오이·감자·생고추·토마토)의 도매가를 품목당 1행 단일 스키마로 반환합니다. ## 호출 메커니즘 - KAMIS `dailyPriceByCategoryList` (도매: `p_product_cls_code=02`) 카테고리 200·100 두 번 호출 · 국가코드 비움 = 조사 도매시장(최대 5곳) 평균 - 각 품목의 `(item_code, kind_code, rank_code)` 매칭으로 단일 행 추출 - 도매 매칭 실패 품목은 `dailySalesList`(소매)로 자동 fallback ## 핵심 필드 - `today`, `yesterday`: 도매가 (KRW, KAMIS 단위 기준) - `unit`: KAMIS 도매시장 표준 단위 (예: '10kg', '100개') - `kg_per_unit`: 단위→kg 환산 계수 (품목 간 비교용) - `krw_per_kg`: **kg당 단가 (KRW/kg)** — 품목 간 직접 비교 가능한 정규화 가격 - `kg_conversion_note`: 환산 근거 자연어 설명 (LLM 컨텍스트용) - `price_basis`: `"wholesale"` (도매 성공) / `"retail_fallback"` (소매 대체) - `as_of`: 실제 가격 기준일 (도매시장 마감 전이면 전일) - `kamis_item_code`, `kamis_kind_code`, `kamis_kind_name`, `kamis_rank`: 출처 추적용 메타필드 - `coverage`: 9품목 중 도매/소매 fallback/누락 분포 ## /api/prices와의 차이 - `/api/prices`: 소매가, 다중 단위 중복 가능 (대시보드 호환용) - `/api/prices/wholesale`: **도매가, 9품목, 정규화된 단일 스키마 (LLM/AI용)** Returns normalized wholesale prices (1 row per item) for 9 core items. Falls back to retail when wholesale unavailable (price_basis indicates source).
| Argument | Type | Description |
|---|---|---|
| regday | any | 조회 기준일 (YYYY-MM-DD). 미지정 시 오늘. 도매시장 마감 전이면 dpr2(전일) 자동 fallback. |
{
"type": "object",
"required": [],
"properties": {
"regday": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Regday",
"examples": [
"2026-04-30"
],
"description": "조회 기준일 (YYYY-MM-DD). 미지정 시 오늘. 도매시장 마감 전이면 dpr2(전일) 자동 fallback."
}
}
}표준 품목 하나 — 소스별 식별자·확정 여부·포장 kg 근거(가격 없음)
| Argument | Type | Description |
|---|---|---|
| item_id* | string |
{
"type": "object",
"required": [
"item_id"
],
"properties": {
"item_id": {
"type": "string",
"title": "Item Id"
}
}
}표준 품목 목록 — 소스별 매핑 신뢰도 요약(가격 없음)
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}자유 텍스트(한/영/일/중 표준명·별칭·소스 원문명) → 표준 품목. 부분 일치 안 함 · 두 축 표기와 근거 포함 · 로트 연결 없음
| Argument | Type | Description |
|---|---|---|
| q* | string | |
| locale | any |
{
"type": "object",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"title": "Q",
"maxLength": 100,
"minLength": 1
},
"locale": {
"anyOf": [
{
"type": "string",
"maxLength": 10
},
{
"type": "null"
}
],
"title": "Locale"
}
}
}식별자 정합 — 여러 체계·주체의 품목 코드/로트 코드가 같은 품목·같은 로트를 가리키는지(추론 없음·가격 없음)
| Argument | Type | Description |
|---|---|---|
| identifiers* | array |
{
"type": "object",
"required": [
"identifiers"
],
"properties": {
"identifiers": {
"type": "array",
"items": {
"type": "object",
"title": "Identifier",
"required": [
"kind",
"jurisdiction"
],
"properties": {
"ref": {
"anyOf": [
{
"type": "string",
"maxLength": 100
},
{
"type": "null"
}
],
"title": "Ref",
"description": "호출자 쪽 참조값 — 응답에 그대로 돌려준다"
},
"code": {
"anyOf": [
{
"type": "string",
"maxLength": 200
},
{
"type": "null"
}
],
"title": "Code",
"description": "kind=item 일 때 그 체계의 품목 코드"
},
"kind": {
"enum": [
"item",
"lot"
],
"type": "string",
"title": "Kind",
"description": "item: 품목 코드 하나 · lot: 거래 로트 하나"
},
"scheme": {
"anyOf": [
{
"type": "string",
"maxLength": 100
},
{
"type": "null"
}
],
"title": "Scheme",
"description": "kind=lot 일 때 로트 식별 체계(예: garak_corp_lot)"
},
"source": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Source",
"description": "kind=item 일 때 식별 체계(예: garak_kat_std, usda_mars, fda_ftl)"
},
"lot_code": {
"anyOf": [
{
"type": "string",
"maxLength": 200
},
{
"type": "null"
}
],
"title": "Lot Code"
},
"party_id": {
"anyOf": [
{
"type": "string",
"maxLength": 100
},
{
"type": "null"
}
],
"title": "Party Id",
"description": "kind=lot 일 때 식별자를 부여·사용하는 주체(법인 코드는 주체 범위에서만 유일)"
},
"item_code": {
"anyOf": [
{
"type": "string",
"maxLength": 200
},
{
"type": "null"
}
],
"title": "Item Code"
},
"jurisdiction": {
"type": "string",
"title": "Jurisdiction",
"pattern": "^[A-Z]{2}$",
"description": "관할국 ISO 3166-1 alpha-2 (KR/US)"
}
}
},
"title": "Identifiers",
"maxItems": 50,
"minItems": 1
}
}
}[B2AI] 도매시장 개장/휴장과 다음 개장일. ⛔ Phase 12a 의 판정 함수(`receipt_price.market_status`)를 **그대로** 쓴다. 영수증 시세 대조와 이 캘린더가 다른 답을 내면 안 된다. `OPEN`=거래 있음 · `MARKET_CLOSED`=휴장(수집됐으나 거래 0건) · `NO_DATA`=미수집. 휴장과 미수집을 뭉뚱그리지 않는다.
| Argument | Type | Description |
|---|---|---|
| date | any | YYYY-MM-DD (생략 시 오늘) |
| days | integer |
{
"type": "object",
"required": [],
"properties": {
"date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Date",
"description": "YYYY-MM-DD (생략 시 오늘)"
},
"days": {
"type": "integer",
"title": "Days",
"default": 7,
"maximum": 31,
"minimum": 1
}
}
}품목 상세 — 시세 추이 + 평년 밴드 + 등급/등급사유. ⚠ B·C등급 응답에는 예측 필드가 **없습니다**(부재). A등급만 forecast_available=true이며 실제 3스케일 방향 예측·신뢰도는 기존 예측 파이프라인이 제공합니다. 반입량·법인집중도는 이번 범위 밖(원자료 확보 후 추가).
| Argument | Type | Description |
|---|---|---|
| days | integer | 최근 N일 시세 추이 |
| item_key* | string |
{
"type": "object",
"required": [
"item_key"
],
"properties": {
"days": {
"type": "integer",
"title": "Days",
"default": 365,
"maximum": 11000,
"minimum": 7,
"description": "최근 N일 시세 추이"
},
"item_key": {
"type": "string",
"title": "Item Key"
}
}
}전품목 시세 목록. 등급·표기명·최근 시세·전일비·평년비. A등급=검증된 예측 계열(예측 제공), B등급=시세 상세, C등급=시세 조회. 단가는 KAMIS 도매·상품 정규화가(원/단위, KRW). 반입량 미포함(이번 범위).
| Argument | Type | Description |
|---|---|---|
| q | any | 품목명 검색 |
| sort | string | change|vs_normal|name |
| buryu | any | 부류 필터(이번 범위: 미설정) |
| grade | any | A|B|C 필터 |
{
"type": "object",
"required": [],
"properties": {
"q": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Q",
"description": "품목명 검색"
},
"sort": {
"type": "string",
"title": "Sort",
"default": "change",
"description": "change|vs_normal|name"
},
"buryu": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Buryu",
"description": "부류 필터(이번 범위: 미설정)"
},
"grade": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Grade",
"description": "A|B|C 필터"
}
}
}[B2AI] 시세 티커 — 품목·가격(원/kg)·전일 대비 %. ⛔ **표시 시각과 기준일을 반드시 함께 준다.** 어제 값을 실시간처럼 보이게 하지 않는다. 박거래 품목(거래 50건·1,000kg 미만)은 등락률이 노이즈라 제외한다 — 제외 수는 응답에 명시.
| Argument | Type | Description |
|---|---|---|
| limit | integer |
{
"type": "object",
"required": [],
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 12,
"maximum": 40,
"minimum": 1
}
}
}공급자의 신고된 배송 조건으로 지정 시군구 커버 여부를 판정한다. status=SELF(자차)/CARRIER(외부 운송)/PICKUP_ONLY(산지 인도)/NEGOTIATE(미신고 — 결격 아님)/OUT_OF_RANGE(권역 밖·육로 미연결). unit_price_krw·qty_value·qty_unit 을 함께 주면 운임 포함 인도원가와 kg당 인도단가(원/kg)를 같이 계산한다. 좌표·읍면동·주소는 반환하지 않는다. 단위: distance_km_straight 는 킬로미터(km)이며 **예상 직선거리**입니다(도로거리·소요시간 아님). fee_estimate_krw 는 대한민국 원(KRW) 범위이고 정보가 부족하면 min·max 모두 null 입니다(0원 아님). max_load_kg 는 킬로그램(kg). 모든 배송 정보는 공급자 신고 기준이며 팜템포가 검증하지 않았습니다. 행정구역 경계: 통계청 SGIS(공공누리 제1유형) / 가공: vuski/admdongkor (CC BY 4.0)
| Argument | Type | Description |
|---|---|---|
| item | any | 품목명 — kg 환산표 조회용 |
| region* | string | 구매자 시군구 코드 5자리 또는 '경기 구리시' |
| qty_unit | any | kg/상자/망/단/포 |
| order_krw | any | 주문 금액(대한민국 원) |
| qty_value | any | 수량 |
| supplier_id* | string | |
| unit_price_krw | any | 단가(원/단위) |
{
"type": "object",
"required": [
"supplier_id",
"region"
],
"properties": {
"item": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Item",
"description": "품목명 — kg 환산표 조회용"
},
"region": {
"type": "string",
"title": "Region",
"description": "구매자 시군구 코드 5자리 또는 '경기 구리시'"
},
"qty_unit": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Qty Unit",
"description": "kg/상자/망/단/포"
},
"order_krw": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Order Krw",
"description": "주문 금액(대한민국 원)"
},
"qty_value": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Qty Value",
"description": "수량"
},
"supplier_id": {
"type": "string",
"title": "Supplier Id"
},
"unit_price_krw": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Unit Price Krw",
"description": "단가(원/단위)"
}
}
}AI RFQ 초안 — 예측 API로 밴드+근거+신뢰도 등급. 신뢰도 하위 등급이면 밴드 null+사유. sync def(스레드풀 실행) — 같은 :8003 워커로의 예측 자기호출이 이벤트 루프를 막지 않도록.
| Argument | Type | Description |
|---|---|---|
| b | object |
{
"type": "object",
"required": [],
"properties": {
"b": {
"type": "object",
"title": "B",
"default": {},
"additionalProperties": true
}
}
}공개 필드만 반환(상호·시군구·품목·규격·등급·출하기간·희망가). 연락처 없음. 단가 KRW. deliverable_to 에 구매자 시군구(코드 5자리 또는 '경기 구리시')를 주면 그 지역까지 배송 가능한 건만 남기고, 각 건에 delivery 객체를 중첩한다 — status/예상 직선거리(킬로미터·직선)/운임 범위(대한민국 원)/인도원가. 미신고 공급자는 배제하지 않고 '배송 협의'로 함께 남는다. deliverable_to 를 주지 않으면 응답은 종전과 동일하다(스키마 무변경).
| Argument | Type | Description |
|---|---|---|
| item | any | |
| region | any | |
| deliverable_to | any | 구매자 시군구 코드 5자리 또는 '경기 구리시' — 배송 가능 건만 |
{
"type": "object",
"required": [],
"properties": {
"item": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Item"
},
"region": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Region"
},
"deliverable_to": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Deliverable To",
"description": "구매자 시군구 코드 5자리 또는 '경기 구리시' — 배송 가능 건만"
}
}
}OPEN RFQ 목록. farm_id 지정 시 그 농가 조건 적합(품목×권역) = 입찰함(폴링).
| Argument | Type | Description |
|---|---|---|
| item | any | |
| region | any | |
| farm_id | any |
{
"type": "object",
"required": [],
"properties": {
"item": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Item"
},
"region": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Region"
},
"farm_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Farm Id"
}
}
}[B2AI] 팜템포 참여 역할 목록과 각 역할의 개설 상태. `CLOSED` 역할은 응답에 포함되지 않는다(가입 경로가 없다). `WAITLIST` 는 대기 등록만 가능하며 아직 거래가 열리지 않은 상태다.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}[B2AI] 참여 현황 공개 집계 — 역할별·시군구별 **실제 건수만**. ⛔ 개인 식별 정보(상호·연락처·정확 좌표)는 어떤 필드로도 나가지 않는다. 숫자가 0인 구간도 0으로 그대로 돌려준다(보정·반올림 없음).
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}⚠️ 실제 매장 판매·주문 자료로 만든 예측이 아니라 규칙으로 만든 참고값입니다(method='rule-baseline-v1'). 사용자에게 수요 '예측'으로 말하지 말고 '규칙 기반 참고값'이라고 밝히세요. [AGENT_HONESTY 20261011] 품목별 일자 수요량을 마트 거래 단위와 kg 환산으로 동시 반환. ## 단위 정책 각 수량 필드는 `trade_unit_value` + `trade_unit` + `kg_equivalent` 3중 표현. 외부 AI는 `kg_equivalent`로 정규화 계산, 마트 UI는 `trade_unit_value`로 표시. 환산 출처: KAMIS·가락시장 관행 표준. ## mart_id 현재 무시. 향후 매장별 모델 + 매장별 단위 환산 계수 오버라이드 예약 필드. Returns per-day demand forecast in dual units (trade + kg). Method is rule-based heuristic; ML migration planned.
| Argument | Type | Description |
|---|---|---|
| mart_id | any | 매장 식별자 (현재 무시, B2AI forward-compat) |
| item_code* | string | 품목 한글명. 예: 배추, 무, 양파, 대파, 마늘, 오이, 감자, 생고추, 토마토 |
| horizon_days | integer | 예측 기간(일). 1~30 |
{
"type": "object",
"required": [
"item_code"
],
"properties": {
"mart_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Mart Id",
"description": "매장 식별자 (현재 무시, B2AI forward-compat)"
},
"item_code": {
"type": "string",
"title": "Item Code",
"description": "품목 한글명. 예: 배추, 무, 양파, 대파, 마늘, 오이, 감자, 생고추, 토마토"
},
"horizon_days": {
"type": "integer",
"title": "Horizon Days",
"default": 7,
"maximum": 30,
"minimum": 1,
"description": "예측 기간(일). 1~30"
}
}
}권역별 상태 + 밀도 지표. 실제 카운트만 — 0인 권역도 0으로 표시한다.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}템포 기준 시세가 있는 품목 목록 (aT 도매 정산가 26품목)
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}플랫폼·AI 에이전트가 거래 가격의 기준으로 쓰는 값. 정의가 고정돼 있고(method_version), 출처·기준일을 함께 준다. 납품가는 운송·포장·등급 차이를 계수로 감안할 것. 결정은 사람.
| Argument | Type | Description |
|---|---|---|
| item* | string | 품목명 (예: 오이) — /api/v1/reference/items 참고 |
{
"type": "object",
"required": [
"item"
],
"properties": {
"item": {
"type": "string",
"title": "Item",
"maxLength": 20,
"minLength": 1,
"description": "품목명 (예: 오이) — /api/v1/reference/items 참고"
}
}
}팜템포가 재배포 승인을 받아 보유한 USDA AMS Market News 리포트 3종과, 품목별 수록 구간.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}**시장·품목마다** 가장 최근 리포트 날짜의 행만. ⛔ 최신 날짜는 시장마다·품목마다 다르다. 한 날짜로 뭉뚱그리지 말고 행마다 report_date 를 읽을 것. ⛔ 도시끼리 합치거나 평균 내지 않는다 — 각자의 시장이다.
| Argument | Type | Description |
|---|---|---|
| limit | integer | 시장×품목 한 조합당 행 수 |
| market | any | 터미널 시장 접두어: AJ, AS, BH, BP, CA, DU, HC, HX, MH, NA, NX |
| origin | any | 원산 — 발표된 표기 그대로 정확히 일치 (예: South Korea). 최신 날짜도 이 원산 안에서 잡는다 |
| commodity | any | 승인 범위: Apple Pears, Apples, Chinese Cabbage, Onions, Dry, Potatoes, Tomatoes |
{
"type": "object",
"required": [],
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 4,
"maximum": 50,
"minimum": 1,
"description": "시장×품목 한 조합당 행 수"
},
"market": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Market",
"description": "터미널 시장 접두어: AJ, AS, BH, BP, CA, DU, HC, HX, MH, NA, NX"
},
"origin": {
"anyOf": [
{
"type": "string",
"maxLength": 60
},
{
"type": "null"
}
],
"title": "Origin",
"description": "원산 — 발표된 표기 그대로 정확히 일치 (예: South Korea). 최신 날짜도 이 원산 안에서 잡는다"
},
"commodity": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Commodity",
"description": "승인 범위: Apple Pears, Apples, Chinese Cabbage, Onions, Dry, Potatoes, Tomatoes"
}
}
}보고된 대로의 반입 행. 값은 변형하지 않으며, 행마다 리포트 번호와 리포트 날짜가 붙는다.
| Argument | Type | Description |
|---|---|---|
| to | any | |
| from | any | |
| limit | integer | |
| offset | integer | |
| origin | any | 원산 — 국가(수입) 또는 미국 주 |
| commodity | any | |
| entry_point | any | 입항지·통과지 원문 |
{
"type": "object",
"required": [],
"properties": {
"to": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
{
"type": "null"
}
],
"title": "To"
},
"from": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
{
"type": "null"
}
],
"title": "From"
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 200,
"maximum": 1000,
"minimum": 1
},
"offset": {
"type": "integer",
"title": "Offset",
"default": 0,
"minimum": 0
},
"origin": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Origin",
"description": "원산 — 국가(수입) 또는 미국 주"
},
"commodity": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Commodity"
},
"entry_point": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Entry Point",
"description": "입항지·통과지 원문"
}
}
}팜템포가 재배포 승인을 받아 보유한 USDA 반입 물량 리포트와, 리포트별 수록 구간.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}선택한 행들의 파운드 합계. 🔴 이 합계는 **USDA 가 발표한 수치가 아니라 팜템포가 더한 값**이다. 응답의 `computed` 가 그렇게 밝힌다. 단위는 파운드 그대로 — kg·톤으로 바꾸지 않는다.
| Argument | Type | Description |
|---|---|---|
| to | any | |
| from | any | |
| limit | integer | |
| origin | any | |
| group_by | string | 하나: origin, commodity, entry_point, transport_mode |
| commodity | any | |
| entry_point | any |
{
"type": "object",
"required": [],
"properties": {
"to": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
{
"type": "null"
}
],
"title": "To"
},
"from": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
{
"type": "null"
}
],
"title": "From"
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 50,
"maximum": 200,
"minimum": 1
},
"origin": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Origin"
},
"group_by": {
"type": "string",
"title": "Group By",
"default": "origin",
"description": "하나: origin, commodity, entry_point, transport_mode"
},
"commodity": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Commodity"
},
"entry_point": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Entry Point"
}
}
}보고된 대로의 터미널시장 가격 구간 — 그날 아침 도매시장 첫 수취인(도매업자)의 판매가(USDA 조사). 값은 변형하지 않으며, 행마다 리포트 번호와 리포트 날짜가 붙는다.
| Argument | Type | Description |
|---|---|---|
| to | any | |
| from | any | |
| limit | integer | |
| market | any | 터미널 시장 접두어: AJ, AS, BH, BP, CA, DU, HC, HX, MH, NA, NX |
| offset | integer | |
| origin | any | 원산 — 발표된 표기 그대로 정확히 일치 (예: South Korea). 최신 날짜도 이 원산 안에서 잡는다 |
| commodity | any | 승인 범위: Apple Pears, Apples, Chinese Cabbage, Onions, Dry, Potatoes, Tomatoes |
{
"type": "object",
"required": [],
"properties": {
"to": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
{
"type": "null"
}
],
"title": "To"
},
"from": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
{
"type": "null"
}
],
"title": "From"
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 200,
"maximum": 1000,
"minimum": 1
},
"market": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Market",
"description": "터미널 시장 접두어: AJ, AS, BH, BP, CA, DU, HC, HX, MH, NA, NX"
},
"offset": {
"type": "integer",
"title": "Offset",
"default": 0,
"minimum": 0
},
"origin": {
"anyOf": [
{
"type": "string",
"maxLength": 60
},
{
"type": "null"
}
],
"title": "Origin",
"description": "원산 — 발표된 표기 그대로 정확히 일치 (예: South Korea). 최신 날짜도 이 원산 안에서 잡는다"
},
"commodity": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Commodity",
"description": "승인 범위: Apple Pears, Apples, Chinese Cabbage, Onions, Dry, Potatoes, Tomatoes"
}
}
}팜템포가 재배포 승인을 받아 보유한 USDA 산지(shipping point) 리포트와, 품목별 수록 구간.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}리포트·품목마다 가장 최근 리포트 날짜의 행만. ⛔ 산지는 계절 따라 돈다 — 제철이 아닌 산지는 최신 날짜가 몇 달 전일 수 있다. 행마다 report_date 를 읽을 것.
| Argument | Type | Description |
|---|---|---|
| limit | integer | 리포트×품목 한 조합당 행 수 |
| report | any | 리포트: BR_FV110, IF_FV110, IF_FV130, IX_FV120, MB_FV110, OR_FV120, YA_FV110 |
| commodity | any | 승인 범위: Apples, Chinese Cabbage, Onions, Dry, Potatoes, Tomatoes |
{
"type": "object",
"required": [],
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 4,
"maximum": 50,
"minimum": 1,
"description": "리포트×품목 한 조합당 행 수"
},
"report": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Report",
"description": "리포트: BR_FV110, IF_FV110, IF_FV130, IX_FV120, MB_FV110, OR_FV120, YA_FV110"
},
"commodity": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Commodity",
"description": "승인 범위: Apples, Chinese Cabbage, Onions, Dry, Potatoes, Tomatoes"
}
}
}보고된 대로의 산지 FOB 가격 구간. 값은 변형하지 않으며, 행마다 리포트 번호와 리포트 날짜가 붙는다.
| Argument | Type | Description |
|---|---|---|
| to | any | |
| from | any | |
| limit | integer | |
| offset | integer | |
| report | any | 리포트: BR_FV110, IF_FV110, IF_FV130, IX_FV120, MB_FV110, OR_FV120, YA_FV110 |
| commodity | any | 승인 범위: Apples, Chinese Cabbage, Onions, Dry, Potatoes, Tomatoes |
{
"type": "object",
"required": [],
"properties": {
"to": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
{
"type": "null"
}
],
"title": "To"
},
"from": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
{
"type": "null"
}
],
"title": "From"
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 200,
"maximum": 1000,
"minimum": 1
},
"offset": {
"type": "integer",
"title": "Offset",
"default": 0,
"minimum": 0
},
"report": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Report",
"description": "리포트: BR_FV110, IF_FV110, IF_FV130, IX_FV120, MB_FV110, OR_FV120, YA_FV110"
},
"commodity": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Commodity",
"description": "승인 범위: Apples, Chinese Cabbage, Onions, Dry, Potatoes, Tomatoes"
}
}
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 18, 2026.