# What E-Commerce and Marketplace Skills Are Included in K-Skill? > Discover the e-commerce and marketplace skills in NomaDamas/k-skill. Access Korean retail platforms like Market-Kurly, Naver Shopping, and Daangn with structured JSON product data. - Repository: [NomaDamas/k-skill](https://github.com/NomaDamas/k-skill) - Tags: getting-started - Published: 2026-08-03 --- **The NomaDamas/k-skill repository provides six production-ready e-commerce and marketplace skills—Market-Kurly Search, Naver Shopping Search, Olive Young Search, Ohou Today Deal, Daangn Used-Goods Search, and Bunjang Search—that expose Korean retail platforms through YAML-described CLI commands returning structured JSON product data.** The **k-skill** monorepo organizes automation capabilities into modular, self-contained units. Each e-commerce and marketplace skill follows a standardized architecture using YAML descriptors and native implementations to query popular Korean retail APIs or perform lightweight HTML scraping, all without requiring user credentials or API keys. ## Available E-Commerce and Marketplace Skills The repository categorizes retail capabilities into **retail** (e-commerce) and **marketplace** (C2C used goods) domains. Each skill resides in a dedicated top-level directory with a consistent file structure. ### Retail E-Commerce Skills **Market-Kurly Search** queries the Kurly fresh grocery catalog. The skill descriptor lives in [[`market-kurly-search/SKILL.md`](https://github.com/NomaDamas/k-skill/blob/main/market-kurly-search/SKILL.md)](https://github.com/NomaDamas/k-skill/blob/main/market-kurly-search/SKILL.md), while the Node.js implementation resides at [[`packages/market-kurly-search/src/index.js`](https://github.com/NomaDamas/k-skill/blob/main/packages/market-kurly-search/src/index.js)](https://github.com/NomaDamas/k-skill/blob/main/packages/market-kurly-search/src/index.js). Unit tests are available in [[`packages/market-kurly-search/test/index.test.js`](https://github.com/NomaDamas/k-skill/blob/main/packages/market-kurly-search/test/index.test.js)](https://github.com/NomaDamas/k-skill/blob/main/packages/market-kurly-search/test/index.test.js). **Naver Shopping Search** integrates with Naver's retail search engine. Configuration is defined in [[`naver-shopping-search/SKILL.md`](https://github.com/NomaDamas/k-skill/blob/main/naver-shopping-search/SKILL.md)](https://github.com/NomaDamas/k-skill/blob/main/naver-shopping-search/SKILL.md) and the implementation logic is documented in [[`naver-shopping-search/instruction.md`](https://github.com/NomaDamas/k-skill/blob/main/naver-shopping-search/instruction.md)](https://github.com/NomaDamas/k-skill/blob/main/naver-shopping-search/instruction.md). **Olive Young Search** targets the Olive Young beauty and health retailer. The skill uses [[`olive-young-search/SKILL.md`](https://github.com/NomaDamas/k-skill/blob/main/olive-young-search/SKILL.md)](https://github.com/NomaDamas/k-skill/blob/main/olive-young-search/SKILL.md) for its descriptor and [[`olive-young-search/instruction.md`](https://github.com/NomaDamas/k-skill/blob/main/olive-young-search/instruction.md)](https://github.com/NomaDamas/k-skill/blob/main/olive-young-search/instruction.md) for implementation details. **Ohou Today Deal** retrieves daily deals from the Ohou (Ohouse) interior shopping platform. Its metadata is stored in [[`ohou-today-deal/SKILL.md`](https://github.com/NomaDamas/k-skill/blob/main/ohou-today-deal/SKILL.md)](https://github.com/NomaDamas/k-skill/blob/main/ohou-today-deal/SKILL.md) with logic in [[`ohou-today-deal/instruction.md`](https://github.com/NomaDamas/k-skill/blob/main/ohou-today-deal/instruction.md)](https://github.com/NomaDamas/k-skill/blob/main/ohou-today-deal/instruction.md). ### Marketplace (C2C) Skills **Daangn Used-Goods Search** searches the Daangn neighborhood marketplace for secondhand items. The skill structure includes [[`daangn-used-goods-search/SKILL.md`](https://github.com/NomaDamas/k-skill/blob/main/daangn-used-goods-search/SKILL.md)](https://github.com/NomaDamas/k-skill/blob/main/daangn-used-goods-search/SKILL.md) and [[`daangn-used-goods-search/instruction.md`](https://github.com/NomaDamas/k-skill/blob/main/daangn-used-goods-search/instruction.md)](https://github.com/NomaDamas/k-skill/blob/main/daangn-used-goods-search/instruction.md). **Bunjang Search** queries the Bunjang second-hand goods platform. It follows the same pattern with [[`bunjang-search/SKILL.md`](https://github.com/NomaDamas/k-skill/blob/main/bunjang-search/SKILL.md)](https://github.com/NomaDamas/k-skill/blob/main/bunjang-search/SKILL.md) and [[`bunjang-search/instruction.md`](https://github.com/NomaDamas/k-skill/blob/main/bunjang-search/instruction.md)](https://github.com/NomaDamas/k-skill/blob/main/bunjang-search/instruction.md). ## How E-Commerce Skills Work Every skill follows a four-stage execution pattern defined in its YAML descriptor. **Input**: The CLI accepts parameters such as search keywords, product IDs, region filters, or pagination tokens. **Processing**: The implementation calls public REST endpoints (e.g., Kurly, Naver Shopping, Daangn) or performs lightweight HTML scraping directly from the user's machine. No credential-required proxy is used, as these skills bypass the **k-skill-proxy** layer entirely. **Output**: Each skill returns a JSON payload containing a list of items with standardized fields—`title`, `price`, `URL`, `thumbnail`—plus pagination metadata. **Safety**: Skills tagged with `retail` or `marketplace` trigger the runtime's "no-price-advice" guardrail, ensuring responses are never presented as financial or transactional advice. ## Running E-Commerce and Marketplace Skills The **k-skill-cli** framework automatically generates executable shims for each skill. You can invoke any e-commerce or marketplace skill using `npx` without global installation. Search Kurly's grocery catalog: ```bash npx -y @nomadamas/k-skill@0 market-kurly-search \ --keyword "organic milk" \ --limit 5 ``` Query Daangn's used-goods marketplace: ```bash npx -y @nomadamas/k-skill@0 daangn-used-goods-search \ --keyword "vintage camera" \ --region "Seoul" ``` Retrieve results from Bunjang: ```bash npx -y @nomadamas/k-skill@0 bunjang-search \ --keyword "desk lamp" \ --page 1 ``` Query Naver Shopping with price sorting: ```bash npx -y @nomadamas/k-skill@0 naver-shopping-search \ --query "wireless earbuds" \ --sort "price_asc" ``` Each command outputs a formatted JSON array suitable for piping into downstream tools or direct display. ## Skill Architecture and File Structure The k-skill monorepo enforces a strict layout to ensure consistency across all e-commerce and marketplace capabilities. **Descriptor ([`SKILL.md`](https://github.com/NomaDamas/k-skill/blob/main/SKILL.md))**: Declares the skill's name, category (`retail` or `marketplace`), inputs, outputs, and runtime profile. **Instruction File ([`instruction.md`](https://github.com/NomaDamas/k-skill/blob/main/instruction.md))**: Contains human-readable usage guides and links to the underlying implementation logic. For skills like `market-kurly-search`, this references the actual Node.js source code. **Implementation**: Either Python scripts or Node.js packages (e.g., [`packages/market-kurly-search/src/index.js`](https://github.com/NomaDamas/k-skill/blob/main/packages/market-kurly-search/src/index.js)) that perform data retrieval. **Tests**: Located under `tests/` folders (e.g., [`packages/market-kurly-search/test/index.test.js`](https://github.com/NomaDamas/k-skill/blob/main/packages/market-kurly-search/test/index.test.js)), exercising the public API of the skill. ## Summary - **Six skills** cover major Korean e-commerce and marketplace platforms: Market-Kurly, Naver Shopping, Olive Young, Ohou, Daangn, and Bunjang. - **Zero API keys** are required; skills query public endpoints or scrape HTML directly. - **Consistent structure**: Each skill uses a [`SKILL.md`](https://github.com/NomaDamas/k-skill/blob/main/SKILL.md) descriptor, [`instruction.md`](https://github.com/NomaDamas/k-skill/blob/main/instruction.md) guide, and dedicated implementation files. - **JSON output**: All skills return structured product data including title, price, URL, and thumbnail. - **Safety guardrails**: Retail and marketplace skills carry the "no-price-advice" tag to prevent misinterpretation as financial advice. ## Frequently Asked Questions ### Do k-skill e-commerce skills require API keys? No. According to the repository source code, these skills call public REST endpoints or perform lightweight HTML scraping directly from the user's machine. They bypass the **k-skill-proxy** layer, which is only required for free APIs that need credential management. ### What data format do k-skill marketplace skills return? All skills return a JSON payload containing a list of matching items. Each entry includes standard fields such as `title`, `price`, `URL`, and `thumbnail`, along with pagination metadata for result set navigation. ### How does k-skill handle price information safely? Skills in the `retail` or `marketplace` categories are tagged with a "no-price-advice" guardrail. As implemented in the runtime, this ensures the response is never presented as financial or transactional advice, maintaining compliance with platform policies. ### Can I run k-skill e-commerce queries without installing the CLI globally? Yes. The **k-skill-cli** framework supports execution via `npx -y @nomadamas/k-skill@0 `, allowing you to run any e-commerce or marketplace skill without global installation or local configuration.