# Korean Data MCP Hub (`upstanding_wax/korean-data-mcp-hub`) Actor 25 MCP tools exposing real-time Korean media trends to AI agents. Cluster-deduped news across K-Pop, K-Drama, K-Movie, K-Beauty, K-Food, K-Game, K-Tech, K-Stock, K-Travel, K-Webtoon, and K-Trends. Multilingual native output (EN/KO/JA/ES). Pre-classified with 90%+ accuracy. Pay-per-call from $0.005. - **URL**: https://apify.com/upstanding\_wax/korean-data-mcp-hub.md - **Developed by:** [teddy](https://apify.com/upstanding_wax) (community) - **Categories:** AI, MCP servers, Open source - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. Actors are written with capital "A". ## 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. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Korean Data MCP Hub **25 MCP tools for Korean media trends.** Cluster-deduped, multilingual JSON for AI agents. > Part of **Korean Data Hub** — the data layer for our two products on the same pipeline. The other product (K-Star Hub at `kstarhub.org`) eats the same dogfood: a daily digest service for human video creators. The MCP product gives AI agents the same pre-clustered, deduped stories the digest service has been delivering since November. ### What this Actor does This is an [MCP (Model Context Protocol)](https://modelcontextprotocol.io) server that exposes the [Korean Data MCP Hub](https://korean-data.com) API to AI clients like Claude Desktop, Cursor, and Continue. It speaks **stdio MCP** — when Claude Desktop launches the Actor, it can call any of 25 tools across 11 Korean content categories. ### Pricing model **Free Actor, paid backend.** Apify charges nothing for running this Actor itself; you use your **own Korean Data MCP Hub API key** (BYO) to pay per call ($0.005 each, $5 free signup credit, no card required). Get a key in 60 seconds: https://korean-data.com ### Categories covered | Category | What's in it | Tier | |----------|-------------|------| | K-Pop | Idol news, comebacks, charts | realtime | | K-Drama | Scripted TV/streaming series | realtime | | K-Movie | Korean cinema, film festivals | trend | | K-Beauty | Cosmetics, skincare, brands | trend | | K-Food | Korean cuisine, restaurants | trend | | K-Game | Gaming industry, esports | trend | | K-Tech | Korean tech, startups | trend | | K-Stock | KOSPI, entertainment company financials | trend | | K-Travel | Tourism, destinations | trend | | K-Webtoon | Webtoons, Naver/Kakao | trend | | K-Trends | General Korean cultural trends | trend | ### 25 tools - **K-Pop specialized (5)**: `get_kpop_news_today`, `get_artist_timeline`, `get_trending_clusters`, `search_news`, `generate_video_script` - **Category factory (20)**: `get__weekly_trend` + `search__archive` × 10 categories Each tool returns pre-clustered JSON (one row per real-world event, not per outlet) in EN / KO / JA / ES. ### Token efficiency Pre-clustering + LLM classification reduces input tokens **70-80%** vs raw HTML scraping. The same Korean news event written 8× by 8 outlets becomes 1 cluster lead in our response. ### Use in Claude Desktop ```json { "mcpServers": { "korean-data": { "command": "npx", "args": ["-y", "@apify/actor-cli", "run", "upstanding_wax/korean-data-mcp-hub"], "env": { "MCP_USER_API_KEY": "kdmcp_..." } } } } ```` Restart Claude Desktop. Ask: *"What's trending in K-pop this week?"* or *"Search Korean news for 'NewJeans Hanni'"*. ### Use directly (Apify Run UI / API) Provide your API key as Actor input: ```json { "api_key": "kdmcp_..." } ``` ### Resources - 📚 Tool docs: https://korean-data.com/docs - 🔑 Get an API key: https://korean-data.com ($5 free credit, no card) - 💸 Top up: https://korean-data.com/topup ($10 minimum, $0.005/call) - 📄 Refund policy: https://korean-data.com/refund - 🐛 Issues: https://github.com/teddyan35-create/kstar-mcp/issues ### Keywords korean, k-pop, k-drama, k-beauty, k-food, k-movie, k-game, k-tech, k-stock, k-travel, k-webtoon, mcp, model-context-protocol, claude, cursor, ai-agent, news, trends, multilingual, korean-data # Actor input Schema ## `api_key` (type: `string`): Your Korean Data MCP Hub API key. Sign up at https://korean-data.com ## Actor input object example ```json {} ``` # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("upstanding_wax/korean-data-mcp-hub").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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("upstanding_wax/korean-data-mcp-hub").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).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 upstanding_wax/korean-data-mcp-hub --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=upstanding_wax/korean-data-mcp-hub", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Korean Data MCP Hub", "description": "25 MCP tools exposing real-time Korean media trends to AI agents. Cluster-deduped news across K-Pop, K-Drama, K-Movie, K-Beauty, K-Food, K-Game, K-Tech, K-Stock, K-Travel, K-Webtoon, and K-Trends. Multilingual native output (EN/KO/JA/ES). Pre-classified with 90%+ accuracy. Pay-per-call from $0.005.", "version": "0.2", "x-build-id": "4p5OXzvJkk1ZRxrjA" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/upstanding_wax~korean-data-mcp-hub/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-upstanding_wax-korean-data-mcp-hub", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/upstanding_wax~korean-data-mcp-hub/runs": { "post": { "operationId": "runs-sync-upstanding_wax-korean-data-mcp-hub", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/upstanding_wax~korean-data-mcp-hub/run-sync": { "post": { "operationId": "run-sync-upstanding_wax-korean-data-mcp-hub", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "api_key" ], "properties": { "api_key": { "title": "API Key", "type": "string", "description": "Your Korean Data MCP Hub API key. Sign up at https://korean-data.com" } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```