BadOnion Data

Find HS product codes that actually have data for a reporting country, by keyword or code prefix, with product descriptions. Use the result in 'HS code monthly trade'. HS코드 찾기 수집국 원장에 실제로 데이터가 있는 HS 코드를 품명과 함께 찾습니다. 키워드(q)나 앞자리(prefix)로 거르고, 결과 코드를 그대로 「HS코드 월별 수출입」의 hscode 에 넣으면 됩니다. 원장에는 6자리 이상 코드만 있습니다(4자리 코드는 데이터가 없습니다). 참고: q 는 품명(한글·영문)이나 코드 앞부분에 대한 부분 일치입니다. 같은 나라라도 방향(type)에 따라 있는 코드가 다를 수 있습니다. 코드 목록은 최대 6시간 캐시되어 새 코드는 늦게 보일 수 있습니다. MCP 요령: HS 코드를 모르면 먼저 부른다(q=품명 키워드 또는 prefix=앞자리). 원장은 6자리 이상만 있다. 응답 필드(fields 로 고를 수 있는 data 행 이름): hscode, digits, description

tr_codes

Monthly summed trade value (USD thousand), weight and daily average for one stock trade flow, as shown on BadOnion's stock mapping screen. HS codes are not exposed. 흐름 시계열 한 흐름(종목 × 수집국 × 방향)의 월별 합산 금액·중량·일평균을 돌려줍니다. 종목 맵핑 화면의 흐름 탭이 그리는 것과 같은 시계열입니다. 흐름을 이루는 개별 조건(품목·세관·상대국)은 모두 합산되어 한 계열로만 나가며, 어느 세관·어느 상대국의 값인지는 응답에 없습니다. 참고: 전년비(YoY)는 yoy=1 로 받을 수 있습니다. 3개월 합·단가 값 자체는 응답에 없고 호출 측에서 계산합니다(산식은 「공통 규약」). 최신월 값은 잠정치일 수 있어 재조회 시 바뀌는 것이 정상입니다. 품목별 분해는 API 로 나가지 않습니다. 조회 기간(from~to)은 최대 120개월입니다. (2026-10-19) prelim=1 이면 한국 잠정치를 덧붙입니다. 잠정치는 확정치가 나오면(보통 15일 무렵) 그 달이 확정 최신월 이하가 되어 저절로 빠집니다. 확정치와 값이 다를 수 있습니다. (2026-10-19) yoy=1 이면 전년비(%)를 웹 화면과 같은 식으로 함께 줍니다 — 전체 구간으로 계산한 뒤 기간을 자르므로 첫 해도 채워집니다. (2026-10-19) stock=1 이면 월말 종가를 함께 줍니다 — 주가가 없는 종목은 null. MCP 요령: 기간이 길면 크다 — 필요한 구간만 from/to(YYYY-MM)로. 한국 전국 흐름은 prelim=1 이면 메타 prelim 에 확정 뒤 달 잠정치 점이 따로 온다(data 는 확정치). 전년비는 yoy=1 로 받아 그대로 쓸 것(직접 계산 금지). 사용자에게 flow_id·'흐름' 번호를 보이지 말 것. 주가가 필요하면 stock=1(월말 종가, 오른쪽 별도 축 선 — 무역 금액과 같은 축에 올리지 말 것). [사용자에게 쓰는 말] '종목 맵핑'·'맵핑'·'흐름'·'추적 기준'·flow_id·'시군구 HS6'·'추정모델' 같은 내부 이름과 번호를 답변·차트 제목·출처에 쓰지 말 것 — '○○(회사) 관련 ○○ 지역 ○○ 수출' 처럼 풀어 쓰고 출처는 '나쁜양파(BadOnion)' 한 단어만. 'Actual'·'Calculated'·'Proxy' 꼬리표도 붙이지 말 것. 개념 질문엔 https://badonion.co.kr/help 안내. [차트] 월 금액=막대, 전년비=yoy=1 값 그대로 직선, 주가=stock=1 월말 종가를 별도 축, x축 YYYY-MM, 기본 최근 36개월. 응답 필드(fields 로 고를 수 있는 data 행 이름): date_ym, amount, weight, weight_unit, daily_avg, yoy, weight_yoy, unit_price_yoy, daily_avg_yoy

mp_flow_series

Monthly export or import totals (country-wide, USD thousand) for one or more HS codes of a reporting country (26 economies incl. Korea, US, China, Japan, Taiwan, EU), with weight and unit value where available. HS코드 월별 수출입 한 수집국의 HS 코드에 대한 월별 수출 또는 수입 합계입니다. 무역 일반조회 화면의 메인 차트와 같은 값이며, 국가 전체(WORLD) 합계만 담습니다. 상대국·세관 축은 이 API 에 없습니다. hscode 에 쉼표로 여러 개(최대 50개)를 주면 코드별로 나뉜 시계열을 한 콜에 받을 수 있습니다. 참고: 조회 기간(from~to)은 최대 120개월입니다. from 을 생략하면 2021-01, to 를 생략하면 이번 달까지 조회합니다. hscode 개수 × 조회 개월 수는 최대 6,000을 넘을 수 없습니다(예: 코드 50개면 최장 120개월). ⚠️ 응답 모양이 코드 개수에 따라 달라집니다 — hscode 를 1개만 주면(쉼표 없음) 아래 응답 표 그대로 (hscode·description 은 최상위 문자열, data 는 평평한 배열)이지만, 2개 이상 주면 data 가 { hscode: { description, series[] } } 형태의 객체로 바뀌고 최상위에 hscodes(요청한 코드 배열)가 추가됩니다(hscode 문자열 필드는 이때 응답에 없습니다). 요청한 코드 중 데이터가 없는 코드도 series 가 빈 배열인 채로 키에 포함되며, 전부 빈 경우에만 404 입니다. hscode 를 여러 개 주면 data 가 코드→{description, series[]} 객체이고 fields(예: date_ym,amount)는 각 series 행에 적용됩니다. (2026-10-19) prelim=1 이면 한국 잠정치를 덧붙입니다. 잠정치는 확정치가 나오면(보통 15일 무렵) 그 달이 확정 최신월 이하가 되어 저절로 빠집니다. 확정치와 값이 다를 수 있습니다. (2026-10-19) yoy=1 이면 전년비(%)를 웹 화면과 같은 식으로 함께 줍니다 — 전체 구간으로 계산한 뒤 기간을 자르므로 첫 해도 채워집니다. MCP 요령: hscode 를 쉼표로 최대 50개 한 번에 받는다 — 코드마다 따로 부르지 말 것. 여러 코드면 data 가 코드→{description, series[]} 이고 fields=date_ym,amount 는 각 series 행에 적용된다. 한국(origin=korea)은 prelim=1 이면 확정 최신월 뒤 달에 잠정치 행(prelim 키 — 1~10일·1~20일 Est·월 잠정)이 붙는다. 전년비는 yoy=1 로 받아 그대로 쓸 것(직접 계산 금지) — from 앞 12개월은 서버가 알아서 읽는다. 응답 필드(fields 로 고를 수 있는 data 행 이름): date_ym, amount, weight, weight_unit, prelim, yoy, weight_yoy, unit_price_yoy

tr_series

Quarterly or annual income statement for one company: revenue, cost of revenue, gross profit, operating income, net income, EPS and more, in the company's reported currency. Rows are oldest first; limit=N returns the most recent N periods. 손익계산서 분기 또는 연간 손익계산서입니다 — 매출·매출원가·매출총이익·영업이익·순이익·EPS 등을 전부 돌려줍니다. 참고: 통화는 기업이 신고한 통화 그대로이며 환산하지 않습니다(reported_currency 필드 참조). 시장이 다른 종목을 USD 로 나란히 비교하려면 「재무 요약」을 쓰세요. 행은 오래된 기간부터(오름차순) 옵니다 — 마지막 행이 최신이고 limit=N 은 최근 N개 기간입니다. MCP 요령: 행은 오래된 순(오름차순)이고 limit=N 은 **최근 N개 기간**이다 — 최근 분기 하나는 limit=1, 기간 이름은 year_period(예 2026-Q2). 영업이익률은 operating_income/revenue 로 계산. 응답 필드(fields 로 고를 수 있는 data 행 이름): year_period, report_date, revenue, cost_of_revenue, gross_profit, rd_expenses, sga_expenses, operating_expenses, operating_income, ebitda, ebit, income_before_tax, income_tax_expense, net_income, eps, eps_diluted, shares_out, shares_out_diluted

fin_income

Japanese listed retailers, restaurants and services that publish monthly sales (月次), with sector, scope, history range and headline metric. Filter by q or sector. 일본 월매출 — 회사 목록 월간 매출(月次)을 공시하는 일본 상장사 목록입니다. 회사명(일·한·영)·업종·공시 범위·이력 범위·대표 지표·금액 등급이 나옵니다. 여기서 code 를 받아 「회사별 월 시계열」을 부릅니다. 참고: 웹 화면 목록과 같습니다(월 매출액 막대가 없는 회사는 빠집니다). 전년비 지표는 % 증감(+10.0 = 전년 대비 10% 증가), 금액은 백만 엔(jpy_mn)입니다. 공시 원문 링크·수집처는 싣지 않습니다. MCP 요령: 코드 찾기는 q(회사명 일·한·영). 업종 값 목록이 필요하면 fields=sector 로 받아 중복을 빼거나, 틀린 sector 를 주면 400 allowed 에 전체 목록이 온다. 응답 필드(fields 로 고를 수 있는 data 행 이름): code, name_jp, name_kr, name_en, sector, fiscal_month, scope_label, scope_note, scope_share, first_ym, last_ym, months, headline, amount_tier, est_mape

jm_companies

Monthly series by segment and metric (all-store and same-store sales YoY, customers, average ticket, store count, sales amount) plus quarterly revenue for one company. 일본 월매출 — 회사별 월 시계열 회사 1곳의 세그먼트(total·직영·FC·EC 등) × 지표별 월 시계열을 긴 형식(data[] 한 줄 = 계열 하나)으로 줍니다. 분기 매출 실적(연결·세그먼트)과 금액 추정 정확도가 같이 붙습니다. 전체 합계는 segment='total' 입니다. 참고: 전년비 지표(unit=pct_yoy)는 % 증감입니다. 소스가 「110.0」(전년=100) 형식이어도 +10.0 으로 바꿔 둡니다. sales_amount_derived(분기 역산)는 月次 공시가 빠진 달에만 있고 전년비가 없습니다. 기간 상한은 없으며 from/to 로 좁힐 수 있습니다. MCP 요령: 회사 1곳 월 시계열. 최근 몇 달만이면 from(YYYY-MM), 지표 하나만이면 metric=all_sales(쉼표 허용)·segment=total. fields=metric,ym,value 처럼 주면 계열 안 data 행에도 적용된다. 여러 회사를 같은 지표로 비교할 때는 jm_series 를 쓴다(회사마다 부르지 말 것). 응답 필드(fields 로 고를 수 있는 data 행 이름): segment, metric, unit, data(ym, value, published, note)

jm_company

The same metric's monthly series for up to 60 companies at once, chosen by codes or by sector, to compare peers in one call. 일본 월매출 — 여러 회사 같은 지표 여러 회사(최대 60곳)의 같은 지표 월 시계열을 한 번에 줍니다. 대상은 codes(쉼표) 또는 sector(업종 전체). data[] 한 줄이 회사 하나입니다. 지표가 없는 회사는 missing, 목록에 없는 회사는 unknown 에 code 로 나옵니다. 참고: metric 생략 시 회사마다 대표 지표가 달라 단위(pct_yoy·jpy_mn)가 섞일 수 있습니다 — 비교하려면 metric=all_sales 처럼 지정하세요. 기간 상한은 없으니 from 으로 좁히는 것을 권장합니다. 업종이 60곳을 넘으면 400 이며 codes 로 나눠 부릅니다. MCP 요령: 여러 회사 비교는 이 도구 1번으로 — codes=9983,3382 또는 sector=드럭스토어. 비교하려면 metric=all_sales 로 지표를 고정하고 from=YYYY-MM 으로 최근 몇 달만. fields=code,name_kr,data 로 줄일 수 있다. 응답 필드(fields 로 고를 수 있는 data 행 이름): code, name_jp, name_kr, name_en, sector, segment, metric, unit, data(ym, value, published, note)

jm_series

Latest monthly release for every company: headline metric value (usually all-store sales YoY %), 3-month average and same-store/customer/ticket figures. Filter, sort and pick fields. 일본 월매출 — 최신월 표 전 회사의 최신 공시월 한 줄씩입니다. 대표 지표(headline)의 최신값·직전 3개월 평균·발표일과 같은 달의 보조 지표(기존점 전년비·매출액·객수·객단가)가 붙습니다. 참고: 회사마다 최신월이 다릅니다(결산·발표일이 제각각). value·avg3 의 단위는 행의 unit 을 따릅니다(pct_yoy = % 증감). MCP 요령: 전 회사 약 200행이라 무겁다. sector(업종 값은 jm_companies fields=sector)나 q 로 좁히고 fields=code,name_kr,sector,ym,headline,unit,value,avg3 로 줄인다. 전년비와 금액이 섞이지 않게 unit=pct_yoy(또는 jpy_mn), 순위는 sort=value. 이 표는 회사별 대표 지표(headline) 하나만 — 다른 지표는 jm_company. 응답 필드(fields 로 고를 수 있는 data 행 이름): code, name_jp, name_kr, name_en, sector, scope_label, scope_share, ym, headline, unit, value, avg3, published, existing_sales, sales_amount, existing_customers, existing_avg_spend

jm_latest

이 MCP 키의 오늘·이번 달 호출량과 한도(분당·일·월)를 돌려준다. 쿼터를 소모하지 않는다.

get_mcp_usage

Korea's yearly and monthly share of each import market for one product. Use view=summary for yearly figures only. 품목별 시장 점유율 - 품목 1개 상세 매핑이 없거나 데이터가 없는 시장도 행을 만들되 disabled 사유를 싣습니다 - 빼 버리면 품목마다 시장 수가 달라져 왜 미국이 빠졌는지 알 수 없기 때문입니다. korea_only=true 인 칸은 경쟁자가 없어 100% 인 것이라 일반적 점유율 해석과 다릅니다. 참고: 매핑이 없거나 데이터가 없는 시장도 행을 만들되 disabled 사유를 싣습니다 - 빼 버리면 품목마다 시장 수가 달라져 왜 미국이 빠졌는지 알 수 없기 때문입니다. korea_only=true 인 칸은 경쟁자가 없어 100% 인 것이라 일반적 점유율 해석과 다릅니다. 배열 대응: markets[].shares·world·korea 는 data.years 순서(연도별), *_m 과 data.kr_export_m 은 data.months(YYYYMM) 순서(월별)입니다. MCP 요령: key 는 ms_items 에서. 연도별 점유율만이면 view=summary(월별 배열 빼고 2KB 안팎). markets[].shares·world·korea 는 data.years 순서, *_m 과 kr_export_m 은 data.months 순서. 응답 필드(fields 로 고를 수 있는 data 행 이름): kr_export_m, legacy, years, months, markets(origin, label, source, latest_ym, window, disabled, partial, korea_only, shares, world, korea, shares_m, world_m, korea_m, ref_m, ref_until)

ms_item

Curated products with Korea's share of each major import market. Search with q and sort by share; HS codes are not exposed. 품목별 시장 점유율 - 품목 목록 평면 목록입니다(HS6 계층 없음). HS 코드는 이 API 어디에도 없습니다(요청해도 실리지 않습니다 - 웹의 SHOW_HS_CODES 스위치와 무관하게 항상 꺼져 있습니다). 확정된 세부코드 매핑이 없는 시장은 그 품목의 shares 에 그 시장 키 자체가 없습니다(0% 가 아니라 모름). 시장이 너무 작거나 최근 12개월 한국 실적이 없으면 그 시장도 제외됩니다. MCP 요령: q 로 품목을 찾고 key 로 ms_item. 전체 표는 fields=key,name,kr_export,shares,top 로 가볍게 받는다(약 380행이라 그래도 두 번에 나눠 올 수 있다 — mcp_next_offset 을 _offset 에 넣어 이어 받기). 응답 필드(fields 로 고를 수 있는 data 행 이름): key, name, companies, tickers, company_chips(ticker, name), stock_count, kr_export, shares, top

ms_items

Import markets (US, China, EU, Japan) used for Korea's product market share, with each market's latest month. 품목별 시장 점유율 - 시장 목록 점유율 = 그 시장의 수입 원장 안에서 한국(상대국) 나누기 전체(WORLD) 입니다. 시장마다 자기 기준월을 따로 갖습니다 - 고정 기준월이 아니라 window(1~N월) 안에서 동기 비교합니다. 등급 제한이 없습니다(Korea Only 포함 전 유료 등급에 열린 화면과 같은 규약, 웹 모듈 docstring 참조). 응답 필드(fields 로 고를 수 있는 data 행 이름): origin, label, source, latest_ym, window, digits, n_codes

ms_markets

Korea's share for one product in one market, split into that market's detailed tariff lines (descriptions only, no codes). 품목별 시장 점유율 - 세부코드 분해 그 나라 최대 자릿수(미국 HTS10 · 일본 HS9 · 유럽 CN8 · 중국 HS8) 코드 단위로 쪼갭니다. HS6 합계 행과 세부코드 행이 원장에 둘 다 있어 섞으면 이중계상되므로 한 레벨만 씁니다. 코드 숫자는 항상 없고 name(원문 품명·순번 폴백)과 rid(이 응답 안에서만 유효한 순번)로만 구분합니다. 응답 필드(fields 로 고를 수 있는 data 행 이름): years, months, rows(name, name_src, curated, rid, world, korea, shares, world_m, korea_m, shares_m), total, narrowed, n_codes_used

ms_breakdown

Reporting countries available in the by-partner trade view, with each country's latest month and number of registered items. 국가별 조회 — 수집국 목록 기준월(latest_ym)이 잡힌(수집이 끝난) 나라만 나갑니다. 등급 제한이 없습니다(기관 API 는 웹의 Korea Only 축과 무관하게 전 국가를 봅니다). MCP 요령: pt_items 의 origin 값 목록. 응답 필드(fields 로 고를 수 있는 data 행 이름): origin, label, latest_ym, update_note, counts

pt_origins

World total plus monthly series by trading partner for one curated item. Use top=N to keep only the largest partners. 국가별 조회 — 품목 1개 상세 전체(WORLD) 합계 + 상대국별 월 시계열을 함께 줍니다. 상대국 코드는 그 나라 소스의 코드 체계(예 ISO2)이며 HS 코드가 아닙니다 — 이 API 는 HS 코드를 어디에도 싣지 않습니다. 중량은 품목의 모든 행이 한 단위일 때만 실립니다(단위가 섞이면 weight_unit·weights 전부 null). 상대국이 많은 품목은 응답이 수십 KB 를 넘습니다 — top=N(상위 N개 + 기타 합산)이나 view=summary(요약만)로 줄이세요. 참고: 전체(WORLD) 합계 + 상대국별 월 시계열을 함께 줍니다. 상대국 코드는 그 나라 소스의 코드 체계(예 ISO2)이며 HS 코드가 아닙니다 — 이 API 는 HS 코드를 어디에도 싣지 않습니다. 중량은 품목의 모든 행이 한 단위일 때만 실립니다(단위가 섞이면 weight_unit·weights 전부 null). 상대국이 많은 품목은 응답이 수십 KB 를 넘습니다 — top=N(상위 N개 + 기타 합산)이나 view=summary(요약만)로 줄이세요. (2026-10-19) prelim=1 이면 한국 잠정치를 덧붙입니다. 잠정치는 확정치가 나오면(보통 15일 무렵) 그 달이 확정 최신월 이하가 되어 저절로 빠집니다. 확정치와 값이 다를 수 있습니다. MCP 요령: 상대국 약 45개 × 68개월이라 크다(큰 품목은 60K 를 넘어 실패). 상위 상대국만이면 top=10(나머지는 partners_others 한 행으로 합산), 최근값·YoY·YTD 만이면 view=summary — 둘을 같이 써도 된다. 전체 합계만이면 fields=world,months. 한국 품목은 prelim=1 이면 data.prelim 에 잠정 합계·상대국별 잠정값·달별 점. 응답 필드(fields 로 고를 수 있는 data 행 이름): months, legacy, weight_unit, world_undisclosed, world, partners(code, name, values, weights, summary), partners_total, partners_others, prelim

pt_item

Curated product items for a reporting country with latest-month value, MoM/YoY and year-to-date growth. Search with q; HS codes are not exposed. 국가별 조회 — 품목 표 품목은 큐레이터가 등록한 「합산 HS코드」 묶음이며 **HS 코드 자체는 응답에 없습니다**. 품목끼리 더하지 마십시오(코드가 겹칠 수 있어 시트가 합계 행을 아예 안 줍니다). 비공개(undisclosed) 달은 관련 필드가 0 이 아니라 null 입니다 — 0 으로 채우면 YoY 가 -100% 로 오독됩니다. 참고: 품목은 큐레이터가 등록한 「합산 HS코드」 묶음이며 **HS 코드 자체는 응답에 없습니다**. 품목끼리 더하지 마십시오(코드가 겹칠 수 있어 시트가 합계 행을 아예 안 줍니다). 비공개(undisclosed) 달은 관련 필드가 0 이 아니라 null 입니다 — 0 으로 채우면 YoY 가 -100% 로 오독됩니다. (2026-10-19) prelim=1 이면 한국 잠정치를 덧붙입니다. 잠정치는 확정치가 나오면(보통 15일 무렵) 그 달이 확정 최신월 이하가 되어 저절로 빠집니다. 확정치와 값이 다를 수 있습니다. MCP 요령: 품목 1개를 찾을 땐 q(품목명·기업명·티커). 표 전체는 fields=key,name,tickers,cur,yoy,mom,ytd_yoy,l12_yoy 로 받는다(spark·company_chips·yearly 는 차트용이라 무겁다). 한국은 prelim=1 이면 메타 prelim.items 에 품목별 잠정 금액·전년비(이 응답의 품목만). 응답 필드(fields 로 고를 수 있는 data 행 이름): key, name, aliases, tickers, companies, company_chips(ticker, name), stock_count, cur, prev_year, yoy, prev_month, mom, ytd, ytd_prev, ytd_yoy, l12, l12_prev, l12_yoy, yearly, spark, undisclosed, legacy

pt_items

List producer price index series for a country (US, Korea, Japan, China, EU): series id, title and base year. Search by keyword or series id (e.g. PPIACO). 지표 목록 어떤 물가 지표가 있는지 찾습니다. 나라를 고르면 그 나라의 지표 코드와 이름, 기준연도를 돌려줍니다. 여기서 얻은 코드를 「지표 월별 값」에 넣어 실제 수치를 받습니다. 참고: 검색어(q) 없이 부르면 최대 500개까지만 옵니다(응답에 truncated=true). 원하는 지표가 안 보이면 q 로 좁히세요. MCP 요령: q 는 series_id·제목 부분일치(예 q=PPIACO). q 없이는 500개까지만 온다(미국은 약 7,900개) — 모르면 offset/limit. series_id 를 골라 ppi_observations 로. 응답 필드(fields 로 고를 수 있는 data 행 이름): series_id, title, units, frequency, group_name, observation_start

ppi_series

Monthly values and year-over-year change for up to 50 price index series ids from 'Price index list'. Use last=N for the latest N months. 지표 월별 값 지표 코드를 주면 그 지표의 월별 수치와 전년동월비를 돌려줍니다. 코드는 「지표 목록」에서 얻습니다. 한 번에 최대 50개 지표까지 묶어 받을 수 있습니다. 참고: 전년동월비는 받아 온 구간 안에서 계산합니다 — from 이후 첫 12개월은 null 이니, 최신 전년비만 필요하면 last=N 을 쓰거나 from 을 원하는 첫 달보다 13개월 이상 앞당기세요(예: 2026-01 의 전년비 → from=2024-12). from/to 를 생략하면 최근 60개월이 옵니다. 기간은 최대 120개월, (지표 수 × 개월 수)는 6,000 이하입니다. MCP 요령: series_ids 를 쉼표로 여러 개 한 번에. 전년비(yoy)는 조회 구간 안에서만 계산돼 from 이후 첫 12개월은 null — 최신 전년비만이면 last=3 처럼 last=N(최근 N개, 전년비 채움)을 쓰고, from 을 쓸 땐 원하는 첫 달보다 13개월 이상 앞으로(예: 2026-01 전년비 → from=2024-12). 응답 필드(fields 로 고를 수 있는 data 행 이름): date, value, yoy

ppi_observations

Full body of one published research post as HTML, markdown or plain text. 발행글 본문 한 게시글의 본문입니다. 본문은 큐레이터가 마크다운으로 쓴 글을 렌더한 HTML(또는 format 에 따라 마크다운·텍스트)이며, 조회수는 올리지 않습니다. 참고: 게시글 본문은 재배포 금지 대상입니다(이용약관). 호출은 로그에 남습니다. 응답 필드(fields 로 고를 수 있는 data 행 이름): id, title, summary, category, published_at, cover_url, content, format, files(filename, size_bytes)

bd_post

List BadOnion's published research reports and magazine posts (title, summary, date). 발행글 목록 발행된 게시글(리포트·매거진)의 목록입니다. 웹 게시판 목록과 같은 메타이고, API 구독에는 등급글 잠금이 없어 발행글 전량이 열립니다. 초안·미발행은 나가지 않습니다. MCP 요령: 주제로 찾을 땐 q, 최근 글만이면 limit. total 은 조건(q·category·since)에 맞는 발행글 전체 수(페이지 무관), count 는 이번에 받은 행 수. 본문은 bd_post. 응답 필드(fields 로 고를 수 있는 data 행 이름): id, title, summary, category, visibility, cover_url, published_at, updated_at

bd_posts

Revenue broken down by product line or by geography for one company, by period. 매출 분해 제품별 또는 지역별 매출 분해입니다. 참고: 환산이 없습니다 — 소스 통화 그대로입니다(일본은 JPY, 중국·홍콩은 현지통화). 음수 항목은 Eliminations & Adjustments 하나로 합쳐지는 표시 가공이라 원장과 항목 수가 다를 수 있습니다. 행은 오래된 기간부터(오름차순) 옵니다 — 마지막 행이 최신입니다. MCP 요령: 행은 오래된 순(오름차순)이고 limit 이 없다 — 최근 분기만이면 _offset 으로 뒤쪽을 받거나 fields 로 가볍게. 응답 필드(fields 로 고를 수 있는 data 행 이름): period, report_date, total, items

fin_segments

List the published trade flows (stock x reporting country x export/import direction) mapped to a listed company, with each flow's id, name and latest data month. Use the flow id with 'Flow monthly series'. 종목별 흐름 목록 한 종목의 발행 흐름 목록입니다. 흐름 = 종목 × 수집국 × 방향. 화면의 흐름 탭과 추적 요약 카드가 보여주는 메타와 같습니다. 품목 코드·세관 코드·상대국 코드는 응답에 없고 이름·개수만 나갑니다. 참고: 흐름 안의 개별 조건(품목·세관·상대국)은 어떤 형태로도 나가지 않습니다. 이 규칙은 웹 화면과 같습니다. MCP 요령: 종목의 흐름 목록(flow_id)만 준다 — 시계열은 mp_flow_series 에 flow_id 를 넣어 받는다. 목록은 fields=id,flow_name,trade_type,data_max_ym 이면 가볍다. [사용자에게 쓰는 말] '종목 맵핑'·'맵핑'·'흐름'·'추적 기준'·flow_id·'시군구 HS6'·'추정모델' 같은 내부 이름과 번호를 답변·차트 제목·출처에 쓰지 말 것 — '○○(회사) 관련 ○○ 지역 ○○ 수출' 처럼 풀어 쓰고 출처는 '나쁜양파(BadOnion)' 한 단어만. 'Actual'·'Calculated'·'Proxy' 꼬리표도 붙이지 말 것. 개념 질문엔 https://badonion.co.kr/help 안내. 응답 필드(fields 로 고를 수 있는 data 행 이름): id, flow_name, origin, origin_label, trade_type, source, product, rationale, grades, verdict, verified_on, region(name), region_axis_label, partners(name), cond_count, data_max_ym

mp_flows

List supply-chain dashboard cards (inventory, lead times, prices, price indexes) with card id, section, title and latest date, to pick cards for the other supply tools. 공급망 — 탭·카드 목록 웹 /supply 화면 4개 탭의 카드 목록을 값 없이 줍니다(가벼운 탐색용). 여기서 card_id·section 을 받아 탭별 경로(/supply/inventory · /supply/leadtime · /supply/prices · /supply/price-index)로 값을 받습니다. tab 을 주면 그 탭만 나옵니다. 참고: 웹 등급(Essential·Premium)과 무관하게 4개 탭 전부 실데이터입니다. 데이터 수집처 이름은 응답에 싣지 않습니다. 첫 호출은 탭을 만드느라 수 초 걸릴 수 있습니다(이후 10분 캐시). MCP 요령: 어디에 무엇이 있나 — sp_prices(품목별 가격 동향): GPU 임대 지수·CPU 가격·메모리 가격(DRAM·NAND·SSD)·광모듈 판매가·전력·에너지·서버·반도체·수동부품·냉각 / sp_price_index(공식 물가지수): 반도체·전자부품·서버·전력 장비·금속·석유화학·자동차 등 생산자물가 계열 / sp_leadtime: 부품 리드타임(일반·고신뢰 · 콘덴서·저항 등, 메모리) / sp_inventory: 재고·단가·가동률(소재·웨이퍼·기판·반도체소자·광통신 등). tab 값은 inventory | leadtime | prices | price-index (하이픈). tab 으로 한 탭만, fields=card_id,section,title,last_date 로 가볍게 받는다. 응답 필드(fields 로 고를 수 있는 data 행 이름): tab, tab_name, card_id, section, title, unit, last_date

sp_catalog

Inventory, inventory-to-sales, unit price and utilization series for materials and electronic components. view=summary returns the latest values only. 공급망 — 재고·단가·가동률 품목 1개 = 카드 1개입니다. section 은 품목군(소재·부품 등), 지표(생산량·재고량·재고월수·단가·가동률 등)는 계열(series[])로 나오며 계열마다 key·unit·yoy(전년 동월비 %) 가 붙습니다. 지표마다 단위가 달라 카드의 unit 은 null 일 수 있습니다. 월간입니다. card(쉼표)·section 으로 거를 수 있습니다. 참고: 색·선 굵기 같은 화면 전용 값과 카드 주석은 빠집니다. 데이터 수집처 이름은 싣지 않습니다. 탭 전체는 수백 KB 이므로 「탭·카드 목록」에서 card_id 를 골라 card 로 좁히는 것을 권장합니다. 날짜 축은 카드마다 월간·주간·일간이 섞여 있습니다. 응답이 크면 view=summary(계열마다 마지막 값만) · section(섹션 하나) · last(계열마다 최근 N점)로 줄이십시오. view=summary 는 series 대신 series_latest 를 돌려줍니다. 주의: view=summary 에 from/to/last 를 함께 줘도 table 은 미리 계산된 값이라 기간에 따라 바뀌지 않습니다(series_latest·last_date 만 잘린 범위 기준). 월간 카드(x=YYYY-MM)는 접두 비교라 일 단위(YYYY-MM-DD)로 주면 그 달 점이 빠집니다 — 월간 카드까지 보려면 YYYY-MM 으로. MCP 요령: 동향·최신값만 필요하면 view=summary(탭 전체가 한 번에 온다, table 에 최신값·변화). 시계열은 card(sp_catalog 의 card_id) + last=N 또는 from/to. 탭 전체 시계열(view=full, card 없음)은 수백 KB 라 부르지 말 것. from 을 일 단위(YYYY-MM-DD)로 주면 x 가 YYYY-MM 인 월 카드는 접두 비교라 그 달 점이 빠진다 — 월 카드까지 보려면 from 을 YYYY-MM 으로. 1개월 변화는 view=summary 의 series_latest[].chg_1m(%). 응답 필드(fields 로 고를 수 있는 data 행 이름): card_id, tab, section, title, unit, series(name, x, y, key, unit, yoy), series_latest(name, key, unit, x, y, yoy, chg_1m, chg_1m_x), last_date, table

sp_inventory

Electronic component lead times in weeks by market and commodity, plus memory lead times. view=summary returns the latest values only. 공급망 — 품목별 리드타임 전자부품 리드타임(주)입니다. 시장·품목군 카드는 section 이 「시장 · 품목군」(예: 일반(상업용) · 콘덴서)이고 주간이며, market·commodity·summary(중앙값 요약)와 「중앙값」 계열이 붙습니다. section 「메모리」 카드 2장은 메모리 전체 리드타임(mem-all, 월간)과 품목별 리드타임(mem-dram-gen — 최신값 latest[] 와 평시 기준선 normal_weeks, 표에 d1·d1_from(바로 앞 수집일 대비))입니다. card(쉼표)·section 으로 거를 수 있습니다. 참고: 색·선 굵기 같은 화면 전용 값과 카드 주석은 빠집니다. 데이터 수집처 이름은 싣지 않습니다. 탭 전체는 수백 KB 이므로 「탭·카드 목록」에서 card_id 를 골라 card 로 좁히는 것을 권장합니다. 날짜 축은 카드마다 월간·주간·일간이 섞여 있습니다. 응답이 크면 view=summary(계열마다 마지막 값만) · section(섹션 하나) · last(계열마다 최근 N점)로 줄이십시오. view=summary 는 series 대신 series_latest 를 돌려줍니다. 주의: view=summary 에 from/to/last 를 함께 줘도 table 은 미리 계산된 값이라 기간에 따라 바뀌지 않습니다(series_latest·last_date 만 잘린 범위 기준). 월간 카드(x=YYYY-MM)는 접두 비교라 일 단위(YYYY-MM-DD)로 주면 그 달 점이 빠집니다 — 월간 카드까지 보려면 YYYY-MM 으로. MCP 요령: 동향·최신값만 필요하면 view=summary(탭 전체가 한 번에 온다, table 에 최신값·평시 대비). 시계열은 card(sp_catalog 의 card_id) + last=N 또는 from/to, 구역은 section. 탭 전체 시계열은 부르지 말 것. from 을 일 단위(YYYY-MM-DD)로 주면 x 가 YYYY-MM 인 월 카드는 접두 비교라 그 달 점이 빠진다 — 월 카드까지 보려면 from 을 YYYY-MM 으로. 1개월 변화는 view=summary 의 series_latest[].chg_1m(%). 응답 필드(fields 로 고를 수 있는 data 행 이름): card_id, tab, section, title, unit, series(name, x, y), series_latest(name, key, unit, x, y, yoy, chg_1m, chg_1m_x), last_date, table, market, commodity, summary, summary_text, latest(name, value, range, date), normal_weeks

sp_leadtime

Official producer and export price index series for semiconductors, servers, power equipment, metals, chemicals and more. view=summary returns latest values only. 공급망 — 품목별 가격지수 공식 물가·수출물가 지수 카드입니다(실제 판매가는 「품목별 가격 동향」). card_id 는 섹션+제목 해시(pi- + 10자)입니다. 월간입니다. card(쉼표)·section 으로 거를 수 있습니다. 참고: 색·선 굵기 같은 화면 전용 값과 카드 주석은 빠집니다. 데이터 수집처 이름은 싣지 않습니다. 탭 전체는 수백 KB 이므로 「탭·카드 목록」에서 card_id 를 골라 card 로 좁히는 것을 권장합니다. 날짜 축은 카드마다 월간·주간·일간이 섞여 있습니다. 응답이 크면 view=summary(계열마다 마지막 값만) · section(섹션 하나) · last(계열마다 최근 N점)로 줄이십시오. view=summary 는 series 대신 series_latest 를 돌려줍니다. 주의: view=summary 에 from/to/last 를 함께 줘도 table 은 미리 계산된 값이라 기간에 따라 바뀌지 않습니다(series_latest·last_date 만 잘린 범위 기준). 월간 카드(x=YYYY-MM)는 접두 비교라 일 단위(YYYY-MM-DD)로 주면 그 달 점이 빠집니다 — 월간 카드까지 보려면 YYYY-MM 으로. MCP 요령: GPU 임대·메모리 시세는 여기가 아니라 sp_prices 다. 동향·최신값만 필요하면 view=summary(탭 전체가 한 번에 온다). 시계열은 card(sp_catalog 의 card_id) + last=N 또는 from/to. 탭 전체 시계열은 부르지 말 것. from 을 일 단위(YYYY-MM-DD)로 주면 x 가 YYYY-MM 인 월 카드는 접두 비교라 그 달 점이 빠진다 — 월 카드까지 보려면 from 을 YYYY-MM 으로. 1개월 변화는 view=summary 의 series_latest[].chg_1m(%). 응답 필드(fields 로 고를 수 있는 data 행 이름): card_id, tab, section, title, unit, series(name, x, y), series_latest(name, key, unit, x, y, yoy, chg_1m, chg_1m_x), last_date, table

sp_price_index

Market prices for GPU rental, CPUs, DRAM/NAND/SSD memory, optical modules, power and server components. view=summary returns latest values with 1-month change. 공급망 — 품목별 가격 동향 GPU 임대가·CPU·메모리·광모듈 판매가·전력·서버·수동부품 등 실제 판매가 카드입니다. 카드에 고유 id 가 없어 card_id 는 섹션+제목 해시(px- + 10자)입니다. 일부 카드는 차트가 지수이고 표가 실제 가격이라 table_unit 과 alt(실제 가격 계열)가 붙습니다. 날짜 축은 카드마다 일간·월간이 섞여 있습니다. card(쉼표)·section 으로 거를 수 있습니다. 참고: 색·선 굵기 같은 화면 전용 값과 카드 주석은 빠집니다. 데이터 수집처 이름은 싣지 않습니다. 탭 전체는 수백 KB 이므로 「탭·카드 목록」에서 card_id 를 골라 card 로 좁히는 것을 권장합니다. 날짜 축은 카드마다 월간·주간·일간이 섞여 있습니다. 응답이 크면 view=summary(계열마다 마지막 값만) · section(섹션 하나) · last(계열마다 최근 N점)로 줄이십시오. view=summary 는 series 대신 series_latest 를 돌려줍니다. 주의: view=summary 에 from/to/last 를 함께 줘도 table 은 미리 계산된 값이라 기간에 따라 바뀌지 않습니다(series_latest·last_date 만 잘린 범위 기준). 월간 카드(x=YYYY-MM)는 접두 비교라 일 단위(YYYY-MM-DD)로 주면 그 달 점이 빠집니다 — 월간 카드까지 보려면 YYYY-MM 으로. MCP 요령: GPU 임대 지수·CPU·메모리 시세는 이 도구(section=GPU 임대 · CPU 가격 · 메모리 가격). 동향·최신값만 필요하면 view=summary(탭 전체가 한 번에 온다, table 에 최신값·변화). 시계열은 card(sp_catalog 의 card_id) + last=N 또는 from/to — 일별 카드는 1장이 5만 자가 넘는다. 탭 전체 시계열(view=full, card 없음)은 부르지 말 것. from 을 일 단위(YYYY-MM-DD)로 주면 x 가 YYYY-MM 인 월 카드는 접두 비교라 그 달 점이 빠진다 — 월 카드까지 보려면 from 을 YYYY-MM 으로. 1개월 변화 순위는 view=summary 의 series_latest[].chg_1m(%, 기준점 chg_1m_x: 일·주간은 마지막 날 −30일 이전의 마지막 점, 월간은 직전 달) 로 정렬 — fields=card_id,title,series_latest 면 탭 전체가 한 번에 온다. 마지막 점 x 가 오래된(한 달 넘게 갱신 없는) 계열은 「최근 1개월」 순위에서 뺄 것. 응답 필드(fields 로 고를 수 있는 data 행 이름): card_id, tab, section, title, unit, series(name, x, y), series_latest(name, key, unit, x, y, yoy, chg_1m, chg_1m_x), last_date, table, table_unit, alt

sp_prices

Monthly revenue history (TWSE filings, NT$ thousand) of a Taiwan-listed company with YoY and year-to-date figures. 종목별 월매출 한 종목의 월매출 전 기간(2020-01~)입니다. 카드 클릭 시 열리는 상세와 같습니다. 참고: 조회 기간(from~to)은 최대 120개월입니다. 둘 다 생략하면 전체 기간을 반환합니다. MCP 요령: 최근 몇 달만 필요하면 from/to(YYYY-MM)로 좁힌다. 응답 필드(fields 로 고를 수 있는 data 행 이름): ym, revenue, revenue_ly, yoy, acc, acc_ly, acc_yoy

tw_revenue