# Korea MFDS Functional Cosmetics & OEM Ingredient API (`maitreya_buddha/korea-mfds-functional-cosmetics-oem`) Actor

Extract official South Korea MFDS functional cosmetics (기능성화장품) reported and reviewed approvals: product names, OEM/ODM manufacturers, SPF/PA ratings, whitening/anti-wrinkle claims, and active ingredients in JSON/CSV. $2.00 / 1K, no proxy needed.

- **URL**: https://apify.com/maitreya_buddha/korea-mfds-functional-cosmetics-oem.md
- **Developed by:** [BoGeun Kim](https://apify.com/maitreya_buddha) (community)
- **Categories:** E-commerce, Business, Lead generation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 1,000 functional cosmetic records

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Korea MFDS Functional Cosmetics & OEM/ODM DB (K-Beauty MCP)

Search **219,000+ official South Korea MFDS functional cosmetic filings** — covering both **Reported Products** (`data.go.kr/15095680`, 198,000+ records) and **Reviewed Base Formulas** (`data.go.kr/15056939`, 20,800+ records) — with **automatic cross-API OEM/ODM resolution** to reveal the Korean contract manufacturers (Cosmax, Kolmar Korea, Cosmecca Korea, GreenCos, etc.) behind K-Beauty brands.

Built for **K-Beauty importers, brand/product R\&D teams, OEM/ODM sourcing, Amazon/TikTok Shop compliance, and AI agents (MCP)**.

> **K-Beauty Regulatory MCP Suite**: Pair this Actor with [**Korea MFDS Cosmetic Recalls & Suspensions**](https://apify.com/maitreya_buddha/korea-mfds-cosmetic-recalls) to audit both **official functional approvals/OEM origin** and **safety recall status** in one automated pipeline.

### Key Features

- **Dual Official MFDS Registries (219k+ Records)**: Queries both `FtnltCosmRptPrdlstInfoService01` (Reported) and `FtnltCosmSrngPrdlstInfoService05` (Reviewed) in one unified schema.
- **Hidden OEM/ODM Auto-Resolution**: In raw MFDS reported data, domestic OEM manufacturer fields are blank (`null`). This Actor automatically joins each reported product's `ITEM_SEQ` against the Reviewed Base Formula registry (with caching) to reveal the underlying **OEM/ODM formula owner** (`oemManufacturer`, `baseFormulaName`).
- **XML/CDATA Parsing + SPF/PA Extraction**: Cleanly strips MFDS XML wrappers (`EE_DOC_DATA`, `UD_DOC_DATA`, `NB_DOC_DATA`) and extracts normalized `spf` (`SPF50+`), `pa` (`PA++++`), and English `functionalClaims` tags (`whitening`, `anti-wrinkle`, `uv-protection`, `hair-loss-relief`, `acne-relief`, `water-resistant`).
- **Newest-First Smart Pagination**: Raw MFDS APIs return 2004/2008 filings on page 1. This Actor probes `totalCount` and streams **latest 2026 filings first** by default (`sortOrder: "newest"`).
- **Pay-per-Event Billing**: Charged only for saved records (`cosmetic-item`), with automatic stop when `maxTotalChargeUsd` budget limit is reached.

### Usage Tips for Global Users & AI Agents (MCP)

> **Language Note**: Official MFDS product and company names are recorded in Korean. Pass **Korean keywords** for `productName` (e.g., `"선크림"`, `"세럼"`), `brandOrDistributor` (e.g., `"아모레퍼시픽"`, `"에이피알"`), or `oemManufacturer` (e.g., `"코스맥스"`, `"한국콜마"`). For `efficacyKeyword`, **both Korean and English tags work** (e.g., `"자외선"`, `"미백"`, `"SPF"`, `"whitening"`, `"uv-protection"`, `"hair-loss"`). Omit filters (`{ "maxItems": 20 }`) to retrieve the latest K-Beauty functional filings.

### Input Parameters

| Field | Type | Default | Description |
| --- | --- | --- | --- |
| `datasetType` | string | `"reported"` | `"reported"` (198k+ brand filings), `"reviewed"` (20k+ OEM base formulas), or `"both"` |
| `productName` | string | - | Server-side partial-match product search (Korean keywords for fastest results) |
| `brandOrDistributor` | string | - | Partial-match filter for brand / responsible seller |
| `oemManufacturer` | string | - | Partial-match filter for OEM/ODM manufacturer (e.g. `"코스맥스"`, `"한국콜마"`) |
| `efficacyKeyword` | string | - | Korean or English claim filter (e.g. `"미백"`, `"SPF"`, `"uv-protection"`, `"anti-wrinkle"`) |
| `itemCode` | string | - | Exact MFDS `ITEM_SEQ` or `COSMETIC_REPORT_SEQ` lookup |
| `sortOrder` | string | `"newest"` | `"newest"` (latest 2026 filings first) or `"oldest"` |
| `resolveOemFromReviewed` | boolean | `true` | Auto-join `ITEM_SEQ` to reveal hidden OEM/ODM owners for reported products |
| `maxItems` | integer | `50` | Maximum records to return (`1`–`1000`) |
| `maxPagesToScan` | integer | `30` | Page scan safety cap per dataset (`1`–`200`, 100 rows/page) |

### Output Example (with Cross-API OEM/ODM Resolution)

```json
{
  "filingType": "reported",
  "productName": "리쥬랩리페어톤업선크림",
  "brandOrDistributor": "주식회사빌리바이브",
  "oemManufacturer": "코스맥스(주)",
  "oemResolutionMethod": "cross-api-item-seq",
  "businessNumber": "6158701059",
  "functionalClaims": ["whitening", "anti-wrinkle", "uv-protection"],
  "efficacy": "피부의 미백에 도움을 준다. 피부의 주름개선에 도움을 준다. 자외선으로부터 피부를 보호한다.(SPF50+,PA++++)",
  "spf": "SPF50+",
  "pa": "PA++++",
  "waterResistant": null,
  "usageMethod": "본품 적당량을 취해 피부에 골고루 펴 바른다.",
  "precautions": "1. 화장품 사용 시 또는 사용 후 직사광선에 의하여...",
  "filingDate": "2026-10-19",
  "itemCode": "2026031035",
  "reportCode": "2026031035",
  "baseFormulaCode": "202301152",
  "baseFormulaName": "트리플타이탄섬머선로션",
  "productPh": "7.5",
  "reportCategory": "제조",
  "manufacturingCountry": null,
  "shelfLife": null,
  "packagingUnit": null,
  "isCanceled": false,
  "source": "MFDS (data.go.kr/15095680)",
  "fetchedAt": "2026-11-20T14:37:59.613Z"
}
```

***

### 한국어 요약 (Korean Summary)

한국 식약처(MFDS) 공공데이터 \*\*기능성화장품 보고품목(15095680, 약 19.8만 건)\*\*과 **심사품목(15056939, 약 2만 건)** 두 공식 API를 통합 조회해 영문 정규화 JSON으로 반환하는 K-Beauty MCP Actor입니다. 보고품목에 숨겨진 `ITEM_SEQ`를 심사품목 API와 자동 교차 조인해 \*\*실제 OEM/ODM 제조사(코스맥스·한국콜마·코스메카 등)\*\*를 추적하고, XML 효능 문서에서 **SPF/PA 수치와 영문 기능성 태그**를 자동 추출합니다.

# Actor input Schema

## `datasetType` (type: `string`):

Which MFDS functional cosmetic registry to query: 'reported' (198k+ brand/OEM reports), 'reviewed' (20k+ MFDS-reviewed base formulas), or 'both' (조회 대상).

## `productName` (type: `string`):

Server-side partial-match filter for product name; use Korean keywords (e.g., '선크림', '세럼', '앰플') for fastest lookup (품목명 검색).

## `brandOrDistributor` (type: `string`):

Partial-match filter for the brand or responsible seller company name (e.g., '아모레퍼시픽', '엘지생활건강', '에이피알', '올리브영') (책임판매업자/업체명).

## `oemManufacturer` (type: `string`):

Partial-match filter for OEM/ODM manufacturer or base formula owner (e.g., '코스맥스', '한국콜마', '코스메카', '그린코스') (제조업자/OEM 검색).

## `efficacyKeyword` (type: `string`):

Filter by Korean efficacy text or English functional claim tag (e.g., '미백', '주름', '자외선', '탈모', 'SPF', 'whitening', 'anti-wrinkle', 'uv-protection', 'hair-loss') (효능·기능성 키워드).

## `itemCode` (type: `string`):

Optional exact MFDS item sequence (ITEM_SEQ) or cosmetic report sequence (COSMETIC_REPORT_SEQ) for instant single-item lookup (품목기준코드/보고일련번호).

## `sortOrder` (type: `string`):

Fetch newest 2026 filings first ('newest', recommended) or earliest historical filings first ('oldest') (정렬 순서).

## `resolveOemFromReviewed` (type: `boolean`):

For reported products with a linked base formula (ITEM_SEQ), automatically query the MFDS Reviewed API to reveal the underlying OEM/ODM manufacturer and base formula details.

## `maxItems` (type: `integer`):

Maximum number of cosmetic records to return (최대 반환 건수).

## `maxPagesToScan` (type: `integer`):

Maximum API pages (100 rows/page) to scan per dataset when applying client-side filters such as brand, OEM, or efficacy (페이지 스캔 상한).

## Actor input object example

```json
{
  "datasetType": "reported",
  "sortOrder": "newest",
  "resolveOemFromReviewed": true,
  "maxItems": 50,
  "maxPagesToScan": 30
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("maitreya_buddha/korea-mfds-functional-cosmetics-oem").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("maitreya_buddha/korea-mfds-functional-cosmetics-oem").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{}' |
apify call maitreya_buddha/korea-mfds-functional-cosmetics-oem --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,maitreya_buddha/korea-mfds-functional-cosmetics-oem"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/fW0wCXskMf6DoXMPe/builds/ddb0Da84SWI9dZMip/openapi.json
